IRL Gateway MCP Server

by horkos-labsio.github.horkos-labs/irl-gatewayv0.2.1

An AI agent's trading mandate it can't break: checked before every order, reasoning sealed in IRL.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Deprecated2d ago

Install IRL Gateway MCP server

claude mcp add irl-gateway -e IRL_BASE_URL='<irl-base-url>' -e IRL_API_TOKEN='<irl-api-token>' -e IRL_AGENT_ID='<irl-agent-id>' -e IRL_MODEL_HASH='<irl-model-hash>' -- uvx irl-gateway

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_BASE_URL": "<irl-base-url>",
        "IRL_API_TOKEN": "<irl-api-token>",
        "IRL_AGENT_ID": "<irl-agent-id>",
        "IRL_MODEL_HASH": "<irl-model-hash>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_BASE_URL": "<irl-base-url>",
        "IRL_API_TOKEN": "<irl-api-token>",
        "IRL_AGENT_ID": "<irl-agent-id>",
        "IRL_MODEL_HASH": "<irl-model-hash>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "irl-gateway": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_BASE_URL": "<irl-base-url>",
        "IRL_API_TOKEN": "<irl-api-token>",
        "IRL_AGENT_ID": "<irl-agent-id>",
        "IRL_MODEL_HASH": "<irl-model-hash>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_BASE_URL": "<irl-base-url>",
        "IRL_API_TOKEN": "<irl-api-token>",
        "IRL_AGENT_ID": "<irl-agent-id>",
        "IRL_MODEL_HASH": "<irl-model-hash>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
IRL_BASE_URL	yes	—	Your IRL server, e.g. https://irl.example.com
IRL_API_TOKEN	yes	yes	Bearer token for the IRL server
IRL_AGENT_ID	yes	—	The agent registered on IRL (its mandate)
IRL_MODEL_HASH	yes	—	The model hash the agent was registered with (64 hex)
GATEWAY_BROKER	—	—	paper (default, live prices, no keys) or exchange
PAPER_BALANCES	—	—	Starting paper balances, e.g. USDT=1000

Freshness

Deprecated — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v0.2.1

FAQ

›How do I install the IRL Gateway MCP server in Claude Code?

Run: claude mcp add irl-gateway -e IRL_BASE_URL='<irl-base-url>' -e IRL_API_TOKEN='<irl-api-token>' -e IRL_AGENT_ID='<irl-agent-id>' -e IRL_MODEL_HASH='<irl-model-hash>' -- uvx irl-gateway. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does IRL Gateway require an API key?

Yes. It expects IRL_BASE_URL, IRL_API_TOKEN, IRL_AGENT_ID, IRL_MODEL_HASH, of which 1 is a secret.

›Can I use IRL Gateway as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is IRL Gateway in the official MCP registry?

Yes, as io.github.horkos-labs/irl-gateway.