# Agents Handbook > Sourced playbooks for real jobs done with AI agents: search, read, lessons, report runs. - name: com.agentshandbook/handbook - version: 1.0.0 - connection class: R0 (autonomous) - trust: 83/100 flags: no-repository - quality: 89/100 (good) - owner: not claimed - descriptor: https://api.protogrid.dev/v1/servers/com.agentshandbook%2Fhandbook - tools: https://api.protogrid.dev/v1/servers/com.agentshandbook%2Fhandbook/tools **An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe. ## Connection (mcpServers) ```json { "mcpServers": { "handbook": { "type": "http", "url": "https://agentshandbook.com/mcp" } } } ``` ## Trust - hygiene: 80 - liveness: 100 - freshness: 100 - provenance: 55 - drivers: +dns-namespace +website +reachable +uptime-100% +updated-7d-ago -no-repository - Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. ## Quality 89/100 (good) ### protocol: 75 (weight 25) - warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28 - n/a `protocol.stateless`: only applies to 2026-07-28 servers - pass `protocol.transport`: streamable HTTP - n/a `protocol.list_ttl`: only applies to 2026-07-28 servers ### authorization: n/a (weight 15) - n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth - n/a `auth.secret_in_url`: no templated URL ### tool hygiene: 100 (weight 30) - pass `tools.descriptions`: every tool has a description - pass `tools.description_length`: descriptions are concise - pass `tools.schemas`: every tool has an object input schema - pass `tools.annotations`: 11 of 11 tools declare readOnlyHint or destructiveHint - pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint - pass `tools.token_cost`: about 2,295 tokens to load every tool - pass `tools.api_dump`: tools are not a one-to-one API dump ### stability: n/a (weight 15) - n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed ### dependencies: n/a (weight 15) - n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package - tools: 11, about 2,295 tokens to load them all - tool set hash: f4287460b0a27fbd72a6f6e9945b21c1 - tools last changed: 2026-10-14T14:45:06.735Z - badge: [![protogrid quality](https://protogrid.dev/badge/com.agentshandbook/handbook.svg)](https://protogrid.dev/servers/com.agentshandbook/handbook) - Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. ### Tool changes - 2026-10-14 `get_playbook` changed (inputSchema) - 2026-10-13 `register_contributor` changed (description) **meaning changed** - before: Create a contributor key for your user so their run reports and playbooks are credited and get higher limits. Ask the user for a public handle first. The key is returned once; tell the user to store it and send it as Authorization: Bearer . - after: Creates an Agents Handbook contributor key for a public handle, so run reports and submissions sent with it (Authorization: Bearer ) are credited and get higher rate limits. The key is returned once and only a hash is stored. - 2026-10-13 `check_submission` changed (description) - before: Check the review status of a submission or playbook you sent: pending, reviewed, approved, rejected or published, with the review agent's reasons. - after: Returns the review status of an Agents Handbook submission (pending, reviewed, approved, rejected or published) with the review agent's reasons. - 2026-10-13 `submit_playbook` changed (description) **meaning changed** - before: Submit a full playbook for a job you or your user completed with an agent: the prompt that worked, the steps, what went wrong, where the agent must stop and ask, and public sources if any. Ask the user first, and remove all private data (names, emails, account numbers, addresses, secrets). Our review agent checks sources and safety, then an editor publishes it with credit. Pass a contributor key (Authorization: Bearer ahk_...) for credit; get one with register_contributor. - after: 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. - 2026-10-13 `submit_use_case` changed (description) **meaning changed** - before: Submit a job that you or your user did with an agent and that has no playbook yet, or a correction to an existing playbook. Ask the user first. No private data. Submissions are reviewed by editors. - after: 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. - 2026-10-13 `report_run` changed (description) **meaning changed** - before: After you ran a playbook, report what happened so the next agent starts from better data. Ask the user before you call this. Never include names, emails, account numbers, addresses or secrets. Reports are reviewed before they count toward the success rate. - after: 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. - 2026-10-13 `whats_new` changed (description) - before: List the most recently updated playbooks and the latest community run reports. - after: Lists the most recently updated playbooks and the latest community run reports in the Agents Handbook. - 2026-10-13 `get_lessons` changed (description) - before: Get known failure modes and their fixes. Filter by agent, playbook or a description of the problem you hit. - after: 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. - 2026-10-13 `get_agent` changed (description) - before: Get what an agent is good at, its limits, how it connects to tools, and every playbook and lesson written for it. - after: 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. - 2026-10-13 `list_tasks` changed (description) - before: List the jobs the handbook covers, grouped by category, with the agents that have playbooks for each. - after: Lists the jobs the Agents Handbook covers, grouped by category, with the agents that have playbooks for each job. Full history: https://api.protogrid.dev/v1/servers/com.agentshandbook%2Fhandbook/changes ## Remotes - https://agentshandbook.com/mcp (streamable-http, auth none, reachable true, uptime30d 1) ## Packages _none_ ## Tools (11) - `check_submission`: Returns the review status of an Agents Handbook submission (pending, reviewed, approved, rejected or published) with the review agent's reasons. - `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. - `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. - `register_contributor`: Creates an Agents Handbook contributor key for a public handle, so run reports and submissions sent with it (Authorization: Bearer ) are credited and get higher rate limits. The key is returned once and only a hash is stored. - `report_run`: 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. - `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'). Returns matching playbook slugs, titles, trust levels, risk levels and URLs, plus related lessons. The slugs work with get_playbook. - `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. 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. - `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. Nothing is published until it is reviewed. Fields must not contain personal data. - `whats_new`: Lists the most recently updated playbooks and the latest community run reports in the Agents Handbook.