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

Or add to your settings manually:

Tools available:

• ask - Ask any question about the docs

• clear_history - Reset conversation

Multiple Documentation Sites

Or in settings:

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

Requirements

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

How It Works

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