npm package: @rackspay/wallet-mcp
Description: RACKS Wallet MCP — crypto trading, betting, and MPP payments for AI agents. Trade perps on Hyperliquid, bet on Polymarket, pay APIs via Tempo/MPP, and check on-chain balances via Claude Desktop or any MCP client.
Author: Racks AI, Inc.
Latest version: 1.2.4

# @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](https://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:

```json
{
  "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](https://mpp.dev). 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

```bash
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`](https://www.npmjs.com/package/@rackspay/mcp-server)** — fiat payments: issue virtual cards, manage budgets, view transactions
- **REST API** — direct integration via [api.wallet.rackspay.com/docs](https://api.wallet.rackspay.com/docs)

---

## Links

- [Dashboard](https://wallet.rackspay.com)
- [Documentation](https://wallet.rackspay.com/docs)
- [MPP Protocol](https://mpp.dev)
- [MCP Protocol](https://modelcontextprotocol.io)

---

MIT — Racks AI, Inc.