IRL Gateway
Mandate gateway for AI trading agents: checks each order, seals reasoning, binds the fill
- 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-gatewayAdd 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 exchangePAPER_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments