# Connect the Mintlify MCP server to Unblocked to give AI agents live documentation site context URL: https://getunblocked.com/integrations/mintlify/ Unblocked connects to Mintlify’s MCP server so AI coding agents can query your documentation pages, navigation, comments, and docs analytics live — then its Context Engine reconciles what they find with the code, pull requests, and conversations behind it. --- ## Mintlify integration details - **Category:** Documentation - **Live-queried data:** docs pages, comments, docs analytics - **Supported products:** Mintlify - **Works with:** Claude Code, Cursor, Devin, GitHub Copilot, Codex, OpenCode, VS Code — via one MCP server connection - **Maintained by:** Mintlify · verified by Unblocked - **Content reviewed:** October 20, 2026 - **Website:** ## What the Mintlify integration adds Product documentation drifts from the code it describes: an endpoint changes in a pull request, and the Mintlify page explaining it stays the same until someone notices. Mintlify’s MCP server exposes your documentation project — page content, navigation, comments, and analytics — to AI agents, and Unblocked connects to it once so every agent can check what your docs say without its own Mintlify setup. This is a third-party MCP server: Mintlify hosts and maintains it, and Unblocked connects to it as a verified MCP server. Nothing is ingested or indexed — Unblocked calls the read-only tools you select at the moment a question needs them, so answers reflect your documentation as it is now, on the branch you ask about. Wiring Mintlify’s MCP server straight into an agent gives it raw pages and search hits. Unblocked’s Context Engine reasons across those results and your other sources — following a documented parameter to the pull request that renamed it, the Slack thread that agreed the change, and the open comment asking for the page to be updated — and returns one cited answer. Once connected, any MCP-compatible coding agent — Claude Code, Cursor, Devin, GitHub Copilot, Codex — reaches Mintlify context through a single Unblocked MCP server connection. ### What you get - **Live docs content and structure** — Agents read the full MDX of any page, search across pages, and walk your navigation tree as it stands on the deploy branch or another branch. - **One connection for every agent** — Connect Mintlify to Unblocked once. Claude Code, Cursor, Codex, and GitHub Copilot reach it through the Unblocked MCP server, with no per-agent Mintlify sign-in. - **No edits, publishes, or config changes** — Mintlify’s server can also edit pages, change configuration, and publish. Unblocked offers only its read-only tools, and you choose which of them it may call from Settings → Data Sources. - **Docs checked against the code** — The Context Engine reconciles Mintlify pages with your code, pull requests, and conversations, so an outdated page is flagged alongside the change that made it outdated — with citations. ## How to connect Mintlify to Unblocked Prerequisites: - An Unblocked account (free to start). - A Mintlify account with access to the documentation project you want to query, and permission to authorize access to it. - An MCP-compatible coding agent (Claude Code, Cursor, Devin, etc.) to use the context in your editor. ### Step 1: Connect Mintlify to Unblocked 1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Documentation select Mintlify. 2. The Mintlify MCP server URL is filled in for you. Choose OAuth, click Connect, and sign in to Mintlify to authorize Unblocked. 3. Once Unblocked discovers the server’s tools, select the read-only tools it may use and click Save Settings. ### Step 2: Install the Unblocked MCP server On macOS or Linux, one command auto-detects and configures the supported agents on your machine: ```bash curl -fsSL https://getunblocked.com/install-mcp.sh | bash ``` On Windows, or when you prefer remote MCP, add the server manually using the configuration below or follow the manual install guide: Claude Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth: ```bash claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse ``` Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth: ```json { "mcpServers": { "unblocked": { "url": "https://getunblocked.com/api/mcpsse" } } } ``` Any MCP-compatible client (Devin, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse` ## Mintlify MCP server tools Mintlify hosts and maintains this MCP server. Unblocked calls only the read-only tools you select, at the moment a question needs them: - **`search`** — Finds lines matching a substring or regular expression across every page on a branch, defaulting to the deploy branch. - **`read`** — Returns the full MDX of a page, by file path or ID, on a branch or the deploy branch. - **`list_nodes`** — Walks the navigation tree of a branch, with optional filters and paginated results. - **`read_comments`** — Lists the open comment and suggestion threads on a page, oldest first. - **`diff`** — Lists all changes between a branch and the deploy branch, with the authors of each change. - **`query_analytics`** — Runs a read-only query on your site’s analytics, covering page views, search, assistant, feedback, and agent and human traffic. ## Connect Mintlify to Claude Code, Cursor, and other AI agents To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Mintlify context, connect Mintlify to Unblocked and add the single Unblocked MCP server to your agent. Unblocked acts as the MCP context layer for your Mintlify data, searching docs pages, comments, and docs analytics alongside your other connected sources and returning cited results through these tools: - **`context_research`** — Researches a question across your connected sources and calls the Mintlify tools you selected when your documentation pages, comments, or analytics are relevant, returning a synthesized answer with citations. - **`context_get_urls`** — Fetches the full content behind URLs your agent encounters across connected sources — Jira, Linear, Notion, Confluence, Slack, GitHub, and more. ## Questions to ask an AI agent about Mintlify Questions you (or your agent) can ask Unblocked about your Mintlify data: - "Does our Mintlify page for the webhooks API still match the payload in the latest merged pull request?" - "Which docs pages mention the old auth flow, and is there a ticket to update them?" - "What are readers searching for in our docs that has no matching page, and has anyone raised it in Slack?" - "What open comments are on the quickstart page, and which code changes would resolve them?" ## Mintlify integration FAQ ### What is the Mintlify MCP server? The Mintlify MCP server is a remote Model Context Protocol server, hosted and maintained by Mintlify, that gives AI agents access to a Mintlify documentation project — its pages, navigation, comments, branches, and analytics. Unblocked connects to it as a verified MCP server, so every agent reaches it through one Unblocked connection. ### Can Unblocked edit or publish my Mintlify docs? No. Mintlify’s server includes tools that write pages, add comments, change configuration, and publish, but Unblocked excludes every tool that might modify data. Only read-only tools such as search, read, and list_nodes are available for selection. ### Which Mintlify data can agents query? Agents can read and search page content, walk the navigation tree, read open comment and suggestion threads, compare a branch with the deploy branch, and query your docs analytics — limited to the read-only tools you select and the projects your Mintlify access covers. ### Can Unblocked find Mintlify pages that are out of date? Yes. Ask about a page or an API, and the Context Engine compares what the Mintlify page says with your current code, recent pull requests, and team conversations, citing the change that made the page inaccurate. ### Does Unblocked index my Mintlify pages? No. Nothing from Mintlify is ingested or indexed. Unblocked reads your pages while it answers a question, so results reflect the branch you ask about at that moment, including unpublished edits. ## Related integrations - [GitHub](https://getunblocked.com/integrations/github/) — Repositories, pull requests, issues, discussions, and full code history — indexed, kept in sync on every push, and cited in answers. - [Context7](https://getunblocked.com/integrations/context7/) — Up-to-date library documentation from Context7’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed. - [Confluence](https://getunblocked.com/integrations/confluence/) — Pages and blog posts from the Confluence spaces you select — including rendered macro content — indexed and cited in answers. - [Linear](https://getunblocked.com/integrations/linear/) — Issues from the Linear teams you select, indexed so answers can trace a feature or bug from ticket to the code that shipped it. ## Get started with Unblocked - Start a free trial: - Pricing: - All integrations: