Agent Gate

Official

by forgeorbital

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

Install

Configuration

Environment variables

FORGE_API_KEYsecret

Forge decision-API key (starts with fi_). Set this or FORGE_BEARER_TOKEN.

FORGE_BEARER_TOKENsecret

Alternative to FORGE_API_KEY: a Forge bearer token for the decision API.

FORGE_API_BASE_URLdefault https://forgeorbital.com

Base URL of the Forge decision API. Defaults to the hosted Forge cloud.

FORGE_TENANT_IDrequired

Tenant id stamped into every proof-trail record.

FORGE_RECORD_MODEdefault required

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_IDsecret

Kalshi API key id. Only for the live Kalshi venue adapter; stays on your machine.

KALSHI_PRIVATE_KEY_PATHdefault ./kalshi_private_key.pem

Path to your Kalshi RSA private key. Only for the Kalshi venue adapter.

KALSHI_ENVdefault demo

Kalshi environment: demo or prod. Only for the Kalshi venue adapter.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-gate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-agent-gate@0.1.5",
        "serve"
      ],
      "env": {
        "FORGE_API_KEY": "<YOUR_FORGE_API_KEY>",
        "FORGE_BEARER_TOKEN": "<YOUR_FORGE_BEARER_TOKEN>",
        "FORGE_API_BASE_URL": "https://forgeorbital.com",
        "FORGE_TENANT_ID": "<YOUR_FORGE_TENANT_ID>",
        "FORGE_RECORD_MODE": "required",
        "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": "./kalshi_private_key.pem",
        "KALSHI_ENV": "demo"
      }
    }
  }
}