rhc-mcp

An MCP server for Robinhood Chain — the on-chain agentic surface Robinhood's own agent can't reach.

Robinhood's Agentic Trading exposes an MCP server so any Claude / ChatGPT / MCP agent can trade — but it's off-chain, US-only, equities-only. It can't see or touch the tokenized Robinhood Chain stock tokens.

rhc-mcp is the complement: point any MCP-speaking agent at Robinhood Chain and let it read on-chain stock-token positions, see the real total-return value ERC-20 reads hide, quote, and swap — over the same Model Context Protocol. Read tools need no key; swapping is off by default and heavily guarded.

Swaps go through Robinhood Chain's Uniswap v4 UniversalRouter directly — nothing to deploy. One catch worth knowing: the chain forks the v4 swap struct with an extra minHopPriceX36 field, so stock Uniswap SDK calldata reverts. This encoder adds it (verified byte-identical to real on-chain swaps). The sibling repo RHCSwap is an alternate route (a tiny contract that hits the v4 PoolManager directly) if you'd rather not touch Permit2.

How it fits

flowchart LR
    A["AI agent<br/>(Claude · ChatGPT · any MCP client)"]
    subgraph RH["Robinhood's MCP"]
      O["off-chain brokerage<br/>US · equities only"]
    end
    subgraph THIS["rhc-mcp (this repo)"]
      T["get_positions · quote_swap · execute_swap"]
    end
    subgraph CHAIN["Robinhood Chain (Arbitrum Orbit, id 4663)"]
      R["stock tokens<br/>balanceOf + uiMultiplier"]
      Q["Uniswap v4 Quoter"]
      S["UniversalRouter + Permit2<br/>(v4 swap)"]
    end
    A -->|off-chain trades| O
    A -->|on-chain, this repo| T
    T --> R
    T --> Q
    T --> S

Related MCP server: robinhood-mcp

Tools

The uiMultiplier insight

Stock tokens are ERC-8056 total-return tokens: raw balanceOf is static, and uiMultiplier() (1e18-scaled) grows as in-kind dividends reinvest and on splits. A naive ERC-20 balance read understates what a holder actually owns. get_positions surfaces both and the gap between them — the on-chain yield an agent would otherwise miss.

Install

git clone https://github.com/jumpboxtech/rhc-mcp && cd rhc-mcp
npm install && npm run build
cp .env.example .env   # edit for swapping; read tools need nothing

Wire it to an agent

Claude Code:

claude mcp add rhc-mcp -- node /absolute/path/to/rhc-mcp/dist/index.js

Claude Desktop / any MCP client (claude_desktop_config.json):

{
  "mcpServers": {
    "rhc-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/rhc-mcp/dist/index.js"],
      "env": { "RHC_RPC_URL": "https://rpc.mainnet.chain.robinhood.com" }
    }
  }
}

Then ask your agent: "What are my Robinhood Chain positions for 0x…?" or "Quote 1 NVDA to USDG."

Safety model

execute_swap moves real funds, so it is deliberately locked down:

• Read-only by default — with no RHC_PRIVATE_KEY, the server can only read; swaps are refused.

• Key never touches the tool surface — the signer comes only from RHC_PRIVATE_KEY, never a tool argument, and is never returned or logged.

• Dry-run by default — execute_swap returns the plan (expected out, enforced min out, and which Permit2 approvals a real run would send) without sending unless the caller passes dryRun: false.

• Hard size cap — RHC_MAX_SWAP_AMOUNT (whole input tokens, default 1) bounds any single swap.

• Slippage always enforced — a real minAmountOut is required, taken from the argument or derived from a fresh quote minus slippageBps.

• Scoped Permit2 grant — the Permit2 → router allowance is scoped to amountIn with a short (~1h) expiry, not an unbounded standing approval.

Configuration

Robinhood Chain addresses (chain id 4663)

RPC: https://rpc.mainnet.chain.robinhood.com · Explorer: robinhoodchain.blockscout.com

Scope & limits

Exact-input, single-hop, hookless pools — deliberately minimal. Exact-output and multi-hop aren't covered (and haven't been checked for the same minHopPriceX36 quirk). The known-token registry is a small starter set (USDG, NVDA); pass any 0x address directly. Unaudited — read it before you route funds through it.

License

MIT © jumpbox — jumpbox.tech · @jumpbox_tech