Spec-driven tool generation
OpenAPI 3 specs parsed once at startup — $ref resolution and path-parameter handling included — so every operation becomes a named tool.
A Go MCP server that turns an OpenAPI spec into tools an agent can actually call.
Problem
Agents need live APIs, not screenshots of docs. Most OpenAPI-to-tool bridges are slow, parse the spec on every request, or hide auth behind a single happy path.
Approach
Write the proxy in Go. Share one HTTP client. Pool connections. Parse the spec once at startup. Expose every operation as a named tool with Bearer, API key, custom headers, and SSL options.
Architecture
Request path
From spec to live API call — parse once, then serve named tools to the agent.
Drag nodes to explore the flow
Solution highlights
OpenAPI 3 specs parsed once at startup — $ref resolution and path-parameter handling included — so every operation becomes a named tool.
Names encode method and path (api_GET_users vs api_POST_admin_posts), with include/exclude regex filters and a 40-character cap for Cursor's combined tool limit.
A single shared Go HTTP client with connection pooling keeps tool calls cheap under agent load.
When no spec exists, an optional crawler infers an OpenAPI 3.0.3 spec from the live API.