OpenAPI MCP Server
by
Provides a way to navigate complex OpenAPI specifications using simple language, enabling AI models to understand and explore APIs without writing code.
OpenAPI MCP Server Overview
What is OpenAPI MCP Server about?
The project offers a Model Context Protocol (MCP) server that lets Claude, Cursor and other MCP‑compatible clients fetch high‑level overviews and detailed, plain‑language explanations of any OpenAPI specification hosted on oapis.org.
How to use OpenAPI MCP Server?
- Install the server via npx:
npx openapi-mcp-server@latest init - Once the server is running, ask your Claude or Cursor client to “find information about the Stripe API” or any other API.
- The client will call the MCP server, which first returns a simple summary of the API and then provides operation‑level details on demand.
Key features of OpenAPI MCP Server
- Retrieves a concise, natural‑language overview of any OpenAPI spec (JSON or YAML).
- Supplies plain‑language descriptions of individual endpoints and their parameters.
- Works with Claude Desktop, Cursor, and any MCP‑compatible client.
- Supports both JSON and YAML formats.
- Designed for code generation use‑cases rather than direct endpoint execution.
Use cases of OpenAPI MCP Server
- AI‑assisted documentation: Let large language models explain third‑party APIs to users in everyday language.
- Rapid prototyping: Developers can quickly understand required request structures before writing code.
- Code generation assistance: Feed the plain‑language summaries into code generators to scaffold client libraries.
- Education & onboarding: Teach newcomers how REST APIs are structured without exposing raw OpenAPI files.
FAQ from the OpenAPI MCP Server
- Can the server execute API calls? No. Authentication and execution are not handled; the server only provides contextual information.
- Is there a stable version? v2 is a work‑in‑progress; earlier v1.x versions are still accessible via the legacy README.
- What Node.js version is required? Node.js ≥ 16.17.0.
- How do I contribute? Open a pull request on GitHub or DM the maintainer on X.
- Is the server open‑source? Yes, it is released under the MIT license.
OpenAPI MCP Server's README
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)
[!IMPORTANT] OpenAPI MCP has found a new owner and has been migrated from v1.2 to v2, which works different to the previous version. You can still access any version prior to v2.0.0 and their README is here
OpenAPI MCP v2 is a Work In Progress and focuses on exploration and providing context about APIs. It does not allow executing the endpoints as tools directly, as authentication isn't a solved problem with MCP yet. However, it's great for codegen!
Expect bugs. Open To Contributers, DM
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
| Summary | Prompt it |
|---|---|
| Basic understanding of the OpenAPI MCP Server |  |
| Core implementation details of the MCP server | |
| How to extend or contribute to the project |
Installation
Installing via Smithery
To install openapi-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude
Installing via npx
Run and follow instructions:
npx openapi-mcp-server@latest init
Usage in Claude
Once installed, you can ask Claude to:
- "Find information about the Stripe API"
- "Explain how to use the GitHub API's repository endpoints"
Claude will use the MCP server to:
- First get an overview of the requested API
- Then retrieve specific operation details as needed
Requirements
- Node.js >= 16.17.0
- Claude Desktop, Cursor, or any other MCP client.
License
MIT
OpenAPI MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
OpenAPI MCP Server's Information
- Author
- janwilmake
- Category
- Development Tools
- Language
- JavaScript
- License
- MIT License
- Version
- v2.0.3
- Stars
- 778
- Updated
- 21 days ago
Configuration
{
"mcpServers": {
"openapi-mcp": {
"command": "npx",
"args": [
"openapi-mcp-server@latest",
"init"
],
"env": {}
}
}
}Configure Clients
Similar MCP Servers like OpenAPI MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Zed
OfficialClientby zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
Everything
Officialby modelcontextprotocol
Model Context Protocol Servers
Git
Officialby modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
Time
Officialby modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
Cline
OfficialClientby cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
Continue
OfficialClientby continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
Context7 MCP
Officialby upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
GitHub MCP Server
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.
Daytona
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.