Forge Agent Gate MCP Server
by forgeorbitalcom.forgeorbital/agent-gatev0.1.5
Self-serve developer on-ramp to Forge Orbital: a local, deterministic mandate gate for AI agents that take consequential actions. Every allow and block is sent to Forge for a verifiable proof trail.
context tax
queued
security
queued
cold start
queued
freshness
Slowing3mo ago
Install Forge Agent Gate MCP server
Install in Claude Code
claude mcp add forge-agent-gate -e FORGE_API_KEY='<forge-api-key>' -e FORGE_BEARER_TOKEN='<forge-bearer-token>' -e FORGE_TENANT_ID='<forge-tenant-id>' -e KALSHI_API_KEY_ID='<kalshi-api-key-id>' -- npx -y forge-agent-gate serveInstall in Cursor
{
"mcpServers": {
"forge-agent-gate": {
"command": "npx",
"args": [
"-y",
"forge-agent-gate",
"serve"
],
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"forge-agent-gate": {
"command": "npx",
"args": [
"-y",
"forge-agent-gate",
"serve"
],
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"forge-agent-gate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"forge-agent-gate",
"serve"
],
"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 in your workspace.
Install in Windsurf
{
"mcpServers": {
"forge-agent-gate": {
"command": "npx",
"args": [
"-y",
"forge-agent-gate",
"serve"
],
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| FORGE_API_KEY | — | yes | Forge decision-API key (starts with fi_). Set this or FORGE_BEARER_TOKEN. |
| FORGE_BEARER_TOKEN | — | yes | 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 | yes | — | 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 | — | yes | 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. |
Freshness
Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.
Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-10 · 3mo ago · official registry · v0.1.5
FAQ
›How do I install the Forge Agent Gate MCP server in Claude Code?
Run: claude mcp add forge-agent-gate -e FORGE_API_KEY='<forge-api-key>' -e FORGE_BEARER_TOKEN='<forge-bearer-token>' -e FORGE_TENANT_ID='<forge-tenant-id>' -e KALSHI_API_KEY_ID='<kalshi-api-key-id>' -- npx -y forge-agent-gate serve. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Forge Agent Gate require an API key?
Yes. It expects FORGE_TENANT_ID, FORGE_API_KEY, FORGE_BEARER_TOKEN, KALSHI_API_KEY_ID, of which 3 are secrets.
›Can I use Forge Agent Gate as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Forge Agent Gate in the official MCP registry?
Yes, as com.forgeorbital/agent-gate.