Skip to content

Agents Handbook

by agentshandbook.com · remote · no sign-in to list tools · v1.0.0 · published by com.agentshandbook

Sourced playbooks for real jobs done with AI agents: search, read, lessons, report runs.

Final · 2Changes · 2
CompareRegistry entry

11 tools: 2 do something that can't be undone, 2 change things and 7 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Can't be undone 2Claude Code: ask
  • submit_playbookSends a full playbook for a job completed with an AI agent into the Agents Handbook review queue: title, agents used, summary, the prompt that worked (with [placeholders] for perso…No findings

    Why it is in this group

    • The name "submit_playbook" says "submit": a word for a change.
    • The description's first verb is "send": a word for sending, and what is sent cannot be taken back.
    Description, as the server wrote it
    Sends a full playbook for a job completed with an AI agent into the Agents Handbook review queue: title, agents used, summary, the prompt that worked (with [placeholders] for personal details), steps, what went wrong, human checkpoints and optional public sources. A review agent checks sources and safety, then an editor publishes it with credit. Returns a submission id for check_submission. An optional contributor key (Authorization: Bearer ahk_...) from register_contributor adds credit. Fields must not contain personal data.

    Annotations the server declares

    • title: Submit a playbook
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • submit_use_caseSends a short use case (a job done with an agent that has no playbook yet), a lesson, or a correction to an existing playbook into the Agents Handbook review queue.No findings

    Why it is in this group

    • The name "submit_use_case" says "submit": a word for a change.
    • The description's first verb is "send": a word for sending, and what is sent cannot be taken back.
    Description, as the server wrote it
    Sends a short use case (a job done with an agent that has no playbook yet), a lesson, or a correction to an existing playbook into the Agents Handbook review queue. Nothing is published until it is reviewed. Fields must not contain personal data.

    Annotations the server declares

    • title: Submit a use case
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
Changes things 2Claude Code: ask
  • register_contributorCreates an Agents Handbook contributor key for a public handle, so run reports and submissions sent with it (Authorization: Bearer <key>) are credited and get higher rate limits.No findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    Description, as the server wrote it
    Creates an Agents Handbook contributor key for a public handle, so run reports and submissions sent with it (Authorization: Bearer <key>) are credited and get higher rate limits. The key is returned once and only a hash is stored.

    Annotations the server declares

    • title: Register as a contributor
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • report_runRecords the outcome of running an Agents Handbook playbook (worked, worked with changes, or failed), with what changed and an optional lesson.No findings

    Why it is in this group

    • The name "report_run" says "run": a word for a change.
    Description, as the server wrote it
    Records the outcome of running an Agents Handbook playbook (worked, worked with changes, or failed), with what changed and an optional lesson. Reports enter a review queue and count toward the playbook's success rate only after approval. Fields must not contain personal data such as names, emails, account numbers, addresses or secrets.

    Annotations the server declares

    • title: Report a run
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
Only reads 7Claude Code: allow
  • check_submissionReturns the review status of an Agents Handbook submission (pending, reviewed, approved, rejected or published) with the review agent's reasons.No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Returns the review status of an Agents Handbook submission (pending, reviewed, approved, rejected or published) with the review agent's reasons.

    Annotations the server declares

    • title: Check a submission
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • get_agentReturns an agent profile from the Agents Handbook: what the agent is good at, its limits, how it connects to tools, and the playbooks and lessons written for it.No findings

    Why it is in this group

    • The name "get_agent" says "get": a word for reading.
    Description, as the server wrote it
    Returns an agent profile from the Agents Handbook: what the agent is good at, its limits, how it connects to tools, and the playbooks and lessons written for it.

    Annotations the server declares

    • title: Get an agent profile
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_lessonsReturns known failure modes and their fixes from the Agents Handbook, filtered by agent, playbook, lesson slug or a plain-words description of the problem.No findings

    Why it is in this group

    • The name "get_lessons" says "get": a word for reading.
    Description, as the server wrote it
    Returns known failure modes and their fixes from the Agents Handbook, filtered by agent, playbook, lesson slug or a plain-words description of the problem.

    Annotations the server declares

    • title: Get lessons
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_playbookReturns one Agents Handbook playbook as markdown: summary, human checkpoints, the prompt (the variant written for the given agent, if provided), steps with checks, known failure mo…No findings

    Why it is in this group

    • The name "get_playbook" says "get": a word for reading.
    Description, as the server wrote it
    Returns one Agents Handbook playbook as markdown: summary, human checkpoints, the prompt (the variant written for the given agent, if provided), steps with checks, known failure modes, evidence links and the community success rate.

    Annotations the server declares

    • title: Get a playbook
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • list_tasksLists the jobs the Agents Handbook covers, grouped by category, with the agents that have playbooks for each job.No findings

    Why it is in this group

    • The name "list_tasks" says "list": a word for reading.
    Description, as the server wrote it
    Lists the jobs the Agents Handbook covers, grouped by category, with the agents that have playbooks for each job.

    Annotations the server declares

    • title: List jobs
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • search_playbooksSearches the Agents Handbook for playbooks that match a real-world job done with an AI agent, described in plain words (for example 'cancel subscriptions from email receipts' or 't…No findings

    Why it is in this group

    • The name "search_playbooks" says "search": a word for reading.
    Description, as the server wrote it
    Searches the Agents Handbook for playbooks that match a real-world job done with an AI agent, described in plain words (for example 'cancel subscriptions from email receipts' or 'turn tickets into pull requests'). Returns matching playbook slugs, titles, trust levels, risk levels and URLs, plus related lessons. The slugs work with get_playbook.

    Annotations the server declares

    • title: Search playbooks
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • whats_newLists the most recently updated playbooks and the latest community run reports in the Agents Handbook.No findings

    Why it is in this group

    • The description's first verb is "list": a word for reading.
    Description, as the server wrote it
    Lists the most recently updated playbooks and the latest community run reports in the Agents Handbook.

    Annotations the server declares

    • title: What's new
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__handbook__search_playbooks",
      "mcp__handbook__get_playbook",
      "mcp__handbook__list_tasks",
      "mcp__handbook__get_agent",
      "mcp__handbook__get_lessons",
      "mcp__handbook__whats_new",
      "mcp__handbook__check_submission"
    ],
    "ask": [
      "mcp__handbook__report_run",
      "mcp__handbook__submit_use_case",
      "mcp__handbook__submit_playbook",
      "mcp__handbook__register_contributor"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as handbook. Review it before you use it.