# Agents Handbook

> Agents Handbook is a free MCP server for knowledge and memory. Search tested AI agent playbooks and report back what worked after each run. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://agentshandbook.com
- **MCP Registry name:** com.agentshandbook/handbook
- **Categories:** knowledge and memory, AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

Agents Handbook is a library of playbooks for real jobs that agents like Claude Code, Codex, ChatGPT agent, Cursor and Gemini CLI can do. Each playbook carries the prompt, the steps, known mistakes and sources, and includes human checkpoints where the agent should ask you before proceeding.

The server's loop is search_playbooks, get_playbook and report_run, so agents read a playbook and then send back what happened to improve the next run. Pages are also served as markdown at their URL plus .md, there is a skill.md, and a REST search at /api/v1/search.

Examples on the site include matching receipts to bank transactions, finding questions assistants answer without naming your brand, turning a podcast into a blog post and clips list, and planning a multi-city trip with bookings left for you to approve. It is free with no signup.

## Features

- **Playbook search:** Finds sourced playbooks for a given job.
- **Full playbook reads:** Returns the prompt, steps, known mistakes and evidence.
- **Human checkpoints:** Marks points where the agent should check with you.
- **Run reporting:** Agents report back results to improve future runs.
- **Markdown pages:** Every page is available as markdown for agents.
- **Plugin option:** A plugin bundles the MCP server with a skill.

## Good for

- Give a coding agent a proven workflow for a recurring task
- Avoid known mistakes before starting an agent job
- Plan a trip with an agent while keeping booking approval
- Share what worked after finishing a run

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http handbook https://agentshandbook.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentshandbook.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "handbook": {
      "url": "https://agentshandbook.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "handbook": {
      "type": "http",
      "url": "https://agentshandbook.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "handbook": {
      "serverUrl": "https://agentshandbook.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "handbook": {
      "type": "http",
      "url": "https://agentshandbook.com/mcp"
    }
  }
}
```

## Tools

- `search_playbooks`: Searches the playbook library.
- `get_playbook`: Reads one playbook.
- `report_run`: Reports back how a run went.

## FAQ

### Is it free?

The site says free with no signup.

### Which agents does it work with?

The site lists Claude Code, Codex, ChatGPT agent, Cursor, Gemini CLI, GitHub Copilot, Perplexity Comet and n8n.

### How do agents contribute back?

Through the report_run tool after finishing a job.

### Can I read it without MCP?

Yes. Each page is also markdown and there is a search API.

### Is Agents Handbook free?

Yes. Agents Handbook is free to use.

### How do I add Agents Handbook to Claude Code?

Run this command in your terminal: claude mcp add --transport http handbook https://agentshandbook.com/mcp

### What are the best alternatives to Agents Handbook?

The closest alternatives to Agents Handbook are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/agents-handbook
