MCP Server

Agent MCP Gateway MCP Server

Name: Agent MCP Gateway MCP Server
Author: io.github.roddutra

io.github.roddutra/agent-mcp-gateway

Repository Registry

What is the Agent MCP Gateway MCP server?

On-demand tool discovery for all your MCPs and per-subagent MCP controls to preserve context window.

How to install Agent MCP Gateway

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GATEWAY_MCP_CONFIG
Path to MCP servers configuration file (default: .mcp.json)
GATEWAY_RULES
Path to gateway access control rules file (default: .mcp-gateway-rules.json)
GATEWAY_DEFAULT_AGENT
Default agent ID when not provided in tool calls
GATEWAY_DEBUG
Enable debug mode and expose diagnostic tools (default: false)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agent-mcp-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "GATEWAY_MCP_CONFIG": "<YOUR_GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<YOUR_GATEWAY_RULES>",
        "GATEWAY_DEFAULT_AGENT": "<YOUR_GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_DEBUG": "<YOUR_GATEWAY_DEBUG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-mcp-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "GATEWAY_MCP_CONFIG": "<YOUR_GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<YOUR_GATEWAY_RULES>",
        "GATEWAY_DEFAULT_AGENT": "<YOUR_GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_DEBUG": "<YOUR_GATEWAY_DEBUG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-mcp-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "GATEWAY_MCP_CONFIG": "<YOUR_GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<YOUR_GATEWAY_RULES>",
        "GATEWAY_DEFAULT_AGENT": "<YOUR_GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_DEBUG": "<YOUR_GATEWAY_DEBUG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "agent-mcp-gateway": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "GATEWAY_MCP_CONFIG": "<YOUR_GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<YOUR_GATEWAY_RULES>",
        "GATEWAY_DEFAULT_AGENT": "<YOUR_GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_DEBUG": "<YOUR_GATEWAY_DEBUG>"
      }
    }
  }
}

Claude Code

claude mcp add agent-mcp-gateway --env GATEWAY_MCP_CONFIG=<YOUR_GATEWAY_MCP_CONFIG> --env GATEWAY_RULES=<YOUR_GATEWAY_RULES> --env GATEWAY_DEFAULT_AGENT=<YOUR_GATEWAY_DEFAULT_AGENT> --env GATEWAY_DEBUG=<YOUR_GATEWAY_DEBUG> -- uvx agent-mcp-gateway