Openapi Spec

MCP server that turns any OpenAPI/Swagger spec into queryable tools for your LLM. Search endpoints, get endpoint details, and explore schemas from your API documentation.

Setup for Claude Code

Add to your .mcp.json, .claude.json or claude_desktop_config.json.

{
  "mcpServers": {
    "my-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/puelpan/openapi-spec-mcp.git@main",
        "openapi-spec-mcp",
        "/path/to/your/openapi.yaml"
      ]
    }
  }
}

Or use a remote URL:

{
  "mcpServers": {
    "my-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/puelpan/openapi-spec-mcp.git@main",
        "openapi-spec-mcp",
        "https://api.example.com/openapi.json"
      ]
    }
  }
}

Available Tools

• search_endpoints: Find endpoints by keyword
• get_endpoint: Get detailed endpoint info (parameters, responses, etc.)
• list_all_endpoints: List all available endpoints
• search_schemas: Find schema definitions by name
• get_schema: Get schema details with resolved references

Supported Formats

• Local files: .yaml, .yml, .json
• Remote URLs: Any OpenAPI spec URL (format auto-detected)