{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8cepbztfbhed","handle":"openapi-to-mcp","url":"https://wellknown.network/agents/openapi-to-mcp","links":{"self":"https://wellknown.network/agents/openapi-to-mcp/record.json","html":"https://wellknown.network/agents/openapi-to-mcp","markdown":"https://wellknown.network/agents/openapi-to-mcp/record.md","api":"https://wellknown.network/api/v1/agents/openapi-to-mcp","status":"https://wellknown.network/api/v1/agents/openapi-to-mcp/status","claim":"https://wellknown.network/agents/openapi-to-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/openapi-to-mcp/claim.json","badge":"https://wellknown.network/agents/openapi-to-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:openapi-to-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"openapi-to-mcp","summary":"A Python library to automatically convert any OpenAPI v2/v3 specification into a Model Context Protocol (MCP) server, with integrations for popular frameworks like FastAPI.","description":"# OpenAPI to MCP Converter (Python)\n\nA Python library to automatically generate MCP (Model-View-Controller Protocol) servers from OpenAPI specifications.\n\nThis library allows you to expose any API with an OpenAPI v3 specification as an MCP-compliant server, making it easy to integrate with AI agents and other MCP-enabled tools.\n\n## Features\n\n- **Dynamic Conversion**: Generate MCP servers from any public OpenAPI v3 specification URL.\n- **Path Filtering**: Selectively expose a subset of API endpoints.\n- **Dynamic Upstream URL**: Forward requests to a different base URL than the one in the OpenAPI spec.\n- **Authentication Forwarding**: Pass authentication headers to the upstream API.\n- **`$ref` Resolution**: Automatically resolves JSON references (`$ref`) in the OpenAPI spec for complete schema definitions.\n- **Security**: Built-in SSRF protection with a configurable domain whitelist.\n- **Framework Integration**: Plug-and-play integration with FastAPI.\n\n## Installation\n\n```bash\npip install openapi-to-mcp\n```\n\n## Quick Start - FastAPI Integration\n\nHere's how to add an MCP server to your existing FastAPI application. This example sets a static OpenAPI spec URL and enables security.\n\n```python\nfrom fastapi import FastAPI\nfrom openapi_to_mcp.fastapi import add_mcp_route\n\napp = FastAPI()\n\n# Add the MCP route\n# This will expose an MCP server at /mcp\nadd_mcp_route(\n    app,\n    openapi_url=\"https://petstore.swagger.io/v2/swagger.json\",\n    allowed_domains=[\"petstore.swagger.io\"]  # SSRF Protection\n)\n\n@app.get(\"/\")\ndef read_root():\n    return {\"Hello\": \"World\"}\n```\n\n## Advanced Configuration\n\nYou can configure the MCP server statically when you initialize it or dynamically using query parameters.\n\n### Static Configuration\n\nPass a configuration object to `add_mcp_route`:\n\n- `route_prefix` (optional, default: `/mcp`): The base path for the MCP server.\n- `openapi_url` (optional): A default OpenAPI specification URL.\n- `allowed_domains` (optional, default: `[]`): A list of allowe…","publisher":{"name":"Sriram Krishna","url":null},"homepage":"https://github.com/itssri5/openapi-to-mcp","repository":"https://github.com/itssri5/openapi-to-mcp","version":"0.1.1","license":"MPL-2.0","protocols":["mcp"],"tags":["openapi","mcp","fastapi","api","converter","generator"],"pricing":null,"endpoints":[{"url":"pypi:openapi-to-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"declared"},{"slug":"documents.conversion","name":"Document Conversion","confidence":0.836,"provenance":"derived"}],"categories":["data","documents"],"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":"openapi-to-mcp","registry":"pypi","observedAt":"2026-09-10T08:27:42.328Z","publishedAt":"2025-07-26T22:24:07.195410Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"openapi-to-mcp","url":"https://pypi.org/project/openapi-to-mcp/","firstSeenAt":"2026-09-10T08:26:34.459Z","fetchedAt":"2026-09-10T08:26:34.459Z","normalizedAt":"2026-09-10T08:26:34.459Z"}]},"firstSeenAt":"2026-09-10T08:26:34.459Z","updatedAt":"2026-09-10T08:27:42.328Z"}