MCP OpenAPI Schema Explorer

What it does

This server provides a structured way for AI models to explore large API specifications (OpenAPI v3.0 and Swagger v2.0) without overloading the context window. Instead of reading the whole spec, it uses MCP Resource Templates to allow the AI to request specific paths, components, or info sections on demand.

Tools

This server primarily utilizes Resource Templates rather than executable tools. It exposes the following URI patterns:

• openapi://{field}: Access top-level fields like info or servers.
• openapi://paths/{path}: List available HTTP methods for a specific encoded path.
• openapi://paths/{path}/{method*}: Get detailed specs for one or more operations on a path.
• openapi://components/{type}: List component types (e.g., schemas).
• openapi://components/{type}/{name*}: Get detailed specs for specific named components.

Installation

Add the following to your claude_desktop_config.json (replace <path-or-url-to-spec> with your API spec):

{
  "mcpServers": {
    "openapi-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ]
    }
  }
}

Supported hosts

• Claude Desktop
• Windsurf
• Cline
• Claude Code