apitomcp 0.1.3

Convert any API documentation into an MCP server in minutes.

Point it at API docs, and it scrapes, generates an OpenAPI spec, creates a fully functional MCP server you can chat with, and installs it to Cursor or Claude Desktop.

Installation

pip install apitomcp

Or with uv:

uv pip install apitomcp

Quickstart

# Install
pip install apitomcp

# First-time setup (configure your LLM provider)
apitomcp init

# Generate an MCP server from any API docs
apitomcp generate

Restart Cursor/ Claude Desktop and start chatting with your API.

What It Does

1. Scrapes API documentation (handles multi-page docs, finds all endpoints)
2. Generates OpenAPI 3.1 specs using LLMs (parallel processing for speed)
3. Detects authentication requirements (OAuth2, Bearer tokens, API keys)
4. Creates MCP servers that Cursor can use as tools
5. Handles OAuth2 token refresh automatically

Features

• Multi-page scraping - Crawls linked pages to find all API endpoints
• Parallel LLM processing - Generates specs for many endpoints simultaneously
• Smart auth detection - Analyzes docs to detect OAuth2, Bearer, or API key auth
• OAuth2 token refresh - Automatically refreshes expired tokens
• Interactive CLI - Clean prompts for configuration
• Multiple LLM providers - OpenRouter, Anthropic, OpenAI, Gemini

Commands

Example

$ apitomcp generate

# Enter: https://developer.spotify.com/documentation/web-api
# It scrapes 150+ pages, finds 99+ API operations
# Generates OpenAPI spec in parallel
# Detects OAuth2 client credentials auth
# Prompts for your Spotify client ID and secret

Then chat with your API in Cursor:

How It Works

API Docs URL
     │
     ▼
┌─────────────┐
│   Scraper   │  BeautifulSoup + MarkItDown
│  (multi-page)│  Extracts endpoints & auth info
└─────────────┘
     │
     ▼
┌─────────────┐
│  Generator  │  LLM generates OpenAPI specs
│  (parallel) │  for each endpoint
└─────────────┘
     │
     ▼
┌─────────────┐
│  Validator  │  Validates against OpenAPI 3.1
│             │  Auto-retries on errors
└─────────────┘
     │
     ▼
┌─────────────┐
│   Runner    │  FastMCP creates tools from spec
│             │  Handles auth & token refresh
└─────────────┘

Supported LLM Providers

• OpenRouter
• Anthropic
• OpenAI
• Gemini

Requirements

• Python 3.10-3.13
• API key for one of the supported LLM providers

Configuration

Config is stored in ~/.apitomcp/:

• config.json - LLM provider settings
• servers/<name>/ - Generated server files

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue. Pull requests are also appreciated—I'll review them as time allows.

Author

Built by @andrew_masek_

License

MIT