About OpenAPI MCP Server
OpenAPI MCP Server is an MCP server that lets clients such as Claude and Cursor search and explore OpenAPI specifications. It retrieves specifications through oapis.org and presents them in simple language, which helps developers working with complex APIs.
Key features
- 01Search OpenAPI specifications
- 02Get an overview of a specification
- 03Retrieve details for specific API operations
- 04Support for JSON and YAML formats
Use cases
- 01Quickly understanding a third-party API structure while coding
- 02Finding endpoints for a specific task within an API
MCP support
This project is an MCP server that gives MCP clients such as Claude Desktop and Cursor the ability to query and browse OpenAPI specifications. A remote endpoint is available at https://openapi-mcp.openapisearch.com/mcp.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://openapi-mcp.openapisearch.com/mcpclaude mcp add --transport http openapi https://openapi-mcp.openapisearch.com/mcp{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}Open in Cursor{"servers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}Open in VS Code{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}{"mcpServers":{"openapi":{"serverUrl":"https://openapi-mcp.openapisearch.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | API identifier, can be a known ID from openapisearch.com or a URL leading to a raw OpenAPI file |
Details
From the project READMEOpenAPI 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
wrangler dev
Then run the mcp inspector:
npx @modelcontextprotocol/inspector
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.