Back to Catalog
openapi-mcp-server
snaggle-ai/openapi-mcp-server
🔗 Latest commit:df55b32
🕒 Updated:Sep 9, 2025, 01:05 PM
JavaScript
AI Tools
Allow AI to wade through complex OpenAPIs using Simple Language
MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score63/100
- • Core MCP protocol features implemented (20/40)
- • GitHub community is not mature yet (12/20)
- • Optimal dependency management (20/20)
- • Moderate deployment maturity (5/10)
- • Documentation (8/8)
- • Archestra MCP Trust score badge is missing
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:803
👥 Contributors:6
📋 Total Issues:0
📦 Has Releases:Yes
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
"openapi-mcp-server": {
"command": "npx",
"args": [
"openapi-mcp-server@latest",
"init"
],
"env": {}
}
}MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✓
Prompts:✗
Resources:✓
Sampling:✗
Roots:✗
Logging:✗
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
4 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
README.md
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:
npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude
For other clients, see the smithery page for instructions.
Installing using stdio
{
"mcpServers": {
"openapi-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/openapi-mcp-server/index.js"],
"env": {
"DEBUG": "true"
}
}
}
}
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
Resources
Add Quality Badge
Show your MCP trust score in your README
[](https://archestra.ai/mcp-catalog/snaggle-ai__openapi-mcp-server)README.md
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:
npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude
For other clients, see the smithery page for instructions.
Installing using stdio
{
"mcpServers": {
"openapi-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/openapi-mcp-server/index.js"],
"env": {
"DEBUG": "true"
}
}
}
}
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