Skip to content
MCP server

Mintlify Admin

Admin MCP server to edit, publish and manage Mintlify docs from an AI client

Install
Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About Mintlify Admin

Mintlify Admin is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

This is the team-side server, distinct from the search MCP that serves a site's readers. It gives an assistant write access to a Mintlify project: reading and searching pages, making targeted or full-page edits, reviewing diffs, publishing and discarding, plus config changes and automations. The OAuth session inherits your dashboard role, so viewers get read tools only and some settings need admin.

Editing works on the deploy branch, where changes are live to collaborators. Publish commits only your own changes, discard reverts only yours, and status lists only yours. Projects can require pull requests or branch work, and branch protection forces a PR regardless of settings. write_page needs a base version to avoid overwriting newer edits, and responses flag markup the editor drops.

A header can limit a connection to search and read tools. The MCP server is included on the free Starter plan.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.mintlify.com
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "adminmcp": {
      "url": "https://mcp.mintlify.com"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "adminmcp": {
      "type": "http",
      "url": "https://mcp.mintlify.com"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "adminmcp": {
      "serverUrl": "https://mcp.mintlify.com"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "adminmcp": {
      "type": "http",
      "url": "https://mcp.mintlify.com"
    }
  }
}

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

read
Fetches a page's full MDX
search
Searches pages by meaning or exact wording
edit_page
Applies targeted replacements to a page
write_page
Overwrites a page's MDX with a base version check
read_page_history
Lists a page's saved versions
list_nodes
Lists pages and private page nodes
create_node
Creates a new private page
publish
Commits your changes to the deploy branch or opens a PR
discard
Reverts your pending changes
status
Lists your pending changes
update_config
Updates project settings

What it does

Read and search pages
Fetch full MDX and search by meaning or exact wording.
Targeted edits
Apply up to 100 replacements in one call, all or nothing.
Safe overwrites
write_page needs a base version and refuses stale writes.
Own-changes publishing
Publish and discard affect only your changes.
Page history
Lists saved versions with authors.
Read-only toolset
A header limits a connection to search and read tools.

Good for

  • Have an assistant fix a docs page and open a PR
  • Search every page containing a phrase before renaming it
  • Review a page's version history
  • Update navigation or settings from chat

Pricing

Freemium, from $450 a month

Starter $0 includes MCP; Pro $450/month billed annually ($540 monthly)

Prices change. Check mintlify.com before you buy.

Mintlify Admin FAQ

Is the MCP server free?

Yes, Starter at $0 includes an MCP server; Pro is $450/month billed annually.

Who can use write tools?

Anyone with edit access; viewers get read tools and admin-only settings need an admin role.

Does it push straight to the deploy branch?

Depending on settings; branch protection requiring pull requests forces a PR.

How do I limit it to reading?

Send the x-mintlify-toolset: knowledge header.

Is Mintlify Admin free?

Mintlify Admin has a free plan, with paid plans for more usage or features. Paid plans start at $450 a month.

How do I add Mintlify Admin to Claude Code?

Run this command in your terminal: claude mcp add --transport http adminmcp https://mcp.mintlify.com

What are the best alternatives to Mintlify Admin?

The closest alternatives to Mintlify Admin are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Mintlify Admin

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools