Mintlify Official Remote MCP Server
Mintlify's hosted admin MCP (mcp.mintlify.com/mcp) exposes docs project operations โ deployments, analytics, assistant chat and search โ to agents over OAuth 2.1.
ไธญๆ็ฎไป
Mintlify ๅฎๆน็ฎก็็ซฏ MCP ๆๅกๅจใAI ไปฃ็ๅฏ้่ฟ OAuth ่งฆๅๆๆกฃ้จ็ฝฒใๆฅ่ฏขๅๆๆฐๆฎๅนถๆ็ดขไฝ ็ๆๆกฃ้กน็ฎใ
Maintainer of Mintlify Admin? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"mintlify": {
"url": "https://mcp.mintlify.com/mcp"
}
}
}claude mcp add --transport http mintlify https://mcp.mintlify.com/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"mintlify": {
"type": "http",
"url": "https://mcp.mintlify.com/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.mintlify.com/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"mintlify": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.mintlify.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"mintlify": {
"serverUrl": "https://mcp.mintlify.com/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"mintlify": {
"url": "https://mcp.mintlify.com/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.mintlify] url = "https://mcp.mintlify.com/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"mintlify": {
"type": "streamableHttp",
"url": "https://mcp.mintlify.com/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"mintlify": {
"httpUrl": "https://mcp.mintlify.com/mcp"
}
}
}๐งฐ Mintlify Admin MCP Tools & Schema (5)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| trigger_deployment ~55 tok | ๐ Write | Trigger a docs deployment for your project. | projectId*: string |
| get_deployment_status ~57 tok | ๐ข Read | Check the status of a docs deployment. | deploymentId*: string |
| search_docs ~50 tok | ๐ข Read | Search your project's documentation. | query*: string |
| get_analytics ~49 tok | ๐ข Read | Get docs view and search analytics. | timeRange: string |
| assistant_chat ~54 tok | ๐ข Read | Ask the Mintlify assistant over your docs content. | message*: string |
๐ก๏ธ Security, Quality & Context Token Audit
Every tool definition (name + description + input schema) is injected into your LLMโs context on every request โ Estimate per-call LLM token cost โ
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- OAuth 2.1 with PKCE S256 enforced
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ Supported
- PKCE S256
- โ Supported
- Protected resource metadata
- https://mcp.mintlify.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Mintlify Admin MCP Endpoint Overview & Security Guide
Mintlify Admin MCP โ Remote MCP Server
Mintlify's admin MCP manages your own docs project โ trigger deployments after content pushes, pull view/search analytics, and query the assistant over your docs โ distinct from the auto-generated public docs endpoints (see mintlify-docs).
Official Mintlify Admin MCP Endpoint & Transport Architecture
- Endpoint URL:
https://mcp.mintlify.com/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Mintlify Admin MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Mintlify Admin MCP uses OAuth 2.1 โ the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ PKCE and Dynamic Client Registration, so no manual client setup is needed โ and simply open a browser consent screen.
Of the 5 cataloged tools, 4 are read-only and 1 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.
Common Troubleshooting & Connection Tips
- 401 Unauthorized on connect โ that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Admin surface โ requires a Mintlify account and docs project.
- Deployment triggers run real builds on your live docs site.
๐ How to Connect
- Copy the Mintlify Admin MCP endpoint URLThe remote endpoint is https://mcp.mintlify.com/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http mintlify https://mcp.mintlify.com/mcp. Cursor: add"mintlify": { "url": "https://mcp.mintlify.com/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Complete the OAuth consentOn first connection your client opens a Mintlify consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
- Verify with the online inspectorPaste https://mcp.mintlify.com/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Mintlify Admin MCP's 5 tools respond.
โ FAQ
What is the Mintlify Admin MCP remote MCP endpoint?
The primary endpoint is https://mcp.mintlify.com/mcp. It is an official first-party server operated by Mintlify, speaking the Streamable HTTP transport.
How do I authenticate with Mintlify Admin MCP?
Mintlify Admin MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.
I'm getting a 401 Unauthorized from Mintlify Admin MCP โ what's wrong?
A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.
Which MCP clients work with Mintlify Admin MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http mintlify https://mcp.mintlify.com/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does Mintlify Admin MCP expose?
5 tools are cataloged in this directory โ including `trigger_deployment`, `get_deployment_status`, `search_docs` and more. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ connect and call tools immediately.
Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus โ no account or token required.
Microsoft Learn's hosted remote MCP server. Microsoft's official Learn MCP server streams trusted, up-to-date documentation for Azure, .NET, Microsoft 365 and the full Microsoft technical catalog directly into agent context. It is public and unauthenticated โ connect and call tools immediately.