openapi-spec-mcp

puelpan/openapi-spec-mcp

3.2

If you are the rightful owner of openapi-spec-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The OpenAPI MCP Server provides tools for querying and exploring OpenAPI specifications, allowing users to search, retrieve, and list API endpoints.

Tools
3
Resources
0
Prompts
0

OpenAPI MCP Server

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)