OpenAPI
Powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). Automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop.
What is OpenAPI?
OpenAPI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful bridge between openapi specifications and ai assistants using the model context protocol (mcp). automatically converts any openapi/swagger api specification into mcp tools that can be used by...
Powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). Automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop.
This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Powerful bridge between OpenAPI specifications and AI assist
Use Cases
Maintainer
Works with
Installation
NPM
npx -y openapi-mcpManual Installation
npx -y openapi-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OpenAPI
OpenAPI MCP Server is a TypeScript bridge that converts any OpenAPI or Swagger API specification into a set of MCP tools, enabling AI assistants like Claude, Cursor, ChatGPT, Gemini, and others to discover, understand, and call real API endpoints through natural language. It implements a three-step workflow — identify the OpenAPI spec, retrieve a plain-language summary, and resolve the exact endpoint details — so that even complex API documentation becomes navigable by an AI without manual tool wiring. The server runs as a Cloudflare Worker with a hosted endpoint at openapi-mcp.openapisearch.com, or locally via Wrangler for development.
Prerequisites
- Node.js 18+ and npx (for local development with Wrangler)
- A Cloudflare account (if deploying your own worker instance)
- An MCP-compatible client such as Claude Desktop or Cursor
- The OpenAPI or Swagger specification URL or identifier you want to expose as tools
Use the hosted endpoint (quickest start)
The server is already deployed at a public URL. Add it as an MCP server using the remote HTTP endpoint — no local installation required.
# Add the hosted MCP server URL to your client:
# https://openapi-mcp.openapisearch.com/mcpConfigure your MCP client with the hosted URL
Add the remote endpoint to your MCP client configuration. Use the HTTP transport and point to the hosted Cloudflare Worker.
{
"mcpServers": {
"openapi": {
"command": "npx",
"args": ["-y", "openapi-mcp"],
"env": {
"OPENAPI_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
}
}
}
}Install for local development (optional)
Clone the repository and install dependencies for local testing or customizing the Cloudflare Worker.
git clone https://github.com/janwilmake/openapi-mcp-server.git
cd openapi-mcp-server
npm installRun locally with Wrangler
Start the local development server using the Wrangler CLI. The MCP server will be accessible at localhost.
wrangler devInspect and test tools
Use the MCP Inspector to browse the tools exposed from your OpenAPI specification and test them before connecting to an AI client.
npx @modelcontextprotocol/inspectorOpenAPI Examples
Client configuration
Point the openapi-mcp package at a specific OpenAPI specification file or URL via the OPENAPI_SPEC_URL environment variable.
{
"mcpServers": {
"openapi": {
"command": "npx",
"args": ["-y", "openapi-mcp"],
"env": {
"OPENAPI_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
}
}
}
}Prompts to try
Once the server is connected and pointed at an OpenAPI spec, use natural language to explore and call APIs.
- "Give me an overview of what the Petstore API can do"
- "List all available endpoints in this OpenAPI specification"
- "Call the GET /pets endpoint and show me the first 5 results"
- "What parameters does the POST /users endpoint require?"Troubleshooting OpenAPI
The server returns an error when loading a private or internal OpenAPI spec URL
The hosted Cloudflare Worker at openapi-mcp.openapisearch.com can only reach publicly accessible URLs. For private specs, run the server locally with 'wrangler dev' and pass an internal URL or local file path.
Tools generated from the spec have incorrect or missing parameters
Validate your OpenAPI specification with a linter like Spectral ('npx @stoplight/spectral-cli lint openapi.yaml'). The server converts the spec as-is, so invalid or incomplete specs produce incomplete tools.
npx openapi-mcp does not connect to the correct spec
Ensure the OPENAPI_SPEC_URL environment variable is set in your MCP client config to the full URL of the spec. If the variable is missing, the server may fall back to a default or return no tools.
Frequently Asked Questions about OpenAPI
What is OpenAPI?
OpenAPI is a Model Context Protocol (MCP) server that powerful bridge between openapi specifications and ai assistants using the model context protocol (mcp). automatically converts any openapi/swagger api specification into mcp tools that can be used by ai assistants like claude desktop. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OpenAPI?
Install via npm with the command: npx -y openapi-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with OpenAPI?
OpenAPI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OpenAPI free to use?
Yes, OpenAPI is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
OpenAPI Alternatives — Similar APIs Servers
Looking for alternatives to OpenAPI? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up OpenAPI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OpenAPI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.