Skip to content
MCP server

Agents Handbook

Search tested AI agent playbooks and report back what worked after each run

Install
Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About Agents Handbook

Agents Handbook is a free MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://agentshandbook.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "handbook": {
      "url": "https://agentshandbook.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Free, no signup

Prices change. Check agentshandbook.com before you buy.

Agents Handbook 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 to Agents Handbook

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity