MCP setup

One command (recommended)

ak-docs mcp install --cursor    # writes .cursor/mcp.json in repo root
ak-docs mcp install --claude    # merges into Claude Desktop config (macOS)

Then add the agent skill: skills/doc-bridge.md

{
  "mcpServers": {
    "ak-docs": {
      "command": "npx",
      "args": ["ak-docs", "mcp"],
      "cwd": "/absolute/path/to/your/repo"
    }
  }
}

Or with a global/local bin:

{
  "mcpServers": {
    "ak-docs": {
      "command": "ak-docs",
      "args": ["mcp"]
    }
  }
}

Run from the repo root (or pass config discovery that resolves to it). Always ak-docs index after doc changes (or gate in CI).

Tool	Purpose
`handoff.resolve`	Package/ownership → AgentHandoff
`doc.search`	Deterministic index search
`doc.get`	Read an indexed agent doc
`gate.status`	Freshness / configured gates
`retriever.query`	Local retriever chunks
`memory.classify` / `memory.promoteDraft`	Memory pipeline

Before editing a package: