OpenAPI MCP Server

Search and explore any OpenAPI spec in simple language, via oapis.org.

Unverified

HTTP (remote)

No auth

TypeScript

View repo 895 Website

Add to your client

Copy the config for your MCP client and paste it into its config file.

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openapi-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://openapi-mcp.openapisearch.com/mcp"
      ]
    }
  }
}

Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

An MCP-compatible client (e.g. Claude Desktop or Cursor)
Network access to the hosted endpoint https://openapi-mcp.openapisearch.com/mcp

About OpenAPI MCP Server

OpenAPI MCP Server is a hosted MCP server that helps an AI client (Claude Desktop, Cursor, or any MCP client) understand large OpenAPI specifications. Instead of feeding a full spec into the model, it identifies the relevant OpenAPI, summarizes it in plain language, and then explains the specific endpoints the task requires. It is powered by oapis.org and the OpenAPISearch project, supports both JSON and YAML specs, and is exposed at a public MCP URL so no local install is required.

Tools & capabilities (2)

OpenAPI overview

Get a plain-language overview/summary of a given OpenAPI specification (resolved from an OpenAPI identifier).

Operation details

Retrieve details about specific API operations/endpoints from a spec, explained in simple language, for both JSON and YAML formats.

When to use it

Letting an AI assistant work against a large third-party API without loading the entire OpenAPI spec into context
Getting a quick plain-language summary of an unfamiliar API
Looking up exactly how a specific endpoint works while coding in Cursor or Claude

Security notes

Hosted, remote MCP server: requests for OpenAPI specs are processed via the oapis.org / openapisearch.com service rather than locally. No authentication is documented for the public MCP endpoint.

OpenAPI MCP Server FAQ

Do I need to install anything locally?

No. It is a hosted remote MCP server. Point your client at the MCP URL https://openapi-mcp.openapisearch.com/mcp, or use the install link in the README.

Which clients are supported?

The README states it has been tested with Claude Desktop and Cursor, and notes that other clients can use the same MCP URL.

Can I run it myself?

Yes. The repo supports local testing with `wrangler dev` (it is a Cloudflare Worker) and the MCP inspector via `npx @modelcontextprotocol/inspector`.

#openapi #swagger #api #rest #specification #remote-mcp

Alternatives to OpenAPI MCP Server

Compare all alternatives →

Playwright MCP Server

Developer Tools

24k

Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).

Featured

Verified

stdio (local)

No auth

TypeScript

12 tools

Updated 13 days agoRepo

Context7 MCP Server

Developer Tools

28k

Up-to-date, version-specific library documentation injected into your coding agent.

Verified

stdio (local)

API key

TypeScript

2 tools

Updated 17 days agoRepo

Serena

Developer Tools

12k

LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.

Verified

stdio (local)

No auth

Python

11 tools

Updated 15 days agoRepo

Compare OpenAPI MCP Server with:

vs Playwright MCP Server vs Context7 MCP Server vs Serena vs Mobile MCP