{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_83nyqyx7tea6","handle":"api-to-mcp-forge","url":"https://wellknown.network/agents/api-to-mcp-forge","links":{"self":"https://wellknown.network/agents/api-to-mcp-forge/record.json","html":"https://wellknown.network/agents/api-to-mcp-forge","markdown":"https://wellknown.network/agents/api-to-mcp-forge/record.md","api":"https://wellknown.network/api/v1/agents/api-to-mcp-forge","status":"https://wellknown.network/api/v1/agents/api-to-mcp-forge/status","claim":"https://wellknown.network/agents/api-to-mcp-forge/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/api-to-mcp-forge/claim.json","badge":"https://wellknown.network/agents/api-to-mcp-forge/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/api-to-mcp-forge/history","tools":"https://wellknown.network/api/v1/agents/api-to-mcp-forge/tools"},"ard":{"identifier":"urn:air::server:api-to-mcp-forge","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"api-to-mcp-forge","summary":"Turn API documentation (a docs URL, OpenAPI/Swagger, Postman, RAML, WSDL, GraphQL, an HTML page or pasted text) into an MCP server: an evidence-only entry, tested and live-verified, served by platform-mcp-hub. MCP server, CLI and Claude Code plugin.","description":"# api-to-mcp\n\nTurn an API's documentation into a working MCP server. Give it a docs URL, an OpenAPI/Swagger file, a Postman\ncollection, RAML, WSDL, a GraphQL endpoint, an HTML reference page or pasted text; the model reads it and writes an\n**evidence-only entry** (every tool cites the documented endpoint), and api-to-mcp runs the deterministic steps: lint,\nrun config, contract tests, a stdio smoke test in Python and TypeScript, and a live verification against the real API.\n\nThe result is not generated code. It is one JSON entry describing the API, which the runtime serves as an MCP server:\n`api-to-mcp serve <category> <id>` (or `platform-mcp-hub serve --entry my_entry.json`). By default the entry is\n**generic**: its tools are the API's own operations (from an OpenAPI/Swagger description, `draft_entry` writes them),\nand the answer is passed through, with optional field selection. Any HTTP API qualifies.\n\n## Three ways to use it\n\n- **Claude Code plugin** (skill `/api-to-mcp`, the `api-to-mcp` agent and the MCP server together):\n  ```bash\n  claude plugin marketplace add tonyyang0504/api-to-mcp\n  claude plugin install api-to-mcp@api-to-mcp\n  ```\n  Then: `/api-to-mcp https://developer.example.com/openapi.json`, or ask the `api-to-mcp` agent. Needs `uv` on PATH.\n- **Any MCP client**: `api-to-mcp mcp` (stdio) or `api-to-mcp mcp --http --port 8090`. Tools: `doctor`, `workspace`,\n  `catalog_search`, `catalog_get`, `template_entry`, `ingest_openapi`, `read_docs`, `draft_entry`, `save_entry`, `lint_entry`,\n  `generate_server`, `try_tool`, `test_server`, `live_verify` ([docs/TOOLS.md](docs/TOOLS.md)).\n- **CLI**: every tool is a command: `api-to-mcp ingest <url>`, `api-to-mcp save jobs my_board entry.json`,\n  `api-to-mcp test jobs my_board`, `api-to-mcp serve jobs my_board`, ... (`api-to-mcp --help`).\n\n## Install\n\n```bash\nuvx --from api-to-mcp-forge api-to-mcp doctor      # or: pip install api-to-mcp-forge / uv tool install api-to-mcp-forge\n```\n\nThe PyPI package is `api-to-mcp-…","publisher":{"name":"api-to-mcp contributors","url":null},"homepage":"https://github.com/tonyyang0504/api-to-mcp","repository":"https://github.com/tonyyang0504/api-to-mcp/blob/main/CHANGELOG.md","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["api","claude-code","code-generation","mcp","model-context-protocol","openapi","swagger"],"pricing":null,"endpoints":[{"url":"pypi:api-to-mcp-forge","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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"declared"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"code.generation","name":"Code Generation","confidence":0.75,"provenance":"derived"}],"categories":["code","data","dev"],"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":"api-to-mcp-forge","registry":"pypi","observedAt":"2026-10-30T19:26:45.365Z","publishedAt":"2026-10-04T23:24:02.390047Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"api-to-mcp-forge","url":"https://pypi.org/project/api-to-mcp-forge/","firstSeenAt":"2026-10-06T13:22:28.443Z","fetchedAt":"2026-10-30T19:24:41.471Z","normalizedAt":"2026-10-30T19:24:41.471Z"}]},"firstSeenAt":"2026-10-06T13:22:28.443Z","updatedAt":"2026-10-30T19:26:45.365Z"}