Mintlify
by Mintlify
Edit documentation pages, restructure navigation and change site config from your AI assistant. 15 tools behind a staged checkout-diff-save session that lands as a Git pull request.
Verified connector
Listed by Anthropic as a partner connector in its Connectors Directory.
Connection checked by Agentman on .
Anthropic states this reflects the level of review a connector received, not a security audit.
Connect Mintlify via MCP
https://mcp.mintlify.comWorks in any MCP-compatible client. In Agentman Studio it is one click — no config file to edit.
Mintlify Tools & Capabilities (15)
Tool names from Anthropic's directory listing. This server requires sign-in, so we could not read tool descriptions or parameter schemas.
Frequently asked questions
Does the Mintlify MCP server publish straight to my live docs site?
Usually no. Mintlify documents save as opening a pull request by default, so changes land as a reviewable Git PR rather than on the live site. The exception is explicit: if the deployment's agent review setting is push-to-main and the deploy branch carries no protection rules, Mintlify merges that pull request immediately.
Is checkout required before the connector can edit anything?
Yes. Mintlify's documentation names checkout as the first required call, and every session binds to one Git branch created from that deployment's deploy branch. Edits buffer on the session branch in real time and nothing reaches the deploy branch until save runs, so the staging model is enforced rather than advisory.
Can I review the changes before the connector saves them?
Yes, two ways. Call diff at any point to list every change between the session and main. Every checkout also returns an editorUrl that renders the same pending changes live in the Mintlify dashboard editor, so a person can watch edits arrive while the agent works and call discard_session to drop them all.
Which Mintlify plan do I need for the admin MCP server?
Mintlify's pricing page lists an MCP server on the free Starter plan and every plan above it. Two adjacent features are gated: preview deployments and CI checks need Pro or Enterprise, and role-based access control needs Enterprise. Credits fund the assistant, agent and automations, not admin MCP tool calls.
Can the connector break my documentation site with one update_config call?
It can break the build, and that is the safer failure. update_config edits docs.json, which requires name, theme, colors.primary and navigation to produce a working site. Because save routes through Git and Mintlify validates a project before deploying, a malformed config normally fails in a pull request rather than on the live site.
Are deleted pages recoverable after delete_node or move_node?
Yes, through Git. Both tools change the navigation tree on a session branch, and Mintlify states the repository is the source of truth for every build. A deletion therefore arrives as a commit on a mintlify-mcp branch, so reverting the pull request or the commit restores the previous structure through your Git provider.
Can one connection edit every documentation site in my organization?
It depends on how you grant access. Mintlify documents connections scoped to specific deployments, which can only check out those deployments, and organization-wide connections, which can check out any deployment. A single admin MCP connection can switch between all of them, and each checked-out deployment keeps its own session and branch simultaneously.
Who on my team is allowed to connect the admin MCP server?
Anyone whose Mintlify account can already edit the project. The OAuth session inherits your dashboard permissions, so an editor gets editor reach and an admin gets admin reach. Protected settings changed through update_config need an admin role, and role-based access control itself is an Enterprise plan feature.
What happens to a session I never save or discard?
The branch persists. Mintlify holds sessions as in-memory branches on its side and states that an abandoned session's branch survives until your next checkout overwrites it. Nothing auto-saves, so no unreviewed content reaches your site, but stale mintlify-mcp branches accumulate in your repository until someone cleans them up.
How do I revoke the connector's access to my Mintlify docs?
Revoke the OAuth grant in your Mintlify dashboard under Settings, Security and access, Connected apps. Mintlify states this invalidates active session tokens immediately, so in-flight tool calls fail. It does not touch pull requests the connector already opened, which you must close or revert in your Git provider.
Sources
- Mintlify admin MCP server documentation — https://www.mintlify.com/docs/ai/mintlify-mcp (fetched 2026-08-18; the directory's URL resolves 200 with no redirect) · retrieved 2026-08-18
- Mintlify Search MCP server — https://www.mintlify.com/docs/ai/model-context-protocol (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Index MCP server — https://www.mintlify.com/docs/search-index/mcp (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Concepts — https://www.mintlify.com/docs/reference/concepts (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Branching and publishing — https://www.mintlify.com/docs/editor/branching-and-publishing (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Editor settings for AI and publishing — https://www.mintlify.com/docs/editor/settings (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Global settings (
docs.json) — https://www.mintlify.com/docs/organize/settings (fetched 2026-08-18) · retrieved 2026-08-18 - Mintlify Roles — https://www.mintlify.com/docs/dashboard/roles (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify CI checks — https://www.mintlify.com/docs/deploy/ci (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Preview deployments — https://www.mintlify.com/docs/deploy/preview-deployments (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify Credit pricing — https://www.mintlify.com/docs/credits (fetched 2026-08-18) · retrieved 2026-08-18
- Mintlify pricing — https://www.mintlify.com/pricing (fetched 2026-08-18) · retrieved 2026-08-18
- Live OAuth descriptor probes against
https://mcp.mintlify.com— 2026-08-18 · retrieved 2026-08-18 - Anthropic connector directory — https://claude.ai/directory/b66b1fcc-a173-4cc4-8060-a7cf0e971a9c (snapshot 2026-08-16) · retrieved 2026-08-16
Use in Agentman
Connect once and your agents call these tools on their own — on a schedule, in a workflow, with nobody at the keyboard.
Open in Agentman StudioServer Info
- Category
- Developer Tools
- Developer
- Mintlify
- Tools
- 15
- Domain
- mcp.mintlify.com
Using Claude Desktop or another MCP client? Setup docs — the connection URL above works anywhere.