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
Installation
Installing via Smithery
To install openapi-mcp-server for Claude Desktop automatically via Smithery:
Installing via npx
Run and follow instructions:
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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
This tool creates a Model Context Protocol (MCP) server that acts as a proxy for any API that has an OpenAPI v3.1 specification. This allows you to use Claude Desktop to easily interact with both local and remote server APIs.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -235TypeScript
- AsecurityFlicenseAqualityA server built on mcp-framework that enables integration with Claude Desktop through the Model Context Protocol.Last updated -11
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for Claude Desktop that connects to 302AI's API services, allowing users to integrate and leverage 302AI capabilities through a structured communication interface.Last updated -9818JavaScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that allows Claude AI to interact with custom tools, enabling extension of Claude's capabilities through the MCP framework.Last updated -TypeScript