Openapi MCP Server README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Openapi MCP Server listing page.
OpenAPI MCP Server
A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.
- Demo: https://x.com/janwilmake/status/1903497808134496583
- HN Thread: https://news.ycombinator.com/item?id=43447278
- OpenAPISearch: https://github.com/janwilmake/openapisearch
- OAPIS: https://github.com/janwilmake/oapis
The MCP works by applying a 3 step process:
- It figures out the openapi identifier you need
- It requests a summary of that in simple language
- It determines which endpoints you need, and checks out how exactly they work (again, in simple language)
Features
- Get an overview of any OpenAPI specification
- Retrieve details about specific API operations
- Support for both JSON and YAML formats
- Tested with Claude Desktop and Cursor
Installation
For other clients, use MCP URL: https://openapi-mcp.openapisearch.com/mcp
Local testing
First run the server
Then run the mcp inspector: