Agent Docs

Agent Docs

An MCP server that gives AI agents the current official documentation of Claude Code, Cursor, Codex and MCP.

These tools change faster than a model's training data. Agent Docs keeps about 600 pages of their official docs in a search index, refreshes it every day, and gives your agent two tools: one finds the right passage, the other reads a whole section. The agent answers from the real docs and can link to them.

It runs as a remote MCP server (and over REST). You can try it with a free Cohere key.

[Step through it at your own pace](https://konstantinstarovoytov.github.io/agent-docs/) (arrow keys work), or open the stills:

The 15 steps as still images

Source and how to rebuild: docs/flow/

How it was built and what was measured: ARCHITECTURE.md.

Connect

Add the server to any MCP client (Claude Code, Cursor, OpenWebUI and others):

{

"mcpServers": { "agent-docs": { "url": "https://agent-docs-mcp.onrender.com/mcp/", "headers": { "X-Cohere-Api-Key": " " } } } }

Calling a tool needs one of two headers:

• Your own Cohere key: X-Cohere-Api-Key: . A free trial key is at dashboard.cohere.com. The key pays for reranking that one request; it is never stored or logged. Limit: 30 requests a minute per IP.
• A token from the owner: Authorization: Bearer . For a guest token, open an issue titled "Guest token request".

The server is on a free plan: after 15 idle minutes, the first request takes about a minute.

Over REST:

curl -X POST https://agent-docs-mcp.onrender.com/ask \

-H "Authorization: Bearer $API_TOKEN" -H 'content-type: application/json' \ -d '{"question": "How do I add an MCP server in Claude Code?"}'

With your own key, replace the Authorization line with -H "X-Cohere-Api-Key: $COHERE_API_KEY".

Locally, without a server (stdio, no token):

{ "mcpServers": { "agent-docs": { "command": "uv",

"args": ["run", "--directory", "/path/to/agent-docs", "rag-mcp"] } } }

For MCP directories: connecting and listing the tools need no key (30 requests a minute per IP); only tools/call does. The server keeps no session, so GET /mcp answers 405; send everything with POST. Listed in the official MCP Registry as io.github.KonstantinStarovoytov/agent-docs (server.json).

What it covers

How it works

Your agent calls search_docs, then read_section when a passage is not enough. No language model runs on the server for this: the agent reads the passages and writes the answer itself.

search_docs works in four steps:

1. It searches by meaning (embeddings) and by exact words (BM25) at the same time, so both "connect a tool server" and claude mcp add find the right page.
2. It merges the two result lists by rank. Ties are kept in a fixed order, so the same question always gets the same results.
3. A reranker (Cohere) reads the top 20 together with the question and scores how well each one matches.
4. It keeps the best passage of each page and adds the page's one-line description and the headings of its other matching sections.

read_section reads from a stored copy of the page; no model is called. Searches are traced in Langfuse.

The REST endpoint /ask is for clients that are not agents. It also translates Russian and Polish questions into English, says "the documentation does not cover this" when even the best candidate scores below 0.55, picks 8 chunks (at most 2 from one section), and has gpt-6-luna write an answer that cites them.

Updated every day

[Step through it at your own pace](https://konstantinstarovoytov.github.io/agent-docs/?flow=reindex), or open the stills:

The 12 steps as still images

Every day at 06:00 UTC a GitHub Actions job reads each vendor's list of pages (llms.txt) and updates the index:

• Changed pages are embedded again; unchanged ones are skipped.
• New pages are checked first. A suspicious one waits in a GitHub issue until the owner ticks Index or Decline.
• Pages that disappear from the list are deleted, unless too many disappear at once.
• A short report of what changed in the products goes to reports/docs-changes/.

Measured results

Each change was measured on labelled que