mcp server

index

Mintlify Index: retrieval engine and MCP server. Install: npx mint index

mintlify/indexcommunitylistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

This project does not publish an install method we can turn into a config. Follow the README instead.

README

synced Oct 17, 2026

Mintlify Index

Real-time documentation retrieval for coding agents.

Mintlify Index answers implementation questions (syntax, configuration, migration, setup) with compact, cited context assembled from primary-source developer documentation and live web search. It ships as a hosted MCP server exposing a single context tool.

Quickstart

npx mint index

The interactive installer detects your coding agents and adds the hosted MCP server (https://index.mintlify.com/mcp) plus a usage rule so the agent reaches for it automatically. Supported clients:

Claude Code
Cursor
VS Code (Copilot)
Codex
OpenCode
Windsurf
Zed

Non-interactive setup:

npx mint index --claude --cursor --yes     # specific clients, skip prompts
npx mint index --project                   # write project-level config instead of global

Any other MCP client can be pointed at the server manually:

{
  "mcpServers": {
    "mintlify-index": {
      "type": "http",
      "url": "https://index.mintlify.com/mcp"
    }
  }
}

The context tool takes a query (plus optional product, includeDomains, excludeDomains, and a tokenBudget up to 6000) and returns a cited answer in one call.

How it works

query
  │
  ▼
router ────────────── LLM route decision against a catalog of indexed sites
  │
  ├───────────────┬─────────────────┐
  ▼               ▼                 │
mintlify leg    web leg             │  run concurrently or routed
(Chroma hybrid  (Exa search +       │
 search over     live contents)     │
 indexed docs)                      │
  └───────┬───────┘                 │
          ▼                         │
combine + rerank ── deterministic scoring, hosted reranker, LLM fallback
          │
          ▼
context assembly ── token-budget packing with query-centered snippets
          │
          ▼
MCP `context` tool

Directory	Pipeline stage
`src/retrieval/router.ts`	LLM query router deciding which leg(s) to serve
`src/retrieval/engine.ts`	The engine: legs, blending, ranking, relevance cutoff, hydration
`src/retrieval/webSearchProvider.ts`	Web leg over Exa
`src/retrieval/reranker.ts`	Hosted + LLM rerankers, query-centered snippeting
`src/retrieval/contextAssembly.ts`	Token-budget context packing
`src/retrieval/operations.ts`	`context` / `search` / `contents` operations
`src/retrieval/retrievalConfig.ts`	Tunable retrieval configuration
`src/mcp/`	MCP server: the `context` tool over streamable HTTP
`src/cli/`	The `mint index` installer (ships in the `mint` CLI)
`src/internal/`	Interfaces for Mintlify-platform components backing the hosted service

About this repo

This is a source release of the hosted service. It is not runnable standalone: docs ingestion, the Chroma corpus, auth, and infrastructure live in the Mintlify platform and are represented here by small interfaces in src/internal/. src/server.ts shows how the pieces wire together in production.

License

MIT