Model Context Protocol (MCP) server that lets Claude/Cursor search and explore OpenAPI specs via OpenAPISearch (oapis.org).
https://github.com/janwilmake/openapi-mcp-serverYou know the drill: you need to integrate with an API, so you open their OpenAPI spec and... it's 5,000 lines of YAML spanning 200+ endpoints. Now you're hunting through dense technical documentation just to figure out how to create a user or fetch some data.
The OpenAPI MCP Server solves this by giving Claude and Cursor the ability to understand any OpenAPI specification through natural language queries. Instead of parsing complex specs manually, you can ask direct questions and get actionable answers.
Today's APIs are comprehensive but overwhelming. The Stripe API has over 300 endpoints. GitHub's API spans thousands of operations. When you need to accomplish something specific, you're stuck with:
The OpenAPI MCP Server acts as an intelligent intermediary between you and complex API specifications. When you ask Claude "How do I create a repository with the GitHub API?", it:
No more digging through documentation—just direct answers to your integration questions.
API Integration Research: "Show me all the payment-related endpoints in the Stripe API"
Code Generation: "How do I authenticate with the Shopify Admin API?"
Architecture Planning: "What rate limits does the Twitter API have?"
Debugging: "What's the difference between GitHub's REST and GraphQL APIs for repository management?"
Quick setup via Smithery:
npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude
Direct installation:
npx openapi-mcp-server@latest init
Both methods configure Claude Desktop automatically—no manual JSON editing required.
This isn't just about reading documentation faster. It's about keeping your development flow intact. When you're deep in code and need to understand an API endpoint, you can ask Claude directly instead of:
The server handles both JSON and YAML formats and works with any publicly accessible OpenAPI specification. Whether you're working with established APIs like AWS or exploring a new service's endpoints, you get consistent, natural language answers.
Requirements: Node.js 16.17.0+ and Claude Desktop or Cursor. The server connects to OpenAPISearch's database, so you need an internet connection for API lookups.
The tool focuses on exploration and code generation rather than direct API execution—perfect for understanding how to build integrations without the complexity of handling authentication in the MCP layer.