# dodopayments/contextmcp [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/dodopayments/context-mcp  
**GitHub Stars:** 76  
**npm Downloads (last month):** 278  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/dodopayments-contextmcp

## Description
Self-hosted MCP server that indexes documentation from various sources and serves it to AI Agents with semantic search.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "contextmcp": {
    "command": "npx",
    "args": ["-y","contextmcp"],
    "env": {
      "PINECONE_API_KEY": "",
      "OPENAI_API_KEY": "",
      "GEMINI_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `PINECONE_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# ContextMCP

<p align="left">
  <a href="https://discord.gg/bYqAp4ayYh">
    <img src="https://img.shields.io/discord/1305511580854779984?label=Join%20Discord&logo=discord" alt="Join Discord" />
  </a>
  <a href="https://twitter.com/dodopayments">
    <img src="https://img.shields.io/twitter/follow/dodopayments?label=Follow&style=social" alt="Twitter Follow" />
  </a>
</p>

**Self-hosted MCP server for your documentation.** Index your documentation from across the sources and serve it via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) and REST API.

## Quick Start

```bash
# Scaffold a new project
npx contextmcp init my-docs-mcp

# Follow the prompts, then:
cd my-docs-mcp
npm install

# Configure your API keys
cp .env.example .env
# Edit .env with your PINECONE_API_KEY and an embedding provider key
# (OPENAI_API_KEY for provider: openai, or GEMINI_API_KEY for provider: gemini)

# Configure your documentation sources
# Edit config.yaml

# Index your documentation
npm run reindex

# Edit the cloudflare-worker
# Deploy the MCP server
cd cloudflare-worker
npm install
npm run deploy
```

## What is ContextMCP?

ContextMCP creates a searchable knowledge base from your documentation that AI assistants can query via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).

### Supported Content Types

| Parser     | Content Types         | Examples                       |
| ---------- | --------------------- | ------------------------------ |
| `mdx`      | MDX/JSX documentation | Mintlify, Fumadocs, Docusaurus |
| `markdown` | Plain Markdown files  | READMEs, CHANGELOGs            |
| `openapi`  | OpenAPI/Swagger specs | API reference docs             |

### How It Works

1. **Parse** - Extract content from your docs, APIs, and READMEs
2. **Chunk** - Split into semantic chunks optimized for search
3. **Embed** - Generate embeddings using OpenAI or Gemini
4. **Store** - Upload to Pinecone vector database
5. **Search** - Query via MCP from AI assistants

## Ecosystem

### Add a chat UI with ContextChat

ContextMCP serves retrieval; pair it with [**ContextChat**](https://github.com/dodopayments/context-chat) to give your docs a drop-in, embeddable "Ask AI" widget. ContextChat is a single Cloudflare Worker that queries your ContextMCP `/search` endpoint and streams answers with inline citations — add it to any site or docs page with one `<script>` tag.

## Repository Structure

```
contextmcp/
├── packages/
│   ├── cli/              # npx contextmcp (npm package)
│   ├── template/         # Project template (scaffolded to users)
│   └── website/          # contextmcp.ai documentation site
└── deployments/
    └── dodopayments/     # Dodo Payments specific deployment
```

## Packages

| Package             | Description          | Published            |
| ------------------- | -------------------- | -------------------- |
| `packages/cli`      | CLI scaffolding tool | ✅ npm: `contextmcp` |
| `packages/template` | Project template     | (copied by CLI)      |
| `packages/website`  | Documentation site   | (deployed to Vercel) |

## Development

### Prerequisites

- Node.js 18+

### Setup

```bash
# Install all dependencies
npm install

# Development
npm run dev:website     # Run website locally
npm run dev:cli         # Watch CLI for changes

# Build
npm run build:website   # Build website
npm run build:cli       # Build CLI

# Type checking
npm run typecheck       # Check all packages
```

## Documentation

Visit [contextmcp.ai/docs](https://contextmcp.ai/docs) for full documentation.

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](https://github.com/dodopayments/context-mcp/blob/HEAD/CONTRIBUTING.md) for guidelines on how to contribute to this project.

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/dodopayments/context-mcp/blob/HEAD/LICENSE) file for details.