Admin Model Context Protocol (MCP) server

Give AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.

The admin MCP server gives AI tools write access to your Mintlify content and settings. Use it to update content and access your dashboard. With the admin MCP, you can use your preferred AI tools to edit pages, restructure navigation, update docs.json, open pull requests, change settings, create workflows, and more.

Connect an MCP client such as Claude, Claude Code, ChatGPT, or Cursor to the admin MCP server. Use it to collaborate on your Mintlify content and settings with the same tools you use to write code. Content edits happen on a branch and ship through a pull request or commit when you call save. Project management changes, such as workflow and settings updates, apply immediately to the live project. If your organization has multiple projects, a single admin MCP connection can access and switch between all of them.

The admin MCP is a hosted Mintlify service at https://mcp.mintlify.com. Every client connects to the same endpoint and authenticates with your Mintlify account.

See the Mintlify Index MCP reference for its tool inputs and rate limits.

Before connecting the admin MCP, confirm the following:

• Mintlify account: You need a Mintlify account with access to the project you want to edit. The OAuth session inherits your dashboard permissions, so admin-only actions (such as update_config on protected settings) require an admin role on the project.
• Git provider access: The GitHub, GitLab, or Bitbucket connection for the project must have write access to the deploy branch's repository. save opens PRs through the same integration used for normal deploys.
• MCP client: An MCP-capable AI tool such as Claude, Claude Code, ChatGPT, Cursor, or Codex.

You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one or more projects, depending on how you grant access. A connection scoped to specific projects can only check out those projects. An organization-wide connection can check out any project in your organization.

claude mcp add --transport http mintlify https://mcp.mintlify.com

{
  "mcpServers": {
    "mintlify": {
      "url": "https://mcp.mintlify.com"
    }
  }
}

[mcp_servers.mintlify]
url = "https://mcp.mintlify.com"

Every admin MCP session binds to a single Git branch. The flow is:

The Publishing section on the admin MCP settings page in your dashboard controls what happens when save runs with mode: "auto". Toggle Push directly to your deploy branch on to have Mintlify push changes straight to your deploy branch. Toggle it off to have save open a pull request instead.

This toggle shares the same agentReviewProcess setting as the Slack and dashboard agent, so any change here also applies to those flows.

The toggle is disabled in three cases:

• Your deploy branch requires a pull request. If branch protection rules or required approvals prevent direct pushes, MCP changes always open a pull request regardless of this setting.
• Mintlify hosts your project. For Mintlify-hosted sites, MCP changes always push directly, unless branch protection still requires a pull request.
• You aren't an admin. Changing this setting requires the admin role on your project. Editors and viewers see the toggle disabled with a permission banner.

You can also override the setting on a per-call basis by passing an explicit mode to save: "pr" always opens a pull request, and "commit" pushes to an existing PR branch without opening a new PR.

• read: Fetch the full MDX of any page on the session branch. Pass in a file path or uuid. To read a private page, pass its private-page-<uuid> node id from list_nodes with visibility: "private". Private reads work without a checkout and require an OAuth session. The admin MCP rejects client and machine-to-machine tokens for private-page access.
• search: Find lines matching a substring or regular expression across every page.
• edit_page: Apply a targeted edit to a page. To edit a private page, pass its private-page-<uuid> node id as path. Private edits require an OAuth session with an editor role or higher on the page and work without a checkout.
• write_page: Overwrite a page's full MDX content. Accepts a private-page-<uuid> node id to overwrite a private page under the same OAuth and role requirements as edit_page. Use create_node to create a new private page.

• list_nodes: Walk the navigation tree with optional filters. Filter by parentId (use recursive: true to include all descendants), one or more node types, or any division scope: language, version, tab, dropdown, anchor, product, or item. Results paginate through an opaque cursor. Pass visibility: "private" to list the private pages and folders the OAuth user can access instead of the branch nav tree. Private listing works without a checkout, ignores the other filters, and returns each node's role.
• create_node: Add a new page, group, tab, anchor, version, language, product, or dropdown. Pass visibility: "private" with data.type: "page" or data.type: "group" to create a private page or private folder in the caller's private tree. The caller becomes the node's manager. Private creation requires an OAuth session, works without a checkout, and places the node at the private root or under an existing private-folder-<uuid> parent.
• update_node: Update a node's properties in place (rename a group, change an icon, set a default version). Accepts a private-page-<uuid> or private-folder-<uuid> node id to rename a private page or folder or change its icon or tag. Private updates require an OAuth session with an editor role or higher and work without a checkout.
• move_node: Move a node, including renaming a page's path.
• delete_node: Remove a node from the navigation. Accepts a private-page-<uuid> or private-folder-<uuid> node id to delete a private page or folder from the caller's private tree. Private deletions require an OAuth session with a manager role on the node and work without a checkout.

• update_config: Modify docs.json (theme, navigation roots, integrations, SEO settings).

Code mode handles project-level operations that have no dedicated tool, such as managing workflows, project settings, members, billing, integrations, analytics, and private page sharing. Code mode tools don't require a checkout.

• search_code_operations: Search the project management methods available to code mode. Each result includes the method's full input schema.
• execute_code: Run a TypeScript script against the project management methods. The connection's granted scopes gate every method, and any method you weren't granted returns an authorization error.

• list_deployments: List the projects your connection can access, returning each {subdomain, name}. Call this to discover which subdomain to pass to checkout.
• checkout: Bind a session to a branch for a given project subdomain, or switch which project's session is active.
• list_branches: List Git branches available for a project's repository, with optional query filtering. Returns the branch names, total count, and the deploy branch. Call this before checkout to attach to an existing branch by name.
• get_session_state: Inspect the current branch, edited files, and pending nav diff.
• diff: List all changes between the session and your deploy branch.
• save: Open a pull request or commit to the session branch. If your project allows the agent to push to main and you have no branch protection rules, auto-merges the PR.
• discard_session: Drop the session and its in-flight changes.

After you connect the admin MCP, you can drive it with natural-language prompts. For example:

• "Check out a branch called add-billing-faq and create a new page under the FAQ group titled 'Billing'. Draft answers for the five questions in this Linear issue."
• "Find every page that mentions the deprecated legacy_token field and update the example to use api_key instead. Save as a PR titled 'docs: replace legacy_token references'."
• "Reorganize the API reference: move the webhooks pages into a new group called 'Webhooks' and update the icons to match the rest of the section."

Disconnect the admin MCP when you no longer want an AI tool to edit your project, or when you want to force a fresh OAuth login.

• Revoke the OAuth grant: In your Mintlify dashboard, navigate to Settings → Security & access → Connected apps and revoke the entry for the AI tool you connected. Revoking invalidates any active session tokens immediately, so in-flight tool calls fail and the tool must complete a new OAuth login on the next call.
• Remove the connector in the client:
  • Claude: Settings → Connectors, then remove the admin MCP entry.
  • Claude Code: claude mcp remove mintlify.
  • ChatGPT: Settings → Connectors, then remove the Mintlify entry.
  • Cursor: delete the mintlify entry from mcp.json and reload.
  • Codex: delete the [mcp_servers.mintlify] block from ~/.codex/config.toml.

Revoking the OAuth grant does not affect pull requests the MCP has already opened. Close or revert those PRs in your Git provider if you want to undo pending changes.

• Search Model Context Protocol (MCP) server
• Glossary
• skill.md