mcp-server-openapi

[](https://github.com/soyvural/mcp-server-openapi/actions/workflows/ci.yaml) [](https://golang.org/doc/go1.23) [](LICENSE) [](https://pkg.go.dev/github.com/soyvural/mcp-server-openapi) [](https://modelcontextprotocol.io) [](https://www.openapis.org/) [](https://goreportcard.com/report/github.com/soyvural/mcp-server-openapi)

Automatically convert OpenAPI endpoints into MCP tools

Turn any OpenAPI-documented API into a set of tools that Claude Desktop (or any MCP client) can call. Just tag the endpoints you want to expose, point the server at your spec, and you're done.

---

• Battle-tested OpenAPI parsing — Built on kin-openapi, the most widely used Go OpenAPI library, with full $ref resolution out of the box
• Fine-grained control — Tag-based filtering (mcp tag), x-mcp-hidden to explicitly show/hide operations, custom tool names (x-mcp-tool-name), and custom descriptions (x-mcp-description)
• Collision-safe — Automatic tool name collision detection with operationId + path-based fallback ensures no two tools silently overwrite each other
• Flexible authentication — Bearer tokens and API keys (header