API Gateway — Claude Code MCP server for API access
API Gateway turns a Swagger/OpenAPI spec into tools an MCP client can use to call an API. Connect it when you want to work with an API from Claude Code or another supported client.
no license updated 2026-10-29
Open on GitHubWhat API Gateway does
The server builds tools from a Swagger/OpenAPI specification. Environment variables set the API name and spec URL; you can also provide a base URL and authorization headers. A single server configuration can cover multiple APIs.
For large APIs, group tools by resource or tag, use compact schemas, and filter paths or parameters. Set these options with API_N_TOOL_MODE, API_N_SCHEMA_MODE, and related variables. The Docker setup needs a spec URL, since that is what the server uses to create its tools.
The project describes installation through Docker MCP Toolkit, Docker Hub, npx, or a local build. Its Docker Hub example uses claude_desktop_config.json, so Claude Code users will need to connect the MCP server through their client configuration.
What it helps with
- generate API tools from an OpenAPI spec
- connect several APIs through one MCP server
- send API authorization headers with requests
- group tools for a large API
- filter which API paths and parameters are exposed
Example prompts for the agent
- Call the users API and show active accounts.
- Fetch order details from the connected API.
- Send a request to the products API with its authorization header.
How to install API Gateway
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about API Gateway
How do I install API Gateway in Claude Code?
The documented Docker Hub setup is written for claude_desktop_config.json. To run the container, set API_1_NAME and API_1_SWAGGER_URL, add an authorization header if needed, then use rflpazini/mcp-api-gateway:latest. The project also offers Docker MCP Toolkit, npx, and a local build.
What does API Gateway do?
It reads a Swagger/OpenAPI spec and creates MCP tools for calling the described API. Configuration can include headers, a base URL, and multiple APIs.
How can I reduce the tool list for a large API?
Set API_N_TOOL_MODE=grouped to organize tools by resource or tag. You can also use API_N_SCHEMA_MODE=compact and narrow the paths with API_N_PATH_PREFIX.