Aggregate multiple OpenAPI/Swagger specs into one searchable, documentation-focused MCP server.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"openapi-atlas-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# openapi-atlas-mcp `openapi-atlas-mcp` aggregates multiple OpenAPI/Swagger specifications from your backend services into a single searchable, documentation-focused [Model Context Protocol](https://modelcontextprotocol.io) server. It lets an AI agent (Claude Desktop, Cursor, Claude Code, VS Code) answer questions like _"show me the payload for submit order"_ across **all** of your configured services in one query — instead of making you hunt through N separate Swagger UIs. ## Install ```bash # pip pip install openapi-atlas-mcp # uv (recommended for MCP servers) uv tool install openapi-atlas-mcp ``` ## Quick start 1. Create a config file (`.openapi-atlas.json`) in your project root: ```bash openapi-atlas-mcp init ``` This launches an interactive wizard. Or write the file manually: ```json { "services": [ { "name": "orders", "url": "http://localhost:8000" }, { "name": "billing", "url": "https://billing.internal.example.com", "auth": { "type": "bearer", "token_env": "BILLING_API_TOKEN" } } ] } ``` 2. Set any required environment variables: ```bash export BILLING_API_TOKEN=your-secret-token ``` 3. Start the server: ```bash openapi-atlas-mcp serve ``` ## Agent-host integration ### Claude Desktop (`claude_desktop_config.json`) ```json { "mcpServers": { "openapi-atlas": { "command": "uv", "args": ["tool", "run", "openapi-atlas-mcp", "serve"] } } } ``` ### Cursor (`.cursor/mcp.json`) ```json { "mcpServers": { "openapi-atlas": { "command": "openapi-atlas-mcp", "args": ["serve"] } } } ``` ### Claude Code ```bash claude mcp add openapi-atlas -- openapi-atlas-mcp serve ``` ### VS Code Add to `.vscode/mcp.json`: ```json { "servers": { "openapi-atlas": { "command": "openapi-atlas-mcp", "args": ["serve"] } } } ``` ## Configuration reference The config file (`.openapi-atlas.json` or path via `OPENAPI_ATLAS_CONFIG`…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.