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

wrangler dev

Then run the mcp inspector:

npx @modelcontextprotocol/inspector

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). Connect directly and complete any provider authentication separately; this is not platform-key access.

Tool

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.

Discover MCPs & agents

openapi-mcp-server

Your workspace

Documentation

OpenAPI MCP Server

Installation

Local testing

Links

Collected info

Config for your environment