Reins MCP Server

by r2rlabsio.github.R2Rlabs/hyperliquid-reinsv0.1.8

Risk limits and an audit log for AI agents trading Hyperliquid, enforced outside the model.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Reins MCP server

claude mcp add reins -e REINS_SYMBOLS='<reins-symbols>' -e REINS_MAX_POSITION_USD='<reins-max-position-usd>' -e REINS_DAILY_LOSS_USD='<reins-daily-loss-usd>' -e REINS_PRIVATE_KEY='<reins-private-key>' -- npx -y @r2rlabs/reins

{
  "mcpServers": {
    "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

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

{
  "servers": {
    "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
REINS_SYMBOLS	yes	—	Markets the agent may trade, comma separated, e.g. BTC,ETH. Every other market is refused.
REINS_MAX_POSITION_USD	yes	—	Largest position per market, in USD.
REINS_DAILY_LOSS_USD	yes	—	Realised loss in a UTC day after which new risk is refused.
REINS_MAX_LEVERAGE	—	—	Largest total exposure as a multiple of account value.
REINS_MODE	—	—	paper (live prices, simulated fills, nothing signed) or live.
REINS_NETWORK	—	—	Hyperliquid network for prices and, in live mode, orders. Mainnet spends real money.
REINS_REQUIRE_STOP_LOSS	—	—	true to refuse any order that adds risk without a stop-loss.
REINS_LOG_FILE	—	—	Decision log, one JSON line per action with the agent's stated reason. In memory if unset.
REINS_PAPER_FILE	—	—	Where the paper account is kept between runs. In memory if unset.
REINS_ACCOUNT_ADDRESS	—	—	Live mode: the Hyperliquid account traded. Approve Reins' 2 bp builder fee from it first: npx @r2rlabs/reins approve-builder
REINS_PRIVATE_KEY	—	yes	Live mode: an API wallet's key, which can trade but not withdraw. Never the account's own key.

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-02 · 8d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-04 · 6d ago · official registry · v0.1.8

FAQ

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

Run: claude mcp add reins -e REINS_SYMBOLS='<reins-symbols>' -e REINS_MAX_POSITION_USD='<reins-max-position-usd>' -e REINS_DAILY_LOSS_USD='<reins-daily-loss-usd>' -e REINS_PRIVATE_KEY='<reins-private-key>' -- npx -y @r2rlabs/reins. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Reins require an API key?

Yes. It expects REINS_SYMBOLS, REINS_MAX_POSITION_USD, REINS_DAILY_LOSS_USD, REINS_PRIVATE_KEY, of which 1 is a secret.

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

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

›Is Reins in the official MCP registry?

Yes, as io.github.R2Rlabs/hyperliquid-reins.