Agent MCP Gateway

Name: Agent MCP Gateway
Author: roddutra

roddutra

Proxies all configured MCP servers behind three tools, with per-subagent access controls so agents load only the tools they need.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add agent-gateway --env BRAVE_API_KEY='<BRAVE_API_KEY>' --env DATABASE_URL='<DATABASE_URL>' --env GATEWAY_DEFAULT_AGENT='<GATEWAY_DEFAULT_AGENT>' --env GATEWAY_MCP_CONFIG='<GATEWAY_MCP_CONFIG>' --env GATEWAY_RULES='<GATEWAY_RULES>' -- uvx agent-mcp-gateway

~/.codex/config.toml

[mcp_servers.agent-gateway]
command = "uvx"
args = ["agent-mcp-gateway"]
env = { BRAVE_API_KEY = "<BRAVE_API_KEY>", DATABASE_URL = "<DATABASE_URL>", GATEWAY_DEFAULT_AGENT = "<GATEWAY_DEFAULT_AGENT>", GATEWAY_MCP_CONFIG = "<GATEWAY_MCP_CONFIG>", GATEWAY_RULES = "<GATEWAY_RULES>" }

# codex mcp add agent-gateway --env BRAVE_API_KEY='<BRAVE_API_KEY>' --env DATABASE_URL='<DATABASE_URL>' --env GATEWAY_DEFAULT_AGENT='<GATEWAY_DEFAULT_AGENT>' --env GATEWAY_MCP_CONFIG='<GATEWAY_MCP_CONFIG>' --env GATEWAY_RULES='<GATEWAY_RULES>' -- uvx agent-mcp-gateway

~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "BRAVE_API_KEY": "<BRAVE_API_KEY>",
        "DATABASE_URL": "<DATABASE_URL>",
        "GATEWAY_DEFAULT_AGENT": "<GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_MCP_CONFIG": "<GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<GATEWAY_RULES>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "agent-gateway": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "BRAVE_API_KEY": "<BRAVE_API_KEY>",
        "DATABASE_URL": "<DATABASE_URL>",
        "GATEWAY_DEFAULT_AGENT": "<GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_MCP_CONFIG": "<GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<GATEWAY_RULES>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "agent-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "BRAVE_API_KEY": "<BRAVE_API_KEY>",
        "DATABASE_URL": "<DATABASE_URL>",
        "GATEWAY_DEFAULT_AGENT": "<GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_MCP_CONFIG": "<GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<GATEWAY_RULES>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "agent-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "BRAVE_API_KEY": "<BRAVE_API_KEY>",
        "DATABASE_URL": "<DATABASE_URL>",
        "GATEWAY_DEFAULT_AGENT": "<GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_MCP_CONFIG": "<GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<GATEWAY_RULES>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "agent-gateway": {
      "command": "uvx",
      "args": [
        "agent-mcp-gateway"
      ],
      "env": {
        "BRAVE_API_KEY": "<BRAVE_API_KEY>",
        "DATABASE_URL": "<DATABASE_URL>",
        "GATEWAY_DEFAULT_AGENT": "<GATEWAY_DEFAULT_AGENT>",
        "GATEWAY_MCP_CONFIG": "<GATEWAY_MCP_CONFIG>",
        "GATEWAY_RULES": "<GATEWAY_RULES>"
      }
    }
  }
}

Environment variables

BRAVE_API_KEY
DATABASE_URL
GATEWAY_DEFAULT_AGENT
GATEWAY_MCP_CONFIG
GATEWAY_RULES

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related