kadykov/mcp-openapi-schema-explorer

No separate install needed for npx or Docker; the client downloads the package automatically
npm install -g mcp-openapi-schema-explorer for global install
git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git && npm install && npm run build for local build

Usage

• •Add a mcpServers entry using npx -y mcp-openapi-schema-explorer@latest <path-or-url-to-spec>
• •Use Docker: docker run --rm -i kadykov/mcp-openapi-schema-explorer:latest <spec>
• •Explore the spec via resource templates openapi://info, openapi://paths/{path}/{method}, openapi://components/{type}/{name}
• •Set --output-format to json, yaml or json-minified

Key features

• ✓Resource templates (not pre-enumerated resources) for token-efficient access to large specs
• ✓OpenAPI v3.0 and Swagger v2.0 support with automatic v2.0 to v3.0 conversion
• ✓Loads specs from local file paths or HTTP/HTTPS URLs
• ✓Multiple output formats, dynamic server name from info.title, and $ref transformation into clickable MCP URIs

Best for

Exploring large OpenAPI/Swagger specifications without loading the whole file into an LLM context window.

Caveats

• ⚠Provides resource templates only; resources/list returns an empty list by design
• ⚠Path and component names must be URL-encoded in template URIs
• ⚠Completions for component names are only provided when the spec has exactly one component type