OpenAPI MCP Server

An MCP server for Claude/Cursor, enabling OpenAPI specification search and exploration via 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 operates in three steps: identifying the required OpenAPI specification, requesting a simplified summary, and determining/explaining relevant endpoints.

[!IMPORTANT]
OpenAPI MCP has a new owner and has been migrated to v2, which works differently than previous versions. Access older versions and their README here. v2 is a Work In Progress focused on API exploration and context, not direct endpoint execution due to authentication challenges. It's ideal for codegen. Expect bugs. Open To Contributers, DM

Features

• OpenAPI specification overview
• Specific API operation details retrieval
• JSON and YAML support
• Tested with Claude Desktop and Cursor

Installation

Run:

npx openapi-mcp-server init

Usage in Claude

Ask Claude to:

• "Find information about the Stripe API"
• "Explain how to use the GitHub API's repository endpoints"

Claude uses the MCP server to get an API overview and retrieve operation details.

Requirements

• Node.js >= 16.17.0
• Claude Desktop, Cursor, or any MCP client.

License

MIT