Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open