doc2mcp-registry

<div align="center">

# doc2mcp

### Paste docs → get a hosted MCP server for Cursor, Claude & VS Code

**Turn any documentation URL into a live Model Context Protocol server in under 60 seconds.**

[![Live](https://img.shields.io/badge/Live-doc2mcp.site-22c55e)](https://doc2mcp.site)
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.doc2mcp-2563eb)](https://registry.modelcontextprotocol.io/?search=doc2mcp)
[![npm](https://img.shields.io/npm/v/doc2mcp?color=8b5cf6&logo=npm)](https://www.npmjs.com/package/doc2mcp)
[![GitHub stars](https://img.shields.io/github/stars/doc2mcp/doc2mcp-registry?style=social)](https://github.com/doc2mcp/doc2mcp-registry/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)

<a href="https://www.producthunt.com/products/doc2mcp?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-doc2mcp" target="_blank" rel="noopener noreferrer">
  <img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1171095&theme=light" alt="doc2mcp on Product Hunt" width="250" height="54" />
</a>

**[Try it free](https://doc2mcp.site)** · [Docs](https://doc2mcp.site/docs) · [Marketplace](https://doc2mcp.site/marketplace) · [Pricing](https://doc2mcp.site/pricing)

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

</div>

---

## What is this repo?

This is the **public face** of doc2mcp on GitHub:

| Repo | Visibility | Purpose |
|------|------------|---------|
| **[doc2mcp/doc2mcp-registry](https://github.com/doc2mcp/doc2mcp-registry)** (this repo) | Public | MCP Registry manifest, badges, discovery |
| **doc2mcp/doc2mcp** | Private | Product code (not open source) |

The **live product** runs at **[doc2mcp.site](https://doc2mcp.site)**. Source code stays private so the platform cannot be copied.

## How it works

1. Sign in at [doc2mcp.site/login](https://doc2mcp.site/login)
2. Paste a docs URL (Stripe, LangChain, your own Mintlify site, OpenAPI, GitHub repo…)
3. Get a hosted MCP URL + Bearer token
4. Paste into Cursor / Claude / VS Code `mcp.json`
5. **Every MCP you create is auto-listed** on the [official MCP Registry](https://registry.modelcontextprotocol.io/?search=doc2mcp) as `io.github.doc2mcp/<slug>`

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

## CLI

```bash
npm install -g doc2mcp
doc2mcp login
doc2mcp https://docs.example.com
```

## MCP Registry

| Entry | Namespace |
|-------|-----------|
| Platform gateway | `io.github.doc2mcp/doc2mcp` |
| Your converted docs | `io.github.doc2mcp/<slug>` (auto-published on each conversion) |

- Registry search: <https://registry.modelcontextprotocol.io/?search=doc2mcp>
- Marketplace: <https://doc2mcp.site/marketplace>

### Gateway manifest (`server.json`)

This repo publishes the canonical **platform** record via GitHub OIDC when you push a `v*` tag:

```bash
git tag v1.0.2
git push origin v1.0.2
```

Workflow: [`.github/workflows/publish-mcp.yml`](./.github/workflows/publish-mcp.yml)

## Why a separate public repo?

The MCP Registry grants namespace `io.github.doc2mcp/*` only to workflows running inside the **doc2mcp** GitHub org. This small public repo holds the OIDC publish manifest — not the product source.

## Links

- 🌐 Product: <https://doc2mcp.site>
- 📦 npm CLI: <https://www.npmjs.com/package/doc2mcp>
- 📋 MCP Registry: <https://registry.modelcontextprotocol.io/?search=doc2mcp>
- 🏆 Product Hunt: <https://www.producthunt.com/products/doc2mcp>
- ✉️ Contact: doc2mcp@gmail.com

## License

The `server.json` manifest in this repo is **MIT**. The doc2mcp product code is **proprietary** and not distributed in this repository.