Expose any OpenAPI/Swagger API as Model Context Protocol (MCP) tools over stdio.
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-mcp-bridge","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-mcp-bridge [](https://github.com/sssdavid529/openapi-mcp-bridge/actions/workflows/ci.yml) [](https://pypi.org/project/openapi-mcp-bridge/) [](https://www.python.org/) [](LICENSE) Turn **any** OpenAPI/Swagger API into [Model Context Protocol](https://modelcontextprotocol.io) tools. Point the bridge at a spec (URL or local file) and every endpoint becomes an MCP tool that an AI assistant — Claude Desktop, or any MCP client — can call directly. The bridge constructs the real HTTP request, sends it, and returns the response to the model. - 🔧 **One tool per endpoint** — names from `operationId`, JSON Schema inputs built from parameters and request bodies. - 📥 **OpenAPI 3.x and Swagger 2.0** — both normalised to the same model. - 🔌 **stdio transport** built on the official [`mcp`](https://pypi.org/project/mcp/) SDK. - 🔒 **No secrets in code** — every credential comes from an environment variable. - ✅ **Typed, tested, and linted.** ## Installation ```bash pip install openapi-mcp-bridge ``` Or install it as an isolated CLI tool: ```bash pipx install openapi-mcp-bridge ``` It requires Python 3.10+. ## Quickstart List the tools generated from the public Swagger Petstore spec (this does **not** start a server — handy for inspecting what will be exposed): ```bash openapi-mcp-bridge --spec https://petstore3.swagger.io/api/v3/openapi.json --list-tools ``` Run it as an MCP server over stdio: ```bash openapi-mcp-bridge --spec https://petstore3.swagger.io/api/v3/openapi.json ``` You can also invoke it as a module: ```bash python -m openapi_mcp_bridge --spec ./openapi.yaml ``` ## Use with Claude Desktop Add an entry to your `claude_desktop_config.json`: - **macOS:** `~/Lib…
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.