Mintlify Docs Public Remote MCP Server
Mintlify's own docs MCP (mintlify.com/docs/mcp) is a public, unauthenticated endpoint for searching Mintlify's documentation โ the same generator behind every Mintlify-hosted docs MCP.
- Provider
- Mintlify โ
- Categories
- ๐ Documentation, Search & Context
ไธญๆ็ฎไป
Mintlify ๅ ฌๅผๆๆกฃ MCP ๆๅกๅจ๏ผๅ ็ปๅฝใAI ไปฃ็ๆ ้ๅฏ้ฅๅณๅฏๆ็ดข Mintlify ๆๆกฃใAPI ๆๅไธ็ปไปถๅ่ใ
Maintainer of Mintlify Docs? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"mintlify-docs": {
"url": "https://www.mintlify.com/docs/mcp"
}
}
}claude mcp add --transport http mintlify-docs https://www.mintlify.com/docs/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"mintlify-docs": {
"type": "http",
"url": "https://www.mintlify.com/docs/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://www.mintlify.com/docs/mcp - No authentication needed โ tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"mintlify-docs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.mintlify.com/docs/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"mintlify-docs": {
"serverUrl": "https://www.mintlify.com/docs/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-docs": {
"url": "https://www.mintlify.com/docs/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.mintlify-docs] url = "https://www.mintlify.com/docs/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"mintlify-docs": {
"type": "streamableHttp",
"url": "https://www.mintlify.com/docs/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"mintlify-docs": {
"httpUrl": "https://www.mintlify.com/docs/mcp"
}
}
}๐งฐ Mintlify Docs MCP Tools & Schema (3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| search_mintlify ~229 tok | ๐ข Readidempotent | Search across the Mintlify knowledge base to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about Mintlify, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages. If you need the full content of a specific page, use the query_docs_filesystem tool to `head` or `cat` the page path (append `.mdx` to the path returned from search โ e.g. a result at `/some/page` is read with `head -200 /some/page.mdx`). | query*: stringlanguage: string |
| query_docs_filesystem_mintlify ~867 tok | ๐ข Readidempotent | Run a read-only shell-like query against a virtualized, in-memory filesystem rooted at `/` that contains ONLY the Mintlify documentation pages and OpenAPI specs. This is NOT a shell on any real machine โ nothing runs on the user's computer, the server host, or any network. The filesystem is a sandbox backed by documentation chunks. This is how you read documentation pages: there is no separate "get page" tool. To read a page, pass its `.mdx` path to `head` or `cat` โ a page at the URL path `/some/page` lives at `/some/page.mdx`. To search the docs with exact keyword or regex matches, use `rg`. To understand the docs structure, use `tree` or `ls`. **Paths are specific to this site โ never guess them.** Discover real paths with `tree / -L 2`, `ls /`, or the search tool before reading. If a path does not exist, that only means the guess was wrong; it does NOT mean the topic is undocumented โ use `rg -il "keyword" /` to find where it is covered. **Workflow:** Start with the search tool for broad or conceptual queries like "how to authenticate" or "rate limiting". Use this tool when you need exact keyword/regex matching, structural exploration, or to read the full content of a specific page by path. Supported commands: rg (ripgrep), grep, find, tree, ls, cat, head, tail, stat, wc, sort, uniq, cut, sed, jq, plus basic text utilities. No writes, no network, no process control. Run `--help` on any command for usage. Each call is STATELESS: the working directory always resets to `/` and no shell variables, aliases, or history carry over between calls. If you need to operate in a subdirectory, chain commands in one call with `&&` or pass absolute paths (e.g., `cd /some-directory && ls` or `ls /some-directory`). Do NOT assume that `cd` in one call affects the next call. Examples (replace the placeholder paths with real ones from `tree` or search): - `tree / -L 2` โ see the top-level directory layout - `rg -il "rate limit" /` โ find all files mentioning "rate limit" - `rg -C 3 "apiKey" /some-directory/` โ show matches with 3 lines of context around each hit - `head -80 /some/page.mdx` โ read the top 80 lines of a specific page - `head -80 /page-one.mdx /page-two.mdx /section/page-three.mdx` โ read multiple pages in one call - `cat /some/page.mdx` โ read a full page when you need everything - `cat /openapi/zh/discovery-openapi.json | jq '.paths | keys'` โ list OpenAPI endpoints OpenAPI specs for this site are mounted under `/openapi`; run `find /openapi -type f` to list them. Use them to answer questions about endpoints, request/response schemas, parameters, and authentication. Output is truncated to 30KB per call. Prefer targeted `rg -C` or `head -N` over broad `cat` on large files. To read only the relevant sections of a large file, use `rg -C 3 "pattern" /path/file.mdx`. Batch multiple file reads into a single `head` or `cat` call whenever possible. When referencing pages in your response to the user, convert filesystem paths to URL paths by removing the `.mdx` extension. For example, `/some/page.mdx` becomes `/some/page`. | command*: string |
| submit_feedback ~203 tok | ๐ Writeopen-world | Report a problem with this documentation site so the docs team can fix it. Use when a documentation page is incorrect, outdated, confusing, incomplete, or has a broken example. This is for feedback about the documentation content itself โ not for product support requests or feedback about this tool or assistant. | path*: stringfeedback*: 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)
- Public read-only-friendly endpoint โ no credentials stored client-side
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- None (public)
- Dynamic Client Registration
- โ
- PKCE S256
- โ
- Protected resource metadata
- https://www.mintlify.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Mintlify Docs MCP Endpoint Overview & Security Guide
Mintlify Docs MCP โ Remote MCP Server
Every Mintlify-hosted docs site can expose an auto-generated MCP endpoint โ mintlify.com/docs/mcp is Mintlify eating its own dog food: a public, read-only search over their documentation set, perfect for testing your MCP client config.
Official Mintlify Docs MCP Endpoint & Transport Architecture
- Endpoint URL:
https://www.mintlify.com/docs/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 Docs MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Mintlify Docs MCP is public and unauthenticated โ no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.
All 4 cataloged tools are read-only โ Mintlify Docs MCP cannot mutate your account data, which makes it safe to connect broadly.
Common Troubleshooting & Connection Tips
- "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Read-only public docs search โ use it to smoke-test client connectivity.
- The same pattern applies to other Mintlify-hosted docs (docs.tavily.com/mcp etc.).
๐ How to Connect
- Copy the Mintlify Docs MCP endpoint URLThe remote endpoint is https://www.mintlify.com/docs/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http mintlify-docs https://www.mintlify.com/docs/mcp. Cursor: add"mintlify-docs": { "url": "https://www.mintlify.com/docs/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Verify with the online inspectorPaste https://www.mintlify.com/docs/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Mintlify Docs MCP's 4 tools respond.
โ FAQ
What is the Mintlify Docs MCP remote MCP endpoint?
The primary endpoint is https://www.mintlify.com/docs/mcp. It is an official first-party server operated by Mintlify, speaking the Streamable HTTP transport.
How do I authenticate with Mintlify Docs MCP?
You don't โ Mintlify Docs MCP is public and unauthenticated. Connect and start calling tools; no OAuth flow or API key is needed.
I'm getting a 401 Unauthorized from Mintlify Docs MCP โ what's wrong?
Mintlify Docs MCP is authless, so a 401 is unusual. Check that you're hitting https://www.mintlify.com/docs/mcp exactly (including the path) and not an API endpoint that requires a different credential.
Which MCP clients work with Mintlify Docs MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http mintlify-docs https://www.mintlify.com/docs/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does Mintlify Docs MCP expose?
4 tools are cataloged in this directory โ including `search_mintlify_docs`, `get_docs_page`, `list_components` 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.