by agentgateway · agentgateway/agentgateway
Sit one proxy in front of all your MCP servers — pluggable auth, request shaping, observability, and circuit breakers in Rust.
Agent Gateway is a high-performance proxy specialized for MCP and LLM traffic. It terminates auth, applies per-route policy, emits traces, and provides circuit-breaking. Useful when you have more than two MCP servers and want central control.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"agentgateway": {
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"agentgateway": {
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"agentgateway": {
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"agentgateway": {
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "agentgateway",
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"agentgateway": {
"command": {
"path": "docker",
"args": [
"run",
"-p",
"3000:3000",
"ghcr.io/agentgateway/agentgateway:latest"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add agentgateway -- docker run -p 3000:3000 ghcr.io/agentgateway/agentgateway:latestOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You have 5+ internal MCPs and copying configs to every dev is painful.
Outcome: Central control plane for MCP traffic.
Use registry for discovery UI; this for low-latency routing
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| gateway-passthrough | (see docs) | Forwards to registered backend MCPs | 1 call |
gateway-adminexpose admin API publiclyHigh p99 latencyDisable unnecessary plugins; agentgateway is fast but plugins add up
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| mcp-context-forge | You want IBM's alternative | Different ops model |