Skip to content
MCP server

Reins

Risk limits and a decision log that sit between an AI agent and Hyperliquid trading

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.8
Listing updated
1 day ago

About Reins

Reins is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Reins is a guardrail layer, not a trading strategy. Limits on position size per market, total leverage, daily realised loss, an allowlist of markets, and a cap on what a single trade may lose if its stop fills are set through environment variables and enforced outside the model; no tool exists to change them. An optional setting refuses any order that adds risk without a stop-loss. A refused order comes back with the limit that blocked it.

It starts in paper mode, with live Hyperliquid prices and simulated fills and fees, so an agent can rehearse using the same tools and limits before money is involved. Live mode trades through an API wallet that can place orders but cannot withdraw, and charges a disclosed 2 basis point builder fee on live orders. Every order, refusal and wait is logged with the reason the agent gave, so claims can be compared with outcomes. The README cites a five-day paper run where the log caught the agent misreporting a trade twice.

It runs locally over stdio, with an HTTP interface and a Python client for bots that do not speak MCP. It is not advice and does not promise protection from market losses; mainnet spends real money.

Install

Run in a terminal

claude mcp add hyperliquid-reins --env REINS_SYMBOLS='<REINS_SYMBOLS>' --env REINS_MAX_POSITION_USD='<REINS_MAX_POSITION_USD>' --env REINS_DAILY_LOSS_USD='<REINS_DAILY_LOSS_USD>' --env REINS_PRIVATE_KEY='<REINS_PRIVATE_KEY>' -- npx -y @r2rlabs/reins

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hyperliquid-reins": {
      "command": "npx",
      "args": [
        "-y",
        "@r2rlabs/reins"
      ],
      "env": {
        "REINS_SYMBOLS": "<REINS_SYMBOLS>",
        "REINS_MAX_POSITION_USD": "<REINS_MAX_POSITION_USD>",
        "REINS_DAILY_LOSS_USD": "<REINS_DAILY_LOSS_USD>",
        "REINS_PRIVATE_KEY": "<REINS_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hyperliquid-reins": {
      "command": "npx",
      "args": [
        "-y",
        "@r2rlabs/reins"
      ],
      "env": {
        "REINS_SYMBOLS": "<REINS_SYMBOLS>",
        "REINS_MAX_POSITION_USD": "<REINS_MAX_POSITION_USD>",
        "REINS_DAILY_LOSS_USD": "<REINS_DAILY_LOSS_USD>",
        "REINS_PRIVATE_KEY": "<REINS_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "hyperliquid-reins": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@r2rlabs/reins"
      ],
      "env": {
        "REINS_SYMBOLS": "<REINS_SYMBOLS>",
        "REINS_MAX_POSITION_USD": "<REINS_MAX_POSITION_USD>",
        "REINS_DAILY_LOSS_USD": "<REINS_DAILY_LOSS_USD>",
        "REINS_PRIVATE_KEY": "<REINS_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "hyperliquid-reins": {
      "command": "npx",
      "args": [
        "-y",
        "@r2rlabs/reins"
      ],
      "env": {
        "REINS_SYMBOLS": "<REINS_SYMBOLS>",
        "REINS_MAX_POSITION_USD": "<REINS_MAX_POSITION_USD>",
        "REINS_DAILY_LOSS_USD": "<REINS_DAILY_LOSS_USD>",
        "REINS_PRIVATE_KEY": "<REINS_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "hyperliquid-reins": {
      "command": "npx",
      "args": [
        "-y",
        "@r2rlabs/reins"
      ],
      "env": {
        "REINS_SYMBOLS": "<REINS_SYMBOLS>",
        "REINS_MAX_POSITION_USD": "<REINS_MAX_POSITION_USD>",
        "REINS_DAILY_LOSS_USD": "<REINS_DAILY_LOSS_USD>",
        "REINS_PRIVATE_KEY": "<REINS_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • REINS_SYMBOLSMarkets the agent may trade, comma separated, e.g. BTC,ETH. Every other market is refused.Required
  • REINS_MAX_POSITION_USDLargest position per market, in USD.Required
  • REINS_DAILY_LOSS_USDRealised loss in a UTC day after which new risk is refused.Required
  • REINS_MAX_LEVERAGELargest total exposure as a multiple of account value.
  • REINS_MODEpaper (live prices, simulated fills, nothing signed) or live.
  • REINS_NETWORKHyperliquid network for prices and, in live mode, orders. Mainnet spends real money.
  • REINS_REQUIRE_STOP_LOSStrue to refuse any order that adds risk without a stop-loss.
  • REINS_LOG_FILEDecision log, one JSON line per action with the agent's stated reason. In memory if unset.
  • REINS_PAPER_FILEWhere the paper account is kept between runs. In memory if unset.
  • REINS_ACCOUNT_ADDRESSLive mode: the Hyperliquid account traded. Approve Reins' 2 bp builder fee from it first: npx @r2rlabs/reins approve-builder
  • REINS_PRIVATE_KEYLive mode: an API wallet's key, which can trade but not withdraw. Never the account's own key.

What it does

External risk limits
Position, leverage, daily loss and market allowlist enforced outside the model.
Paper trading
Rehearse on live prices with simulated fills and fees, no key needed.
Decision log
Every order, refusal and wait is stored with the agent's stated reason.
Stop-loss requirement
Optionally refuse orders that add risk without a stop.
Non-custodial
Live trades use an API wallet that cannot withdraw.
HTTP and Python access
Non-MCP bots can route orders through Reins.

Good for

  • Rehearse an AI trading agent on paper before using funds
  • Cap the daily loss an agent can incur
  • Audit why an agent traded or declined to trade
  • Add limits to an existing Hyperliquid bot

Pricing

Open source

Free and open source; 2 bp builder fee on live orders

Prices change. Check r2rlabs.com before you buy.

Reins FAQ

Is it a trading bot?

No. It does not decide what to trade; it only enforces limits and keeps a record.

Can the agent change the limits?

No. There is no tool that changes them.

What does live trading cost?

A 2 basis point builder fee on live orders, shown up front.

Does it guarantee against losses?

No. Limits cap what can go wrong, but stops can slip in fast markets and it is not financial advice.

Is Reins free?

Yes. Reins is open source, so you can use and self-host it for free.

How do I add Reins to Claude Code?

Run this command in your terminal: claude mcp add hyperliquid-reins --env REINS_SYMBOLS='<REINS_SYMBOLS>' --env REINS_MAX_POSITION_USD='<REINS_MAX_POSITION_USD>' --env REINS_DAILY_LOSS_USD='<REINS_DAILY_LOSS_USD>' --env REINS_PRIVATE_KEY='<REINS_PRIVATE_KEY>' -- npx -y @r2rlabs/reins

What are the best alternatives to Reins?

The closest alternatives to Reins are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Reins

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

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

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. 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
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government