# Mintlify Admin

> Mintlify Admin is a freemium MCP server for developer tools. Admin MCP server to edit, publish and manage Mintlify docs from an AI client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $450 a month
- **Platforms:** Web, API
- **Website:** https://www.mintlify.com/docs/ai/mintlify-mcp
- **MCP Registry name:** com.mintlify/adminmcp
- **Categories:** developer tools, files and documents
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.mintlify.com
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mintlify-admin
