Explore and Summarize OpenAPI Specs
Search and explore OpenAPI specifications with this MCP server for Claude/Cursor, enabling AI to understand API details.
1.2.0-beta04Add to Favorites
Why it matters
Effortlessly search and understand complex OpenAPI specifications. This asset provides plain-language summaries and detailed operation information, making API exploration intuitive.
Outcomes
What it gets done
Identify and retrieve OpenAPI specifications.
Generate concise summaries of API functionalities.
Extract detailed information about specific API endpoints.
Support for both JSON and YAML OpenAPI formats.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-openapi | bash Capabilities
Tools your agent gets
Search and explore OpenAPI specifications through oapis.org
Get a plain-language summary of any OpenAPI specification
Extract details about specific API operations from OpenAPI specs
Overview
OpenAPI MCP Server
This MCP server allows for searching and exploring OpenAPI specifications. This MCP server is useful for AI clients like Claude and Cursor that need to understand API details.
What it does
A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.
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
For local testing, first run the server:
wrangler dev
Then run the mcp inspector:
npx @modelcontextprotocol/inspector
Source 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)
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
For other clients, use MCP URL: https://openapi-mcp.openapisearch.com/mcp
Local testing
First run the server
wrangler dev
Then run the mcp inspector:
npx @modelcontextprotocol/inspector
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.