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)
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
Our hosted smithery URL is https://smithery.ai/server/@janwilmake/openapi-mcp-server
To install openapi-mcp-server for Claude Desktop automatically via Smithery:
For other clients, see the smithery page for instructions.
Installing using stdio
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 -265
- 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 -91220MIT 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 -
- AsecurityFlicenseAqualityA Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.Last updated -74