# Reins

> Reins is an open-source MCP server for finance and payments. Risk limits and a decision log that sit between an AI agent and Hyperliquid trading. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://r2rlabs.com
- **Repository:** https://github.com/r2rlabs/reins
- **MCP Registry name:** io.github.R2Rlabs/hyperliquid-reins
- **Categories:** finance and payments
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/reins
