A
licenseA
qualityA
maintenanceMCP server that helps AI agents explore OpenAPI specs, search endpoints, and generate TypeScript types.
7
62 npm
10
MIT
openapi-mcp
by ceski23
Provides tools to load and explore OpenAPI/Swagger specifications, including searching endpoints, inspecting schemas, and retrieving operations from a given API spec.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@openapi-mcpload the Petstore API spec"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
OpenAPI MCP
MCP server for loading and exploring OpenAPI/Swagger specifications. Lets AI assistants browse API contracts dynamically — load any OpenAPI spec, search endpoints, inspect schemas, retrieve operations, diff versions — all through MCP tools.
Usage
Prerequisites
Node.js >= 22 or Bun >= 1.0
oasdiff (optional) — required only for the
diff_specstool. Install from github.com/oasdiff/oasdiff.
Manually
Add to your MCP client config:
{
"mcpServers": {
"openapi-mcp": {
"command": "npx",
"args": ["-y", "@ceski23/openapi-mcp"]
}
}
}Via AI agent
Ask your AI assistant to add it:
Add the MCP server
@ceski23/openapi-mcpto my config. Run it withnpx -y @ceski23/openapi-mcpvia stdio.
Most assistants can modify your MCP config file directly.
Related MCP server: api-mind
Tools
Tool | Description |
| Load an OpenAPI/Swagger spec from a URL or local file path. Parses and validates the spec, returns a |
| Search operations in a loaded spec by operationId, path, summary, tags, or description. Supports filtering by HTTP method and tags, with pagination. |
| Get full details for a single operation by operationId — method, path, parameters, requestBody, and responses. |
| Get all HTTP methods defined on a specific path. Returns a summary of each method. |
| Search component/definition schema names in a loaded spec. Supports pagination. |
| Retrieve a fully dereferenced component/definition schema by name. |
| Search both operations and schemas in a single call — matches against operationIds, summaries, tags, paths, schema names, schema descriptions, property names, and enum values. The best first call when exploring an API. |
| Compare two loaded OpenAPI specs. Supports summary, detailed (JSON), and markdown changelog output. Requires |
| List all currently cached specs with their specIds, sources, titles, and versions. |
| List all cached versions for a specId (tracked across repeated loads of the same source). |
| Remove a loaded spec (and its version history) from the cache by specId. |
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo issues
Related MCP Connectors
MCP server for AI access to Swagger by SmartBear.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for API discovery from .mind spec files, enabling AI assistants to list, inspect, and call APIs defined in OpenAPI specs.49 npmMIT
- AlicenseNot gradedqualityCmaintenanceA generic MCP server that converts any OpenAPI/Swagger specification into MCP tools, enabling AI assistants to search, explore, and execute REST APIs.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to explore, search, and query API definitions from OpenAPI/Swagger JSON files.14 npmMIT