Skip to content
MCP server

IRL Gateway

Mandate gateway for AI trading agents: checks each order, seals reasoning, binds the fill

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.3.1
Listing updated
1 day ago

About IRL Gateway

IRL Gateway is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

A trading agent calls execute_trade with its reasoning. The gateway checks the order against the agent's mandate (active status, notional cap, allowed assets and venues), seals a hash of the rationale into IRL's tamper-evident trace anchored daily to Bitcoin, places a spot market order, and then records whether the fill MATCHED or DIVERGED from what was authorised. The plaintext rationale stays in a local journal.

It fails closed: if IRL is unreachable or denies the intent, no order is sent. Creating the file ~/.irl-gateway/KILL refuses every trade, and order sizes are rounded to the venue's rules before sealing so the sealed quantity is what is sent.

Paper trading is the default, with simulated fills at live public Binance prices and no exchange keys. The README says uvx irl-gateway init issues a free paper-tier token with a starter mandate for BTC/USDT and ETH/USDT up to 1,000 USDT per order, limited to 3 agents and 500 authorizations a day. Live trading means self-hosting the engine or asking for a full token. The site says IRL produces evidence but does not make a firm compliant on its own.

Install

Run in a terminal

claude mcp add irl-gateway --env IRL_API_TOKEN='<IRL_API_TOKEN>' -- uvx irl-gateway

Add to claude_desktop_config.json

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_API_TOKEN": "<IRL_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_API_TOKEN": "<IRL_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "irl-gateway": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_API_TOKEN": "<IRL_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_API_TOKEN": "<IRL_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "irl-gateway": {
      "command": "uvx",
      "args": [
        "irl-gateway"
      ],
      "env": {
        "IRL_API_TOKEN": "<IRL_API_TOKEN>"
      }
    }
  }
}

Configuration

  • IRL_BASE_URLIRL server URL. Optional: by default read from ~/.irl-gateway/agent.json; run `uvx irl-gateway init` to create it (free paper token from https://norve.dev)
  • IRL_API_TOKENBearer token for the IRL server. Optional: by default read from ~/.irl-gateway/agent.json, or run `uvx irl-gateway init`
  • IRL_AGENT_IDThe agent registered on IRL (its mandate). Optional: by default read from ~/.irl-gateway/agent.json, or run `uvx irl-gateway init`
  • IRL_MODEL_HASHThe model hash the agent was registered with (64 hex). Optional: by default read from ~/.irl-gateway/agent.json, or run `uvx irl-gateway init`
  • GATEWAY_BROKERpaper (default, live prices, no keys) or exchange
  • PAPER_BALANCESStarting paper balances, e.g. USDT=1000

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

execute_trade
Place a spot market order through authorize, place and bind.
get_policy
Show the agent's mandate and kill-switch state.
get_quote
Last price on the gateway's venue.
get_balances
Free balances, paper or exchange.
get_trace
IRL's sealed record of one trade.
list_recent_trades
Local journal of recent trades.

What it does

Mandate checks
Orders are validated against status, caps, assets and venues first.
Sealed reasoning
The rationale is hashed and anchored on Bitcoin.
Fill reconciliation
Each trade is recorded as MATCHED or DIVERGENT.
Fail closed
No order is sent if IRL is unreachable or denies it.
Kill switch
A local KILL file refuses all trades.
Paper trading
Default simulated fills at live Binance prices.

Good for

  • Constrain an AI trading agent to set assets and order sizes
  • Keep an auditable record of why each trade was made
  • Test a trading agent safely with paper fills
  • Export proof for an auditor to verify offline

Pricing

Freemium

Free paper tier; live trading needs a full token or self-hosting

Prices change. Check norve.dev before you buy.

IRL Gateway FAQ

Does it trade live by default?

No. Paper trading is the default and needs no exchange keys.

What are the free tier limits?

Paper venues only, up to 3 agents and 500 authorizations a day per token.

Can it prove the agent told the truth?

No. The site says the agent reports its own reasoning; the scheme proves timing, integrity and binding.

How do I start?

Run uvx irl-gateway init to get a token and an MCP config line.

Is IRL Gateway free?

IRL Gateway has a free plan, with paid plans for more usage or features.

How do I add IRL Gateway to Claude Code?

Run this command in your terminal: claude mcp add irl-gateway --env IRL_API_TOKEN='<IRL_API_TOKEN>' -- uvx irl-gateway

What are the best alternatives to IRL Gateway?

The closest alternatives to IRL Gateway are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to IRL Gateway

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments