{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zx9388sezbzp","handle":"mcp-openapi-2","url":"https://wellknown.network/agents/mcp-openapi-2","links":{"self":"https://wellknown.network/agents/mcp-openapi-2/record.json","html":"https://wellknown.network/agents/mcp-openapi-2","markdown":"https://wellknown.network/agents/mcp-openapi-2/record.md","api":"https://wellknown.network/api/v1/agents/mcp-openapi-2","status":"https://wellknown.network/api/v1/agents/mcp-openapi-2/status","claim":"https://wellknown.network/agents/mcp-openapi-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-openapi-2/claim.json","badge":"https://wellknown.network/agents/mcp-openapi-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-openapi-2/history","tools":"https://wellknown.network/api/v1/agents/mcp-openapi-2/tools"},"ard":{"identifier":"urn:air::server:mcp-openapi-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-openapi","summary":"A Model Context Protocol bridge to OpenAPI servers","description":"# MCP-OpenAPI\n\nA [Model Context Protocol][mcp] server that exposes HTTP methods from an OpenAPI spec as tools.\n\n> [!WARNING]\n> This is a proof of concept, yet to be fully tested and documented.\n\n## Usage\n\nEach MCP-OpenAPI server exposes operations from a single OpenAPI spec. You could run multiple instances to expose multiple specs.\n\nThis package is available on PyPI @ [`mcp-openapi`][pypi]. You can start a server with `uvx mcp-openapi --openapi-url https://httpbin.org/spec.json (sse | stdio)`.\n\nAn example Claude config (while running `fastapi dev tests/todos.py` with port 8000):\n\n```json\n{\n  \"mcpServers\": {\n    \"todos\": {\n    \"command\": \"uvx\",\n    \"args\": [\n        \"mcp-openapi\",\n        \"--openapi-url=http://localhost:8000/openapi.json\",\n        \"stdio\"\n      ]\n    }\n  }\n}\n```\n\nThe OpenAPI url can also be passed as an environment variable, `MCP_OPENAPI_URL`.\n\nWhen running as SSE, you can configure the server with:\n\n- `--fastmcp-sse-host` - the host to serve the MCP server on\n- `--fastmcp-sse-port` - the port to serve the MCP server on\n\nThere are additional global options:\n\n- `--fastmcp-debug` - enable debug mode for the MCP server\n- `--fastmcp-log-level` - the log level for the MCP server\n\nThese can also be configured via environment variables using the `FASTMCP_` prefix, e.g. `FASTMCP_LOG_LEVEL=DEBUG`.\n\n### How it works\n\n1. The MCP-OpenAPI server is initialised with an OpenAPI spec URL.\n2. The server fetches and parses the OpenAPI spec, and registers each path-operation as a tool.\n3. A FastMCP server is started with the registered tools.\n4. When a client requests a tool, the MCP server makes a HTTP request to the API and returns the response.\n\n### Supported OpenAPI/Swagger versions\n\n| Swagger 2.0 | OpenAPI 3.0 | OpenAPI 3.1 |\n|-------------|-------------|-------------|\n| :x: | :heavy_check_mark: | :heavy_check_mark: |\n\nThis package supports OpenAPI 3.0 and 3.1 specs, in JSON and YAML formats.\n\nWe're using [openapi-parser][openapi-parser] under the hood, which se…","publisher":null,"homepage":"https://github.com/rmasters/mcp-openapi","repository":"https://github.com/rmasters/mcp-openapi","version":"0.0.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-openapi","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.745,"provenance":"derived"}],"categories":["data","dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-openapi","registry":"pypi","observedAt":"2026-11-09T16:26:15.622Z","publishedAt":"2025-02-23T02:50:05.676592Z","latestVersion":"0.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-openapi","url":"https://pypi.org/project/mcp-openapi/","firstSeenAt":"2026-09-10T02:24:28.306Z","fetchedAt":"2026-11-09T16:25:16.364Z","normalizedAt":"2026-11-09T16:25:16.364Z"}]},"firstSeenAt":"2026-09-10T02:24:28.306Z","updatedAt":"2026-11-09T16:26:15.622Z"}