@rackspay/wallet-mcp

Crypto-native trading, betting, and machine payments for AI agents via Model Context Protocol.

Trade perpetuals on Hyperliquid, place prediction market bets on Polymarket, bridge USDC across chains, and pay for APIs autonomously using Tempo/MPP — all from Claude Desktop or any MCP-compatible client.

Quick Start

1. Get Your API Key

Sign up at wallet.rackspay.com, create an agent, and copy your API key from the agent page.

2. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "mcpServers": {
    "racks-wallet": {
      "command": "npx",
      "args": ["@rackspay/wallet-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Restart Claude Desktop. RACKS tools will appear in the tools menu.

3. Try It

What's my wallet balance?

Go long 0.1 ETH on Hyperliquid at market price

Find a Polymarket market on the US election and bet $20 on the leading outcome

Fetch the latest AI news from https://mpp.dev/api/ping/paid

Available Tools

| Tool | Description | |---|---| | racks_get_status | Agent name, wallet addresses, capabilities, and spend limits | | racks_get_wallet_balance | USDC balance across Arbitrum, Polygon, Solana, HyperCore, and Tempo | | racks_bridge_usdc | Bridge USDC between chains (Arbitrum ↔ Polygon ↔ Solana ↔ Tempo) | | racks_deposit_to_hypercore | Move USDC from Arbitrum wallet into HyperCore for Hyperliquid trading | | racks_withdraw_from_hypercore | Withdraw USDC from HyperCore back to Arbitrum wallet | | racks_get_trade_account | Full Hyperliquid account: margin, open positions, open orders | | racks_get_positions | Open perp positions with unrealized PnL | | racks_place_order | Place a limit or market order on Hyperliquid | | racks_cancel_order | Cancel an open order by ID | | racks_get_markets | Browse active Polymarket prediction markets | | racks_place_bet | Place a bet on a Polymarket outcome | | racks_get_bet_positions | Open Polymarket positions with current value | | racks_mpp_request | Pay for any MPP-enabled API automatically via Tempo (HTTP 402 flow) |

How It Works

Claude Desktop (MCP client)
    ↓  tool call: racks_place_order
@rackspay/wallet-mcp (this package)
    ↓  POST /api/v1/agent/trade/order
RACKS API (api.wallet.rackspay.com)
    ↓  EIP-712 signature via Privy
Hyperliquid (builder code attached)
    ↓  order filled
Claude receives confirmation → position open

Every action is signed server-side using the agent's embedded Privy wallet. Builder codes are attached automatically for Hyperliquid. Every action is logged with a full audit trail visible in your dashboard.

Machine Payments (MPP / Tempo)

racks_mpp_request lets your agent pay for any API that supports the Machine Payments Protocol. The agent's Privy wallet signs the 402 payment challenge automatically — no manual wallet management or API key setup needed.

# Example: fetch a paid API result
racks_mpp_request("https://mpp.dev/api/ping/paid")

The agent's existing EVM wallet address works on Tempo. Fund it with USDC.e via racks_bridge_usdc(destination_chain="tempo") to enable paid requests.

Options

| Flag | Env var | Required | Description | |---|---|---|---| | --api-key | RACKS_API_KEY | Yes | Agent API key from the dashboard | | — | RACKS_API_URL | No | Override API endpoint (default: https://api.wallet.rackspay.com) |

Capabilities

Agents have per-capability permissions set from the dashboard:

• Trading — required for Hyperliquid orders and positions
• Betting — required for Polymarket bets and positions
• MPP — pay for APIs autonomously via Tempo
• Spend limits — daily and monthly USDC caps enforced server-side

Call racks_get_status to see what's enabled for your agent.

Development

git clone https://github.com/racks-ai/wallet-mcp.git
cd wallet-mcp
npm install

# Run in dev mode
npm run dev -- --api-key YOUR_API_KEY

# Build
npm run build

Also Available

• @rackspay/mcp-server — fiat payments: issue virtual cards, manage budgets, view transactions
• REST API — direct integration via api.wallet.rackspay.com/docs

Links

• Dashboard
• Documentation
• MPP Protocol
• MCP Protocol

MIT — Racks AI, Inc.