---
slug: "openapi-openapi-mcp-generator"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/snaggle-ai/openapi-mcp-server@main/README.md"
repo: "https://github.com/snaggle-ai/openapi-mcp-server"
source_file: "README.md"
branch: "main"
---
# OpenAPI MCP Server

[![janwilmake/openapi-mcp-server context](https://badge.forgithub.com/janwilmake/openapi-mcp-server?excludePathPatterns=*.yaml)](https://uithub.com/janwilmake/openapi-mcp-server?excludePathPatterns=*.yaml)

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

## Installation

[![Install OpenAPI MCP Server](https://img.shields.io/badge/Install_MCP-OpenAPI%20MCP%20Server-1e3a8a?style=for-the-badge)](https://installthismcp.com/OpenAPI%20MCP%20Server?url=https%3A%2F%2Fopenapi-mcp.openapisearch.com%2Fmcp)

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
```