Which embedding providers can it use?

ContextMCP supports OpenAI and Gemini embeddings.

Where are document embeddings stored?

The server uploads embeddings to Pinecone.

How is the server deployed?

The scaffolded project includes a Cloudflare Worker deployment that can be deployed with npm run deploy.

Contextmcp

documentationsemantic-searchmcpvector-database

Self-hosted MCP server that indexes documentation and exposes semantic search through MCP and a REST API.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

ContextMCP parses MDX, Markdown, and OpenAPI documentation into searchable semantic chunks. It generates embeddings with OpenAI or Gemini and stores them in Pinecone. Use it when AI assistants need to query a self-hosted documentation knowledge base through MCP or REST.

Use cases

Index MDX documentation from supported documentation sites

Search Markdown READMEs and changelogs semantically

Create searchable knowledge bases from OpenAPI specifications

Serve documentation queries to AI assistants over MCP

Expose indexed documentation through a REST API

Key features

MDX, Markdown, and OpenAPI parsers

Semantic document chunking

OpenAI or Gemini embedding providers

Pinecone vector storage

MCP query interface

REST API

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Contextmcp.

Extracted Tool Capabilities

MDX, Markdown, and OpenAPI parsers

Semantic document chunking

OpenAI or Gemini embedding providers

Pinecone vector storage

MCP query interface

REST API

Documentation Overview

ContextMCP

Self-hosted MCP server for your documentation. Index your documentation from across the sources and serve it via the Model Context Protocol (MCP) 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).

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

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

Ecosystem

Add a chat UI with ContextChat

ContextMCP serves retrieval; pair it with ContextChat 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

Code

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 for full documentation.

Contributing

We welcome contributions! Please see 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 file for details.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

278

Package downloads in the last 30 days.

Last commit

9d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Contextmcp

It supports MDX/JSX documentation, plain Markdown files, and OpenAPI or Swagger specifications.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/dodopayments-contextmcp?style=directory)](https://allmcps.com/mcp/dodopayments-contextmcp)

HTML Embed

<a href="https://allmcps.com/mcp/dodopayments-contextmcp"><img src="https://allmcps.com/api/badge/dodopayments-contextmcp?style=directory" alt="Contextmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingBring your own API key (usage-based cost)

10/10 checks healthy over the last 32d

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools18/30

Adoption & activity10/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 26d ago via OSV.dev · contextmcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Contextmcp →Install in Claude Desktop Install in Cursor Install in VS Code

Contextmcp

documentationsemantic-searchmcpvector-database

Self-hosted MCP server that indexes documentation and exposes semantic search through MCP and a REST API.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Index MDX documentation from supported documentation sites

Search Markdown READMEs and changelogs semantically

Create searchable knowledge bases from OpenAPI specifications

Serve documentation queries to AI assistants over MCP

Expose indexed documentation through a REST API

Key features

MDX, Markdown, and OpenAPI parsers

Semantic document chunking

OpenAI or Gemini embedding providers

Pinecone vector storage

MCP query interface

REST API

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Contextmcp.

Extracted Tool Capabilities

MDX, Markdown, and OpenAPI parsers

Semantic document chunking

OpenAI or Gemini embedding providers

Pinecone vector storage

MCP query interface

REST API

Documentation Overview

ContextMCP

Self-hosted MCP server for your documentation. Index your documentation from across the sources and serve it via the Model Context Protocol (MCP) 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).

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

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

Ecosystem

Add a chat UI with ContextChat

Repository Structure

Code

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 for full documentation.

Contributing

We welcome contributions! Please see 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 file for details.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

278

Package downloads in the last 30 days.

Last commit

9d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Contextmcp

It supports MDX/JSX documentation, plain Markdown files, and OpenAPI or Swagger specifications.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/dodopayments-contextmcp?style=directory)](https://allmcps.com/mcp/dodopayments-contextmcp)

HTML Embed

<a href="https://allmcps.com/mcp/dodopayments-contextmcp"><img src="https://allmcps.com/api/badge/dodopayments-contextmcp?style=directory" alt="Contextmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingBring your own API key (usage-based cost)

10/10 checks healthy over the last 32d

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools18/30

Adoption & activity10/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 26d ago via OSV.dev · contextmcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Contextmcp →Install in Claude Desktop Install in Cursor Install in VS Code