Document the reshaped MCP tool surface (docs audit)

[selfcontained]

Nightly docs audit. Diff-driven slice over 8eabcbe1..a6ec304e (#941, #943, #944, #945, #946, #947); the Repo Tools deep-dive in next_focus is carried to the next run.

What drifted

#945 removed get_agent_history and get_parent_context from every doc surface in the same commit that introduced dispatch_review_get_feedback, brain_get_event, brain_get_list_item and whiteboard_howto — so the tool lists looked freshly maintained while being short by five entries. #946 then changed how pins are addressed, and #941 changed what a templateId does on dispatch_launch_agent.

Changed

• docs-sections/tools.tsx — the five new tools; dispatch_pin update-by-id (a rename is now a single-field edit); new dispatch_pins batch bullet (merge vs. group-scoped replace); dispatch_delete_pin by id / ids / group; dispatch_list_pins truncation + read-one-by-id. New closing paragraph stating the list/detail policy shared/mcp/response.ts now encodes, so an agent hitting a truncated listing knows there is a matching full read.
• dispatch_launch_agent — with a templateId the template's own prompt is now rendered and its placeholders fill from templateArgs (Render the template's prompt when launching an agent via MCP #941). Previously the id was used only for worktree settings, and the bullet still read "or template".
• docs-sections/media.tsx — Pins tab: groups render under a collapsible heading with a member count, groups over eight start collapsed, and the choice persists per agent and group (Add batch pin writes, update-by-id, bulk delete, and collapsible groups #946).
• docs-sections/automations.tsx — job-agent tool lists: the new tools, plus persona_templates / persona_upsert / persona_validate and dispatch_archive_agent, which are in JOB_TOOLS but were never enumerated there.
• README.md — five rows in the interactive-agents table; dispatch_pins + dispatch_review_get_feedback in the persona-agents list; corrected dispatch_list_pins / dispatch_delete_pin / dispatch_review_list_feedback descriptions.

Verified against AGENT_TOOLS / JOB_TOOLS / REVIEW_AGENT_TOOLS in apps/server/src/shared/mcp/server.ts as sets, both directions.

Not changed

• No new ambient tip: the collapsible-group behaviour sits under the existing shortcut-pins tip's ground (media#media-sidebar), and the rest of this diff is agent-facing API.
• docs/03-api-spec.md — routes/mcp.ts changes were dependency wiring only; no HTTP contract moved.

Deferred

• docs-sections/personas.tsx names reviewer tools individually and hasn't picked up dispatch_pins / dispatch_review_get_feedback — nothing there is wrong today (backlogged).
• api-spec has no coverage of the agent pins HTTP routes at all (backlogged).
• Next run: the Repo Tools deep-dive, now also checking whether any docs claim describes the pre-Trim MCP tool responses to what a calling agent needs #945 doubled repo-tool result payload.

🤖 Generated with Claude Code