mintlify-mcp

mintlify-mcp

MCP server to query any Mintlify-powered documentation from Claude Code

What is this?

An MCP server that lets you query any documentation site powered by Mintlify directly from Claude Code.

Example use cases:

• Ask questions about Agno, Resend, or any Mintlify docs
• Get code examples and explanations without leaving your terminal
• Multi-turn conversations with documentation context

Quick Start

claude mcp add agno-assistant -- bunx mintlify-mcp --project agno-v2

Or add to your settings manually:

{
  "mcpServers": {
    "agno-assistant": {
      "command": "bunx",
      "args": ["mintlify-mcp", "-p", "agno-v2"]
    }
  }
}

Tools available:

• ask - Ask any question about the docs
• clear_history - Reset conversation

Multiple Documentation Sites

claude mcp add agno-assistant -- bunx mintlify-mcp -p agno-v2
claude mcp add resend-assistant -- bunx mintlify-mcp -p resend

Or in settings:

{
  "mcpServers": {
    "agno-assistant": {
      "command": "bunx",
      "args": ["mintlify-mcp", "-p", "agno-v2"]
    },
    "resend-assistant": {
      "command": "bunx",
      "args": ["mintlify-mcp", "-p", "resend"]
    }
  }
}

Known Project IDs

Documentation	Project ID	Status
Agno	agno-v2	Tested
Resend	resend	Tested
Upstash	upstash	Tested
Mintlify	mintlify	Tested
Vercel	vercel	Tested
Plain	plain	Tested

Want to add more? The project ID is usually the subdomain or company name. Open a PR or issue!

Finding New Project IDs

• Open the documentation site (e.g., docs.agno.com)
• Open browser DevTools → Network tab
• Use the search or AI assistant feature
• Look for requests to leaves.mintlify.com/api/assistant/{project-id}/message

CLI Options

bunx mintlify-mcp --help

OPTIONS:
  -p, --project <id>    Mintlify project ID (required)
  -n, --name <name>     Custom display name
  -h, --help            Show help

Requirements

• Bun runtime: curl -fsSL https://bun.sh/install | bash

How It Works

┌─────────────┐     ┌─────────────┐     ┌─────────────────────┐
│ Claude Code │────▶│ MCP Server  │────▶│ Mintlify Assistant  │
│             │◀────│ (this repo) │◀────│ API (RAG Pipeline)  │
└─────────────┘     └─────────────┘     └─────────────────────┘

• You ask a question in Claude Code
• MCP server forwards to Mintlify's AI Assistant API
• Mintlify searches documentation using RAG
• Response streams back to Claude Code

Context Optimization: The server extracts only the assistant's text from SSE responses, reducing ~50-100KB raw responses to ~1KB (99% reduction!).

API Documentation

See CLAUDE.md for complete reverse-engineered API documentation including:

• Endpoint details and schemas
• Request/response formats
• cURL examples
• Multi-turn conversation support

License

MIT - See LICENSE

Contributing

PRs welcome! To add a new documentation site:

• Add the project ID to KNOWN_DOCS in src/index.ts
• Update the table above
• Submit a PR

Acknowledgments

• Mintlify for building amazing documentation tooling
• Anthropic for Claude and the MCP protocol