Doc Review — MCP

Review docs for clarity, broken promises, and missing prerequisites before publish. (MCP-oriented tool + prompt pack (read-only first).)

Id: mcp/doc-review · Slug: doc-review · Status: Untested · Untested on this machine — recipe reviewed for safety (no secrets, no destructive commands, no auto-spend). Mark tested after you run it locally.

What is this

MCP for MCP. Review docs for clarity, broken promises, and missing prerequisites before publish. (MCP-oriented tool + prompt pack (read-only first).)

How this runtime fits

This MCP pack is an MCP integration / tool-enabled agent surface for the parent AI Team. Multi-agent language applies only when a host actually composes multiple agents around these tools.

Parent AI Team: doc-review · What is an AI Team?

What it does

Review docs for clarity, broken promises, and missing prerequisites before publish. (MCP-oriented tool + prompt pack (read-only first).)

Who for

Builders working on Documentation jobs who can run MCP themselves.

Need to run

You will run this locally or on infra you control.
No production credentials in prompts or committed files.
MCP-aware client
Ability to allowlist tools

How to use

Review server_hints.md and implement only allowlisted read-only tools.
Load prompt.md as the client system prompt.
Run one Example in query with tools off; then enable library_search only.
Confirm path allowlist before any file read tool.

Limitations

Not a substitute for professional legal, medical, or investment advice.
Outputs can be wrong; human review required before publish or spend.
Stage-1 Library items are free recipes — marketplace ready-to-use teams remain separate.
Local models may omit sections; re-prompt once if needed.

Test status

Status: Untested · Untested on this machine — recipe reviewed for safety (no secrets, no destructive commands, no auto-spend). Mark tested after you run it locally.

Files

server_hints.md — MCP server/tool design notes
prompt.md — Client system prompt when tools are available

Full prompt / config / code

# MCP pack — Doc Review

## prompt.md (client)
You are a documentation reviewer. Goal: ship-ready clarity check.

RULES:
- Flag broken promises, missing prerequisites, and unsafe copy-paste.
- Do not invent product features.
- Prefer concrete edits over vague “improve clarity”.

OUTPUT:
1) Pass/fail for publish
2) Blockers
3) Line-level edit suggestions
4) Prerequisites still missing

## server_hints.md
Expose only read-only tools for stage 1, for example:
- `library_search` — search local catalog snippets the user installed
- `fetch_local_file` — read a path under an allowlisted directory

Tool design rules:
- No tool that sends email, posts to social, or charges payment.
- No tool that reads `~/.ssh`, `.env`, or browser cookie DBs.
- Arguments must be schema-validated; reject path traversal.
- Log tool calls for the human operator.

Example tool schema (illustrative JSON):
```json
{
  "name": "library_search",
  "description": "Search local BotShelf library snippets",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {"type": "string", "minLength": 1, "maxLength": 200}
    },
    "required": ["query"]
  }
}
```

Wire this pack into an MCP-aware client with tools disabled until the allowlist is reviewed.

Example in

Doc draft:
# Fork a team
1. Click Fork
2. Edit
3. We auto-publish to production
Prereq: none

Example out

Publish: fail
Blockers: step 3 claims auto-publish — unsafe/untrue for this shelf
Edits: replace with review queue language; add register prereq if required
Missing: what Fork does not do

Model / runtime notes

Protocol-level pack. Prefer read-only tools. Never ship credentials inside MCP configs.

Canonical Team

Parent: doc-review · implementation_id: mcp/doc-review

GitHub source

teams/doc-review/mcp · commit eb87e8e049fdf9908e438305ff827c7b617505b5 · license: free-use-at-own-risk

Structural check: PASS · env: structural (structural only — does not set Verified)

Related Library items

Related marketplace Team pages

Soft thematic links only — not identity merges. Marketplace Teams ≠ Library AI Team records.

Doc Draft Gate (marketplace Team page — separate entity)
Claude Docs (marketplace Team page — separate entity)