Mintlify Official Remote MCP Server

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~285 tok5 toolsยทOnline370msยท30d uptime: 100%ยทLast checked 2m ago

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.

https://mcp.mintlify.com/mcp
Provider
Mintlify โ†—
Categories
๐Ÿ” Documentation, Search & Context๐Ÿ› ๏ธ Developer Tools & Git
ไธญๆ–‡็ฎ€ไป‹

Mintlify ๅฎ˜ๆ–น็ฎก็†็ซฏ MCP ๆœๅŠกๅ™จใ€‚AI ไปฃ็†ๅฏ้€š่ฟ‡ OAuth ่งฆๅ‘ๆ–‡ๆกฃ้ƒจ็ฝฒใ€ๆŸฅ่ฏขๅˆ†ๆžๆ•ฐๆฎๅนถๆœ็ดขไฝ ็š„ๆ–‡ๆกฃ้กน็›ฎใ€‚

Maintainer of Mintlify Admin? Claim or update this listing โ†’

Streamable HTTPhttps://mcp.mintlify.com/mcp
Install in Cursor โ†’

Or add to ~/.cursor/mcp.json:

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

๐Ÿงฐ Mintlify Admin MCP Tools & Schema (5)

ToolSafetyDescriptionParameters
trigger_deployment
~55 tok
๐ŸŸ  WriteTrigger a docs deployment for your project.projectId*: string
get_deployment_status
~57 tok
๐ŸŸข ReadCheck the status of a docs deployment.deploymentId*: string
search_docs
~50 tok
๐ŸŸข ReadSearch your project's documentation.query*: string
get_analytics
~49 tok
๐ŸŸข ReadGet docs view and search analytics.timeRange: string
assistant_chat
~54 tok
๐ŸŸข ReadAsk the Mintlify assistant over your docs content.message*: string

๐Ÿ›ก๏ธ Security, Quality & Context Token Audit

๐Ÿ›ก๏ธ Grade A+Context tax: ~285 tokens injected into every system prompt by this serverโ€™s 5 tools

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)
๐Ÿ” Audit OAuth 2.1 Config โ†’

๐Ÿงฉ 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-Authenticate challenge.
  • "Session expired" / stale Mcp-Session-Id โ€” just re-send initialize; 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

  1. Copy the Mintlify Admin MCP endpoint URL
    The remote endpoint is https://mcp.mintlify.com/mcp.
  2. Add it to your MCP client
    Claude Code: claude mcp add --transport http mintlify https://mcp.mintlify.com/mcp. Cursor: add "mintlify": { "url": "https://mcp.mintlify.com/mcp" } under mcpServers in ~/.cursor/mcp.json. Other clients work similarly.
  3. Complete the OAuth consent
    On 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.
  4. Verify with the online inspector
    Paste 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

Mintlify Admin MCP status badge
[![Remote MCP Status](https://remotemcp.net/api/badge/status/mintlify.svg)](https://remotemcp.net/servers/mintlify)
Mintlify Admin MCP inspector badge
[![Test in Inspector](https://remotemcp.net/api/badge/inspect/mintlify.svg)](https://remotemcp.net/inspector?url=https%3A%2F%2Fmcp.mintlify.com%2Fmcp)
Mintlify Admin MCP audit grade badge
[![MCP Audit Grade](https://remotemcp.net/api/badge/grade/mintlify.svg)](https://remotemcp.net/servers/mintlify)
Mintlify Admin MCP context tax badge
[![Context Tax](https://remotemcp.net/api/badge/tokens/mintlify.svg)](https://remotemcp.net/servers/mintlify)

Related Servers

AWS KnowledgeAmazon Web Services

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.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline178ms
Claude SkillsClaudeSkills.club

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.

https://claudeskills.club/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~344 tok3 toolsOnline125ms

Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus โ€” no account or token required.

https://docs.mcp.cloudflare.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEPublic ยท No Auth๐Ÿ›ก๏ธ A+~271 tok2 toolsOnline7ms

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.

https://learn.microsoft.com/api/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~971 tok3 toolsOnline228ms