MCP Server

com.forgeorbital/agent-gate MCP Server

Name: com.forgeorbital/agent-gate MCP Server
Author: com.forgeorbital

com.forgeorbital/agent-gate

Registry

What is the com.forgeorbital/agent-gate MCP server?

Local mandate gate and proof trail for AI agents that take consequential actions.

How to install com.forgeorbital/agent-gate

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

FORGE_API_KEY
secret
Forge decision-API key (starts with fi_). Set this or FORGE_BEARER_TOKEN.
FORGE_BEARER_TOKEN
secret
Alternative to FORGE_API_KEY: a Forge bearer token for the decision API.
FORGE_API_BASE_URL
Base URL of the Forge decision API. Defaults to the hosted Forge cloud.
FORGE_TENANT_ID
required
Tenant id stamped into every proof-trail record.
FORGE_RECORD_MODE
required = fail-closed (block if Forge cannot record); best_effort = execute anyway.
AGENT_GATE_MANDATE_PATH
Absolute path to the signed mandate (policy) JSON. Create it with `forge-agent-gate init`.
AGENT_GATE_KILL_FILE
If this file exists, every gated write is hard-blocked (master kill switch).
KALSHI_API_KEY_ID
secret
Kalshi API key id. Only for the live Kalshi venue adapter; stays on your machine.
KALSHI_PRIVATE_KEY_PATH
Path to your Kalshi RSA private key. Only for the Kalshi venue adapter.
KALSHI_ENV
Kalshi environment: demo or prod. Only for the Kalshi venue adapter.

Claude Desktop

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

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate",
        "serve"
      ],
      "env": {
        "FORGE_API_KEY": "<YOUR_FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<YOUR_FORGE_BEARER_TOKEN>",
        "FORGE_API_BASE_URL": "<YOUR_FORGE_API_BASE_URL>",
        "FORGE_TENANT_ID": "<YOUR_FORGE_TENANT_ID>",
        "FORGE_RECORD_MODE": "<YOUR_FORGE_RECORD_MODE>",
        "AGENT_GATE_MANDATE_PATH": "<YOUR_AGENT_GATE_MANDATE_PATH>",
        "AGENT_GATE_KILL_FILE": "<YOUR_AGENT_GATE_KILL_FILE>",
        "KALSHI_API_KEY_ID": "<YOUR_KALSHI_API_KEY_ID>",
        "KALSHI_PRIVATE_KEY_PATH": "<YOUR_KALSHI_PRIVATE_KEY_PATH>",
        "KALSHI_ENV": "<YOUR_KALSHI_ENV>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate",
        "serve"
      ],
      "env": {
        "FORGE_API_KEY": "<YOUR_FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<YOUR_FORGE_BEARER_TOKEN>",
        "FORGE_API_BASE_URL": "<YOUR_FORGE_API_BASE_URL>",
        "FORGE_TENANT_ID": "<YOUR_FORGE_TENANT_ID>",
        "FORGE_RECORD_MODE": "<YOUR_FORGE_RECORD_MODE>",
        "AGENT_GATE_MANDATE_PATH": "<YOUR_AGENT_GATE_MANDATE_PATH>",
        "AGENT_GATE_KILL_FILE": "<YOUR_AGENT_GATE_KILL_FILE>",
        "KALSHI_API_KEY_ID": "<YOUR_KALSHI_API_KEY_ID>",
        "KALSHI_PRIVATE_KEY_PATH": "<YOUR_KALSHI_PRIVATE_KEY_PATH>",
        "KALSHI_ENV": "<YOUR_KALSHI_ENV>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate",
        "serve"
      ],
      "env": {
        "FORGE_API_KEY": "<YOUR_FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<YOUR_FORGE_BEARER_TOKEN>",
        "FORGE_API_BASE_URL": "<YOUR_FORGE_API_BASE_URL>",
        "FORGE_TENANT_ID": "<YOUR_FORGE_TENANT_ID>",
        "FORGE_RECORD_MODE": "<YOUR_FORGE_RECORD_MODE>",
        "AGENT_GATE_MANDATE_PATH": "<YOUR_AGENT_GATE_MANDATE_PATH>",
        "AGENT_GATE_KILL_FILE": "<YOUR_AGENT_GATE_KILL_FILE>",
        "KALSHI_API_KEY_ID": "<YOUR_KALSHI_API_KEY_ID>",
        "KALSHI_PRIVATE_KEY_PATH": "<YOUR_KALSHI_PRIVATE_KEY_PATH>",
        "KALSHI_ENV": "<YOUR_KALSHI_ENV>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "agent-gate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate",
        "serve"
      ],
      "env": {
        "FORGE_API_KEY": "<YOUR_FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<YOUR_FORGE_BEARER_TOKEN>",
        "FORGE_API_BASE_URL": "<YOUR_FORGE_API_BASE_URL>",
        "FORGE_TENANT_ID": "<YOUR_FORGE_TENANT_ID>",
        "FORGE_RECORD_MODE": "<YOUR_FORGE_RECORD_MODE>",
        "AGENT_GATE_MANDATE_PATH": "<YOUR_AGENT_GATE_MANDATE_PATH>",
        "AGENT_GATE_KILL_FILE": "<YOUR_AGENT_GATE_KILL_FILE>",
        "KALSHI_API_KEY_ID": "<YOUR_KALSHI_API_KEY_ID>",
        "KALSHI_PRIVATE_KEY_PATH": "<YOUR_KALSHI_PRIVATE_KEY_PATH>",
        "KALSHI_ENV": "<YOUR_KALSHI_ENV>"
      }
    }
  }
}

Claude Code

claude mcp add agent-gate --env FORGE_API_KEY=<YOUR_FORGE_API_KEY> --env FORGE_BEARER_TOKEN=<YOUR_FORGE_BEARER_TOKEN> --env FORGE_API_BASE_URL=<YOUR_FORGE_API_BASE_URL> --env FORGE_TENANT_ID=<YOUR_FORGE_TENANT_ID> --env FORGE_RECORD_MODE=<YOUR_FORGE_RECORD_MODE> --env AGENT_GATE_MANDATE_PATH=<YOUR_AGENT_GATE_MANDATE_PATH> --env AGENT_GATE_KILL_FILE=<YOUR_AGENT_GATE_KILL_FILE> --env KALSHI_API_KEY_ID=<YOUR_KALSHI_API_KEY_ID> --env KALSHI_PRIVATE_KEY_PATH=<YOUR_KALSHI_PRIVATE_KEY_PATH> --env KALSHI_ENV=<YOUR_KALSHI_ENV> -- npx -y forge-agent-gate serve