{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ane8dqgptru4","handle":"vinayak-rastogi-mcp-from-openapi","url":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi","links":{"self":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi/record.json","html":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi","markdown":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi/record.md","api":"https://wellknown.network/api/v1/agents/vinayak-rastogi-mcp-from-openapi","status":"https://wellknown.network/api/v1/agents/vinayak-rastogi-mcp-from-openapi/status","claim":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi/claim.json","badge":"https://wellknown.network/agents/vinayak-rastogi-mcp-from-openapi/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/vinayak-rastogi-mcp-from-openapi/history","tools":"https://wellknown.network/api/v1/agents/vinayak-rastogi-mcp-from-openapi/tools"},"ard":{"identifier":"urn:air::server:vinayak-rastogi-mcp-from-openapi","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-from-openapi","summary":"Convert OpenAPI 3.x specs into live, working MCP servers","description":"# openapi-to-mcp\n\nConvert any OpenAPI 3.x spec file into a live, working MCP (Model Context Protocol) server that AI agents can connect to and use as tools.\n\n## What it does\nThis CLI tool parses an OpenAPI 3.x specification and generates a standalone Python script acting as an MCP server. This allows AI assistants (like Claude, Cursor, or Copilot) to understand and interact with your existing REST APIs by converting your OpenAPI endpoints into MCP tools.\n\n## How it works\n1. **Parse**: Reads your OpenAPI specification (YAML or JSON).\n2. **Generate**: Uses Jinja2 templates to construct a complete, standalone Python file containing the MCP server logic.\n3. **Run**: Provides an option to immediately start the generated MCP server using the stdio or sse transport.\n\n## Installation\n\n```bash\npip install mcp-from-openapi\n```\n\nFor development:\n```bash\ngit clone https://github.com/vinayakrastogi/openAPI-to-MCP-converter.git\ncd openAPI-to-MCP-converter\npip install -e .\n```\n\n## Commands\n\n### 1. Inspect endpoints in a spec (dry-run)\nPrints a table of all discovered endpoints, their tool names, and parameters without generating any files.\n\n```bash\nopenapi-to-mcp inspect --spec examples/math_api.yaml\n```\n\n### 2. Generate a standalone MCP server\nOutputs a ready-to-run Python file (e.g., `output/math_api_mcp_server.py`).\n\n```bash\nopenapi-to-mcp generate \\\n  --spec examples/math_api.yaml \\\n  --base-url http://127.0.0.1:8000\n```\n\n### 3. Generate and immediately run\nCreates the MCP server file and starts it immediately.\n\n```bash\nopenapi-to-mcp run \\\n  --spec examples/math_api.yaml \\\n  --base-url http://127.0.0.1:8000\n```\n\n### 4. Run with Authentication\nInjects authentication headers into every request made by the MCP server.\n\n```bash\n# Bearer token style:\nopenapi-to-mcp run \\\n  --spec examples/pet_api.yaml \\\n  --base-url https://api.example.com \\\n  --auth-header \"Authorization: Bearer mytoken\"\n\n# API key style:\nopenapi-to-mcp run \\\n  --spec examples/pet_api.yaml \\\n  --base-url https:/…","publisher":{"name":"Vinayak Rastogi","url":null},"homepage":"https://github.com/vinayakrastogi/openAPI-to-MCP-converter","repository":"https://github.com/vinayakrastogi/openAPI-to-MCP-converter","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["openapi","mcp","model-context-protocol","ai","cli","code-generation"],"pricing":null,"endpoints":[{"url":"pypi:mcp-from-openapi","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":"security.identity","name":"Identity & Access","confidence":1,"provenance":"derived"},{"slug":"code.generation","name":"Code Generation","confidence":0.75,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","data","dev","security"],"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-from-openapi","registry":"pypi","observedAt":"2026-10-22T09:23:22.741Z","publishedAt":"2026-05-29T02:42:51.994617Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-from-openapi","url":"https://pypi.org/project/mcp-from-openapi/","firstSeenAt":"2026-09-10T01:21:00.807Z","fetchedAt":"2026-10-22T09:21:32.699Z","normalizedAt":"2026-10-22T09:21:32.699Z"}]},"firstSeenAt":"2026-09-10T01:21:00.807Z","updatedAt":"2026-10-22T09:23:22.741Z"}