# mintlify-mcp
> MCP server to query any Mintlify-powered documentation from Claude Code
[](https://www.npmjs.com/package/mintlify-mcp)
[](https://opensource.org/licenses/MIT)
## What is this?
An MCP server that lets you query any documentation site powered by [Mintlify](https://mintlify.com) 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
```bash
claude mcp add agno-assistant -- bunx mintlify-mcp --project agno-v2
```
Or add to your settings manually:
```json
{
"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
```bash
claude mcp add agno-assistant -- bunx mintlify-mcp -p agno-v2
claude mcp add resend-assistant -- bunx mintlify-mcp -p resend
```
Or in settings:
```json
{
"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](https://docs.agno.com) | `agno-v2` | Tested |
| [Resend](https://resend.com/docs) | `resend` | Tested |
| [Upstash](https://upstash.com/docs) | `upstash` | Tested |
| [Mintlify](https://mintlify.com/docs) | `mintlify` | Tested |
| [Vercel](https://vercel.com/docs) | `vercel` | Tested |
| [Plain](https://plain.com/docs) | `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
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
```bash
bunx mintlify-mcp --help
OPTIONS:
-p, --project <id> Mintlify project ID (required)
-n, --name <name> Custom display name
-h, --help Show help
```
## Requirements
- [Bun](https://bun.sh) 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](./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](./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](https://mintlify.com) ([GitHub](https://github.com/mintlify)) for building amazing documentation tooling
- [Anthropic](https://anthropic.com) for Claude and the MCP protocol
