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 :

1. It figures out the openapi identifier you need
2. It requests a summary of that in simple language
3. 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

Summary	Prompt it
Basic understanding of the OpenAPI MCP Server
Core implementation details of the MCP server
How to extend or contribute to the project

Installation

Installing via Smithery

Our hosted smithery URL is https://smithery.ai/server/@janwilmake/openapi-mcp-server

To install openapi-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude

For other clients, see the smithery page for instructions.

Installing using stdio

{
  "mcpServers": {
    "openapi-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/openapi-mcp-server/index.js"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Usage in Claude

Once installed, you can ask Claude to:

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

Claude will use the MCP server to:

1. First get an overview of the requested API
2. Then retrieve specific operation details as needed

Requirements

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

License

MIT