Saltar al contenido principal

Reader MCP

Pro

The reader MCP is the URL you give your developers so their AI tools (Claude Code, Cursor, etc.) can directly read your docs. Public, read-only, free for them to use.

Where to find your URL

Project settings → MCP → Reader MCP. The URL looks like:

https://docsio.co/api/mcp/<your-project-id>

Public — no auth required. Anyone with the URL can connect to it. Disable in the same settings panel if you ever want to revoke it.

What it exposes

Three tools your users' AI tools can call:

ToolWhat it does
search_docs(query)Full-text search across every page. Returns matching paths and snippets.
get_page(slug)Full markdown content of a page by its slug.
list_pages(category?)List of all pages, optionally filtered by category.

That's it. No mutations, no sensitive data, no internal state. Just docs.

How to share it with your users

Most teams put a callout in their docs:

Use Acme docs in your AI tool. Connect this MCP server to Claude Code, Cursor, Codex, or any MCP-capable agent.

{
  "url": "https://docsio.co/api/mcp/<your-project-id>"
}

You can also link to setup instructions for each major client. Docsio's settings page has copy-pasteable snippets for Claude Code, Cursor, VS Code, Codex, and Antigravity. Copy those snippets into your own docs page so your users have a one-click setup.

Disabling

Project settings → MCP → Reader MCP → toggle off. Active connections continue to work for ~5 minutes (until their session times out), then the URL returns 404.

If you re-enable later, the same URL works again — the project ID doesn't change.

When to disable

  • You want docs to be Pro-gated only (hide the MCP option from free-tier-style customers).
  • You're moving docs to a different system and don't want stale data served via MCP.
  • Test/staging projects you don't want crawled by AI tools.

For most projects, leave it on. It's a high-leverage feature your developer customers love.

Index freshness

The reader MCP serves whatever the latest published version of your docs is. Edits in the editor that haven't been published don't appear in the MCP yet. Publish to update.

Pro-only

Currently, reader MCP is Pro-only. Free projects don't expose the URL.

Pricing for your users

Free for your users. They aren't charged anything. They use their own AI tool's billing (e.g. Claude Code's monthly subscription) — the MCP itself is free for them to call.

Common patterns

  • Make it discoverable. Add a "Use these docs in your AI tool" page or link to your setup instructions.
  • Update your README. If your repo has a README, mention the reader MCP URL with a one-line example.
  • Tweet it on launch. "Docs are now available as an MCP server — point Claude Code at ." Solid traction post.
  • Author MCP — the same MCP idea but for you, with write + publish tools.
  • Setup snippets — copy-pasteable configs for every major MCP client.