July 5, 2026 · 7 min read
Three categories of AI documentation tooling have emerged in the last 18 months: hosted chat widgets (Kapa, Mendable), AI-enhanced doc platforms (GitBook AI, Mintlify), and MCP-native indexed RAG (AgentReady). They look similar in demos but serve fundamentally different use cases. Picking the wrong one means paying for a feature set that doesn't match where your users actually are.
This breakdown focuses on the one question that matters most in 2026: who is consuming your documentation — humans, AI agents, or both?
Before comparing, it helps to understand what each category actually is:
Kapa solves a specific problem well: your developers want to ask questions about your docs without reading through pages manually, and you want to give them a chat box that's more accurate than a generic search bar. Kapa indexes your content, fine-tunes retrieval for documentation, and gives you a widget you can embed in minutes.
What Kapa is not is an agent-facing API. There's no MCP endpoint. Claude Desktop can't call Kapa as a tool. Cursor can't query it from a composer window. The only consumer Kapa supports is a human typing into a chat widget on your docs site. That's a reasonable product decision — chat widgets are a real user need — but it means Kapa and agent tooling are solving orthogonal problems.
Choose Kapa when: your primary audience is human developers browsing your docs site who want chat-style Q&A, and you don't care (yet) about agent access.
GitBook AI is less of a standalone product and more of a platform upgrade. If your team authors documentation in GitBook, the AI features are a natural add-on: AI-generated doc summaries, semantic search across your content, and inline Q&A as you write.
The constraint is obvious: GitBook AI only works on content authored in GitBook. If your docs are on a custom site, Docusaurus, Readme.io, or a self-hosted static site, GitBook AI isn't available to you. You'd have to migrate your entire documentation workflow to unlock it.
GitBook has added an MCP server for Cursor integration, but it's currently read-focused — helping developers query GitBook-hosted docs from Cursor, not a general-purpose agent API for any arbitrary site. It's valuable if you're already in the GitBook ecosystem; it's not a reason to migrate if you aren't.
Choose GitBook when: your team already uses GitBook to author docs, you want AI features for your internal writers and readers, and you're not trying to serve agent consumers beyond Cursor.
AgentReady is built for a different access pattern: your documentation consumer is an AI agent — Claude, Cursor, a GPT-based assistant, an autonomous workflow — and it needs to query your content reliably via a structured API call, not a browser fetch.
The indexing is platform-agnostic. AgentReady crawls any URL: static sites, Docusaurus, React SPAs, GitBook-hosted docs, custom doc engines. JS-rendered pages that return empty on a direct fetch are handled via headless rendering fallback. Once indexed, any MCP client can call ask_site and get a cited answer drawn from your actual content, not a hallucinated summary from training data.
The tradeoff: there's no human-facing chat widget. AgentReady doesn't compete with Kapa for the "put a chat box on my docs" use case. It competes with web_fetch — the default tool an agent falls back to when it needs to read a page — and wins on reliability, multi-page synthesis, and hallucination rate for agent-consumed documentation queries.
Choose AgentReady when: AI agents need to reliably query your docs at runtime, your site has JS-rendering issues, or you want citations and grounded answers rather than LLM inference from a single fetched page.
The clearest way to choose:
These use cases can coexist. A developer-tools company might run Kapa for the human chat widget on their docs site while also indexing the same content on AgentReady for Claude Desktop and Cursor users. They're not mutually exclusive — they address different access surfaces.
The category that's growing fastest is agent-facing APIs. MCP has become the de facto standard for agent tool access, and developers are spending more time in AI assistants than in browser-based docs. The relevant benchmark is no longer "does my docs site have good SEO" — it's "when a developer asks Claude about my API, does it get the answer right."
Kapa and GitBook are investing in this direction too. Kapa has announced MCP support on its roadmap. GitBook's Cursor integration is an early signal. But their primary surface remains the human chat widget and the authoring platform respectively. The MCP-native layer is where products built specifically for agent access, like AgentReady, operate by default rather than as an add-on.
The practical takeaway: if you care about what happens when a developer asks Claude about your API — not a human on your docs site, but an AI assistant the developer is talking to — agent-facing RAG is the part of this stack worth investing in first.
Index your docs and make them reliably queryable by AI agents — any site, any platform.
Index your docs on AgentReady →