INDIVIDUAL MCP TOOL
search_playbooks
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').
LIVE ENDPOINT
https://agentshandbook.com/mcp
Connect to this endpoint to inspect the live schema for search_playbooks and invoke it with your own arguments.
Indexed input schema
{}Risk classification
Potential side effects detected · medium confidence · heuristic, not a guarantee.
- A tool name or description suggests sending messages.
Parent server
CONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.agentshandbook]
url = "https://agentshandbook.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"agentshandbook": {
"type": "http",
"url": "https://agentshandbook.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: agentshandbook
Remote MCP URL: https://agentshandbook.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"agentshandbook": {
"url": "https://agentshandbook.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"agentshandbook": {
"type": "http",
"url": "https://agentshandbook.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "agentshandbook",
"transport": "streamable-http",
"url": "https://agentshandbook.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
Related tools
get_playbook— 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.list_tasks— Lists the jobs the Agents Handbook covers, grouped by category, with the agents that have playbooks for each job.get_agent— 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.get_lessons— 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.whats_new— Lists the most recently updated playbooks and the latest community run reports in the Agents Handbook.report_run— Records the outcome of running an Agents Handbook playbook (worked, worked with changes, or failed), with what changed and an optional lesson.submit_use_case— 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.submit_playbook— 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.