Skip to content
MCP server

Agent Gate

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

Runs locallyStatus and history
Install
Runs
Locally
Version
0.1.5
Listing updated
6 days ago

About Agent Gate

Agent Gate is an MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add agent-gate --env FORGE_API_KEY='<FORGE_API_KEY>' --env FORGE_BEARER_TOKEN='<FORGE_BEARER_TOKEN>' --env FORGE_TENANT_ID='<FORGE_TENANT_ID>' --env KALSHI_API_KEY_ID='<KALSHI_API_KEY_ID>' -- npx -y forge-agent-gate

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate"
      ],
      "env": {
        "FORGE_API_KEY": "<FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<FORGE_BEARER_TOKEN>",
        "FORGE_TENANT_ID": "<FORGE_TENANT_ID>",
        "KALSHI_API_KEY_ID": "<KALSHI_API_KEY_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate"
      ],
      "env": {
        "FORGE_API_KEY": "<FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<FORGE_BEARER_TOKEN>",
        "FORGE_TENANT_ID": "<FORGE_TENANT_ID>",
        "KALSHI_API_KEY_ID": "<KALSHI_API_KEY_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "agent-gate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate"
      ],
      "env": {
        "FORGE_API_KEY": "<FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<FORGE_BEARER_TOKEN>",
        "FORGE_TENANT_ID": "<FORGE_TENANT_ID>",
        "KALSHI_API_KEY_ID": "<KALSHI_API_KEY_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate"
      ],
      "env": {
        "FORGE_API_KEY": "<FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<FORGE_BEARER_TOKEN>",
        "FORGE_TENANT_ID": "<FORGE_TENANT_ID>",
        "KALSHI_API_KEY_ID": "<KALSHI_API_KEY_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate"
      ],
      "env": {
        "FORGE_API_KEY": "<FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<FORGE_BEARER_TOKEN>",
        "FORGE_TENANT_ID": "<FORGE_TENANT_ID>",
        "KALSHI_API_KEY_ID": "<KALSHI_API_KEY_ID>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FORGE_API_KEYForge decision-API key (starts with fi_). Set this or FORGE_BEARER_TOKEN.
  • FORGE_BEARER_TOKENAlternative to FORGE_API_KEY: a Forge bearer token for the decision API.
  • FORGE_API_BASE_URLBase URL of the Forge decision API. Defaults to the hosted Forge cloud.
  • FORGE_TENANT_IDTenant id stamped into every proof-trail record.Required
  • FORGE_RECORD_MODErequired = fail-closed (block if Forge cannot record); best_effort = execute anyway.
  • AGENT_GATE_MANDATE_PATHAbsolute path to the signed mandate (policy) JSON. Create it with `forge-agent-gate init`.
  • AGENT_GATE_KILL_FILEIf this file exists, every gated write is hard-blocked (master kill switch).
  • KALSHI_API_KEY_IDKalshi API key id. Only for the live Kalshi venue adapter; stays on your machine.
  • KALSHI_PRIVATE_KEY_PATHPath to your Kalshi RSA private key. Only for the Kalshi venue adapter.
  • KALSHI_ENVKalshi environment: demo or prod. Only for the Kalshi venue adapter.

Agent Gate FAQ

How do I add Agent Gate to Claude Code?

Run this command in your terminal: claude mcp add agent-gate --env FORGE_API_KEY='<FORGE_API_KEY>' --env FORGE_BEARER_TOKEN='<FORGE_BEARER_TOKEN>' --env FORGE_TENANT_ID='<FORGE_TENANT_ID>' --env KALSHI_API_KEY_ID='<KALSHI_API_KEY_ID>' -- npx -y forge-agent-gate

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers