Overview
What is OpenAPI MCP Server?
A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.
How to use OpenAPI MCP Server?
Install via Smithery (npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude) or via npx (npx openapi-mcp-server@latest init). Once installed, ask Claude to find information about an API or explain how to use specific endpoints.
Key features of OpenAPI MCP Server
- 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
- Works via a three-step process: identify API, request summary, check endpoints
Use cases of OpenAPI MCP Server
- Ask Claude to find information about the Stripe API
- Ask Claude to explain how to use the GitHub API's repository endpoints
- Code generation by exploring API specifications
FAQ from OpenAPI MCP Server
What are the runtime requirements?
Node.js >= 16.17.0 and an MCP client such as Claude Desktop or Cursor.
Does the server execute API endpoints as tools?
No. OpenAPI MCP v2 focuses on exploration and providing context; it does not allow executing endpoints directly because authentication is not yet solved.
Where does the data come from?
The server searches and explores OpenAPI specifications through oapis.org.
What transports / authentication does it use?
The README does not detail specific transports; it notes that authentication for endpoint execution is not yet solved with MCP.
Is this version stable?
It is a Work In Progress. Expect bugs and contributions are welcome.
