Openapi MCP Server README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the Openapi MCP Server listing page.

Back to Openapi MCP Server View source on GitHub

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

Terminal

wrangler dev

Then run the mcp inspector:

Terminal

npx @modelcontextprotocol/inspector