Point openapi-mcp at any OpenAPI 3.x spec and your AI agent gets structured, typed, agent-ready tools in seconds — no manual mapping required.
openapi-mcp parses any OpenAPI 3.x YAML or JSON spec and generates MCP tools for every operation — with output structured specifically for AI agents.
Parse any OpenAPI 3.x YAML or JSON spec and generate MCP tools for every operation. No manual mapping, no glue code.
Store specs in PostgreSQL. Activate or deactivate without restarting the server. Combine multiple active specs into a single MCP endpoint.
Every response includes OutputFormat and OutputType fields. Rich schema constraints and examples guide agents toward correct API usage.
Run as a stdio server for direct agent integration, or as an HTTP server for network access. Both modes from the same binary.
PUT, POST, and DELETE operations require explicit confirmation before execution — preventing unintended changes from runaway agents.
Built-in validate and lint commands catch spec issues before they reach your agents, with actionable suggestions for each finding.
Go 1.21+ required. Build from source and point at any spec.
# Build go build -o openapi-mcp ./cmd/openapi-mcp # Serve any OpenAPI 3.x spec as an MCP server ./openapi-mcp serve --spec path/to/openapi.yaml # Validate your spec before serving ./openapi-mcp validate --spec path/to/openapi.yaml # Lint for best practices ./openapi-mcp lint --spec path/to/openapi.yaml
