{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_g3sx6g7h3p6g","handle":"transparent-openapi-mcp","url":"https://wellknown.network/agents/transparent-openapi-mcp","links":{"self":"https://wellknown.network/agents/transparent-openapi-mcp/record.json","html":"https://wellknown.network/agents/transparent-openapi-mcp","markdown":"https://wellknown.network/agents/transparent-openapi-mcp/record.md","api":"https://wellknown.network/api/v1/agents/transparent-openapi-mcp","status":"https://wellknown.network/api/v1/agents/transparent-openapi-mcp/status","claim":"https://wellknown.network/agents/transparent-openapi-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/transparent-openapi-mcp/claim.json","badge":"https://wellknown.network/agents/transparent-openapi-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:transparent-openapi-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"transparent-openapi-mcp","summary":"KISS MCP server that maps OpenAPI v3 specs 1:1 onto MCP tools, transparently to spec changes","description":"# transparent-openapi-mcp\n\nA KISS MCP server that maps OpenAPI v3 specifications 1:1 onto MCP\ntools, transparently - a change to a loaded OpenAPI spec never\nrequires a change to this server's own code.\n\n## Using this as a Claude Code MCP server\n\nThree steps: build the image, set up your server-side config, wire it\ninto Claude Code.\n\n### 1. Build\n\n```sh\n./podman_build.sh\n```\n\n### 2. Configure the server\n\nThe server needs its own config: a local file (mounted into the\ncontainer) that points at a config list, which in turn points at your\nOpenAPI spec(s) and backend(s). See\n[`examples/README.md`](examples/README.md) for the full reference -\nwhat each file contains, the `<prefix>_<operationId>` tool naming\nrule, and a runnable example set proven to work end-to-end.\n\n### 3. Wire it into Claude Code\n\nClaude Code needs to know how to start the container as a stdio\nsubprocess. See\n[`examples/claude-code/README.md`](examples/claude-code/README.md)\nfor the exact MCP config entry to add and how it relates to your\nserver-side config from step 2.\n\nOnce added, run `/mcp` in a Claude Code session and confirm\n`transparent-openapi-mcp` shows up with its tools.\n\n## Try it with the bundled example\n\nBefore wiring in your own real spec/backend, you can verify the whole\nchain works using the bundled minimal example:\n\n```sh\n./podman_build.sh\n\nmkdir -p ~/t-o-m-config\ncp examples/*.example.json ~/t-o-m-config/\ncd ~/t-o-m-config\nmv local-config.example.json local-config.json\nmv config-list.example.json config-list.json\nmv minimal-openapi.example.json minimal-openapi.json\n\n# in another terminal, serve that directory:\ncd ~/t-o-m-config && python3 -m http.server 8000\n\n# back in the first terminal:\n./podman_run.sh ~/t-o-m-config/local-config.json\n```\n\nSee [`examples/README.md`](examples/README.md#running-the-bundled-example-in-podman) for\nthe full walkthrough, including how to actually call a tool and see\na result (this just starts the server - it sits silently on stdio,\nwhich is correct MCP beh…","publisher":{"name":"roebi","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:transparent-openapi-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"derived"}],"categories":["data"],"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":"transparent-openapi-mcp","registry":"pypi","observedAt":"2026-09-10T14:24:33.915Z","publishedAt":"2026-08-23T11:57:00.642672Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"transparent-openapi-mcp","url":"https://pypi.org/project/transparent-openapi-mcp/","firstSeenAt":"2026-09-10T14:23:11.360Z","fetchedAt":"2026-09-10T14:23:11.360Z","normalizedAt":"2026-09-10T14:23:11.360Z"}]},"firstSeenAt":"2026-09-10T14:23:11.360Z","updatedAt":"2026-09-10T14:24:33.915Z"}