doc2mcp

Documentation infrastructure for AI agents

Paste any docs URL → get a hosted, Cursor-ready MCP server in under 60 seconds.

Live · Docs · SDK · Marketplace · Open Source

⭐ Star this repo — it helps developers discover doc2mcp on GitHub and the MCP Registry.

Three ways to use doc2mcp

Web · CLI · SDK

Surface	Best for	Start here
Web	Instant convert in the browser	doc2mcp.site
CLI	Terminal + one-shot install into Cursor	`npm i -g doc2mcp`
SDK	Code, CI, LangChain / LangGraph / agents	`doc2mcp-sdk`

API keys always come from doc2mcp.site (User PAT + project token). The SDK has no separate login.

The pipeline

The doc2mcp pipeline

Docs URL → crawl → analyze → MCP tools → hosted endpoint → Cursor / Claude / LangChain / LangGraph.

1) Web (normal)

Sign in at doc2mcp.site/login
Paste a docs URL (Stripe, LangChain, Mintlify, GitHub…)
Copy the hosted MCP URL + Bearer token into Cursor / Claude / VS Code

config.json

{
  "mcpServers": {
    "my-docs": {
      "url": "https://doc2mcp.site/api/mcp/{project_id}/mcp",
      "headers": { "Authorization": "Bearer <project-token>" }
    }
  }
}

2) CLI

Terminal

npm install -g doc2mcp
doc2mcp login                 # creates User PAT (d2mcp_pat_…)
doc2mcp https://docs.example.com

Lists the same projects as the dashboard. Install helpers for Cursor / VS Code / Claude / Windsurf.

3) SDK (`doc2mcp-sdk`)

SDK architecture

Terminal

npm i doc2mcp-sdk

server.ts

import { Doc2MCP } from "doc2mcp-sdk";

// User PAT from doc2mcp.site / `npx doc2mcp login` — SDK has no auth of its own
const client = new Doc2MCP({ token: process.env.DOC2MCP_API_TOKEN! }); // Settings → d2mcp_usr_…

const ready = await client.convertAndWait({
  sourceUrl: "https://js.langchain.com/docs",
});

const answer = await client.callToolText({
  mcpUrl: ready.mcp.url,
  mcpToken: ready.mcp.token, // project token d2mcp_…
  name: "search_documentation",
  arguments: { query: "how do runnables work?" },
});

Full handbook (API keys, Cursor, Claude, LangChain, LangGraph, LangSmith, OpenAI, Vercel AI SDK, CrewAI, AutoGen, Mastra):

doc2mcp/doc2mcp-sdk → docs/

Product docs page: doc2mcp.site/docs/sdk

MCP tools generated per project

Tool	What it does
`list_documentation_pages`	Every crawled page
`get_documentation_page`	Full markdown of one page
`search_documentation`	Heading-aware search
`get_documentation_overview`	Summary + index
`read_full_documentation`	All pages combined
`ask_documentation`	Q&A with citations

Repos

Repo	Purpose
doc2mcp/doc2mcp (this)	Next.js app, CLI, pipeline, MCP runtime
doc2mcp/doc2mcp-sdk	Programmatic JS/TS SDK + framework examples
doc2mcp/doc2mcp-registry	MCP Registry gateway manifest

Contribute

Read CONTRIBUTING.md and CODE_OF_CONDUCT.md
Branch from staging → open PR → staging
AI review (Gemini PR review) fails the check on must-fix — fix blockers before merge
Coupon opensourcedoc2mcp → Starter free for 12 months on Pricing

More: doc2mcp.site/open-source

Local development

bash

pnpm install
cp .env.example .env.local
pnpm dev