docat0209 avatar

Openapi

docat0209/mcp-openapi

If you have an OpenAPI or Swagger spec, this turns it into MCP tools instantly. Point it at any spec URL and every endpoint becomes a callable tool for Claude. No code generation, no manual tool definitions. It flattens nested parameters into simple objects (which LLMs handle much better), handles auth (Bearer, API keys, OAuth2), and retries failed requests automatically. The examples show it working with Petstore, GitHub's API, and custom REST services. Useful when you want Claude to interact with any REST API without writing MCP server code yourself. Works especially well for large APIs since it can expose hundreds of endpoints as tools without bloating your config.

GitHub stars
3
tools
3
transport
STDIO
last updated
Mar 13, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

search_operationsSearch tools by keyword in names, descriptions, and tags.

Search tools by keyword in names, descriptions, and tags.

No parameter schema in public metadata yet.

list_by_tagBrowse tools by OpenAPI tag, or list all tags.

Browse tools by OpenAPI tag, or list all tags.

No parameter schema in public metadata yet.

get_tool_detailsGet full parameter schema for a specific tool.

Get full parameter schema for a specific tool.

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-openapi

Turn any OpenAPI/Swagger spec into MCP tools — so Claude and other AI assistants can call your REST APIs.

npm version License: MIT npm downloads

Point mcp-openapi at any OpenAPI 3.x or Swagger 2.0 spec URL and it generates Model Context Protocol (MCP) tools automatically. No code generation, no config files, no boilerplate. Your AI assistant gets callable tools for every API endpoint in seconds.


Quick Start

1. Run it (no install required):

npx mcp-openapi --spec https://petstore3.swagger.io/api/v3/openapi.json

2. Add it to Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "petstore": {
      "command": "npx",
      "args": [
        "mcp-openapi",
        "--spec", "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}

3. Ask Claude to use it:


View the full README on GitHub

Details

Repository
github.com/docat0209/mcp-openapi
Package
mcp-openapi
Transport
STDIO
Registry
MCP registry, active

More from docat0209