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.

Features:

• 🔍 Ask questions about Agno, Resend, or any Mintlify docs
• 💻 Get code examples and explanations without leaving your terminal
• 🧠 Multi-turn conversations with memory
• 🔗 Links converted to absolute URLs (WebFetch compatible)

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

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

Finding New Project IDs

1. Open the documentation site (e.g., docs.agno.com)
2. Open browser DevTools → Network tab
3. Use the search or AI assistant feature
4. 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)  │
└─────────────┘     └─────────────┘     └─────────────────────┘

1. You ask a question in Claude Code
2. MCP server forwards to Mintlify's AI Assistant API
3. Mintlify searches documentation using RAG
4. 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 AGENT.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:

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

Acknowledgments

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