Mintlify

v1.0.0Knowledge & Memorystable

An MCP server that enables users to query any Mintlify-powered documentation site directly from Claude. It leverages Mintlify's AI Assistant API to provide RAG-based answers and code examples for various platforms like Agno, Resend, and Upstash.

aianthropicbunclaudeclaude-code
Share:
18
Stars
0
Downloads
0
Weekly
0/5

What is Mintlify?

Mintlify is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that enables users to query any mintlify-powered documentation site directly from claude. it leverages mintlify's ai assistant api to provide rag-based answers and code examples for various...

An MCP server that enables users to query any Mintlify-powered documentation site directly from Claude. It leverages Mintlify's AI Assistant API to provide RAG-based answers and code examples for various platforms like Agno, Resend, and Upstash.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that enables users to query any Mintlify-power

Use Cases

Documentation site RAG queries
Multi-platform documentation search
Vigtu

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedApr 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mintlify

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mintlify

Docmole is an MCP server that lets you query any Mintlify-powered documentation site directly from your AI assistant using retrieval-augmented generation. It supports two modes: a zero-setup Mintlify proxy for pre-configured sites like Agno, Resend, and Upstash, and a local RAG mode where you index any documentation URL yourself using LanceDB for vector search. Developers use it to get accurate, context-aware answers and code examples from official docs without leaving their workflow.

Prerequisites

  • Bun runtime installed (https://bun.sh) — required to run bunx/docmole
  • OpenAI API key (only required for local RAG mode, not Mintlify proxy mode)
  • An MCP client such as Claude Desktop or Claude Code
  • A documentation site URL (for local RAG mode) or use a pre-configured Mintlify project slug
1

Install Bun runtime

Docmole requires the Bun JavaScript runtime. Install it if you don't already have it.

curl -fsSL https://bun.sh/install | bash
2

Test docmole in Mintlify proxy mode

Run docmole with a pre-configured Mintlify project slug to verify it works without any API key. Supported slugs include: agno-v2, resend, mintlify, vercel, upstash, plain.

bunx docmole -p agno-v2
3

Index custom documentation (local RAG mode)

To query any documentation site, set up a local RAG project by providing the URL and a project ID. This requires your OpenAI API key for embeddings.

export OPENAI_API_KEY=your-openai-api-key
bunx docmole setup --url https://docs.yoursite.com --id my-docs
4

Serve the local RAG project

Once indexed, start the MCP server for your custom documentation project. Project data is stored in ~/.docmole/projects/<project-id>/.

bunx docmole serve --project my-docs
5

Configure your MCP client

Add docmole to your Claude Desktop or other MCP client configuration file. Use the Mintlify proxy mode for pre-configured sites or local RAG mode for custom docs.

Mintlify Examples

Client configuration (Mintlify proxy mode)

Claude Desktop config for querying Agno documentation via the Mintlify proxy — no API key needed.

{
  "mcpServers": {
    "docmole": {
      "command": "bunx",
      "args": ["docmole", "-p", "agno-v2"]
    }
  }
}

Client configuration (local RAG mode)

Claude Desktop config for querying a custom documentation site indexed locally.

{
  "mcpServers": {
    "docmole": {
      "command": "bunx",
      "args": ["docmole", "serve", "--project", "my-docs"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "DOCMOLE_DATA_DIR": "~/.docmole"
      }
    }
  }
}

Prompts to try

Example prompts for querying documentation through Docmole.

- "How do I create a new agent in Agno?"
- "Show me a code example for sending an email with Resend"
- "What are the rate limits for the Upstash Redis API?"
- "How do I set up authentication in my Mintlify docs site?"

Troubleshooting Mintlify

bunx docmole command not found or fails

Ensure Bun is installed and on your PATH by running 'bun --version'. If missing, install from https://bun.sh and restart your terminal.

Local RAG mode fails with embedding error

Verify your OPENAI_API_KEY environment variable is set correctly and your OpenAI account has active credits. The key is only needed for local RAG mode, not Mintlify proxy mode.

Documentation site not indexing properly in local RAG mode

Ensure the documentation URL is publicly accessible and not behind authentication. Run 'bunx docmole setup --url <url> --id <id>' again to re-index, then restart the server.

Frequently Asked Questions about Mintlify

What is Mintlify?

Mintlify is a Model Context Protocol (MCP) server that mcp server that enables users to query any mintlify-powered documentation site directly from claude. it leverages mintlify's ai assistant api to provide rag-based answers and code examples for various platforms like agno, resend, and upstash. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mintlify?

Follow the installation instructions on the Mintlify GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mintlify?

Mintlify works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mintlify free to use?

Yes, Mintlify is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mintlify": { "command": "npx", "args": ["-y", "mintlify"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mintlify?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides