Mintlify Admin
Admin MCP server to edit, publish and manage Mintlify docs from an AI client
- 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.comAdd to Settings → Connectors → Add custom connector
https://mcp.mintlify.comAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"adminmcp": {
"url": "https://mcp.mintlify.com"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools