Reins
Risk limits and a decision log that sit between an AI agent and Hyperliquid trading
- 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/reinsAdd 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.RequiredREINS_MAX_POSITION_USDLargest position per market, in USD.RequiredREINS_DAILY_LOSS_USDRealised loss in a UTC day after which new risk is refused.RequiredREINS_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-builderREINS_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

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
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

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government