@rackspay/wallet-mcp 1.0.0 → 1.0.3

package/README.md

@@ -0,0 +1,134 @@
+# @rackspay/wallet-mcp
+
+Crypto-native trading and betting infrastructure for AI agents via Model Context Protocol.
+
+Trade perpetuals on Hyperliquid, place prediction market bets on Polymarket, and check on-chain balances — 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
+```
+
+---
+
+## Available Tools
+
+| Tool | Description |
+|---|---|
+| `racks_get_status` | Agent name, wallet addresses, capabilities, and spend limits |
+| `racks_get_wallet_balance` | USDC balance across Arbitrum, Polygon, and HyperCore |
+| `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 |
+
+---
+
+## 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 order is signed server-side using the agent's embedded Privy wallet. Builder codes are attached automatically. Every action is logged with a full audit trail visible in your dashboard.
+
+---
+
+## 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
+- **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)
+- **Python SDK** — coming Q2 2026
+- **TypeScript SDK** — coming Q2 2026
+
+---
+
+## Links
+
+- [Dashboard](https://wallet.rackspay.com)
+- [Documentation](https://wallet.rackspay.com/docs)
+- [MCP Protocol](https://modelcontextprotocol.io)
+
+---
+
+MIT — Racks AI, Inc.

package/build/index.js

@@ -14,7 +14,7 @@
  *     "mcpServers": {
  *       "racks-wallet": {
  *         "command": "npx",
- *         "args": ["@rackswallet/mcp", "--api-key", "rk_live_..."]
+ *         "args": ["@rackspay/wallet-mcp", "--api-key", "rk_live_..."]
  *       }
  *     }
  *   }
@@ -164,6 +164,86 @@ server.tool("racks_get_wallet_balance", "Return this agent's USDC balance on eve
     };
 });
 // ─────────────────────────────────────────────────────────────────────────────
+// Tool: racks_bridge_usdc
+// ─────────────────────────────────────────────────────────────────────────────
+server.tool("racks_bridge_usdc", "Bridge USDC between chains using the Relay solver network. " +
+    "Gas is abstracted — no ETH needed on the destination chain. " +
+    "Supports Solana → Arbitrum, Arbitrum → Arbitrum, Polygon → Arbitrum. " +
+    "Use this to move funds into Arbitrum before depositing to HyperCore for trading. " +
+    "IMPORTANT: call racks_get_wallet_balance first to confirm source chain balance.", {
+    origin_chain: z
+        .enum(["solana", "arbitrum", "polygon"])
+        .describe("Chain to bridge FROM. Use 'solana' to bridge from the agent's Solana wallet"),
+    destination_chain: z
+        .enum(["arbitrum", "polygon"])
+        .describe("Chain to bridge TO. Use 'arbitrum' to fund HyperCore trading"),
+    amount_usdc: z
+        .number()
+        .positive()
+        .describe("Amount of USDC to bridge (e.g. 1.0 = $1.00). A small relayer fee is deducted from this amount"),
+}, async ({ origin_chain, destination_chain, amount_usdc }) => {
+    const res = await request("POST", "/api/v1/agent/wallet/bridge", {
+        origin_chain,
+        destination_chain,
+        amount_usdc,
+    });
+    if (!res.ok)
+        return apiError(res, "Failed to bridge USDC");
+    const d = res.data;
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    bridge: {
+                        from: origin_chain,
+                        to: destination_chain,
+                        amount_usdc,
+                        relayer_fee: d.relayer_fee_usdc,
+                        expected_received: d.expected_output,
+                        request_id: d.request_id,
+                    },
+                    steps: d.steps_executed,
+                    note: `Funds arrive on ${destination_chain} in ~5-30 seconds. Then call racks_deposit_to_hypercore to fund trading.`,
+                    status_url: d.status_endpoint,
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool: racks_deposit_to_hypercore
+// ─────────────────────────────────────────────────────────────────────────────
+server.tool("racks_deposit_to_hypercore", "Move USDC from this agent's Arbitrum wallet into HyperCore (Hyperliquid's L1 trading account). " +
+    "This is required before placing any trades — Hyperliquid only accepts funds from Arbitrum. " +
+    "The agent signs two transactions via Privy: ERC-20 approve, then bridge deposit. " +
+    "IMPORTANT: call racks_get_wallet_balance first to confirm sufficient Arbitrum USDC.", {
+    amount_usdc: z
+        .number()
+        .positive()
+        .describe("Amount of USDC to deposit into HyperCore (e.g. 10.5 = $10.50)"),
+}, async ({ amount_usdc }) => {
+    const res = await request("POST", "/api/v1/agent/wallet/deposit/hypercore", { amount_usdc });
+    if (!res.ok)
+        return apiError(res, "Failed to deposit to HyperCore");
+    const d = res.data;
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    deposited_usdc: amount_usdc,
+                    approve_tx: d.approve_tx,
+                    deposit_tx: d.deposit_tx,
+                    note: "Funds typically arrive in HyperCore within 1-2 minutes. Then call racks_get_trade_account to confirm.",
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ─────────────────────────────────────────────────────────────────────────────
 // Tool: racks_get_trade_account
 // ─────────────────────────────────────────────────────────────────────────────
 server.tool("racks_get_trade_account", "Fetch this agent's full Hyperliquid HyperCore account state: account value, margin, " +

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@rackspay/wallet-mcp",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "RACKS Wallet MCP — crypto trading and betting infrastructure for AI agents. Trade perps on Hyperliquid, bet on Polymarket, and check on-chain balances via Claude Desktop or any MCP client.",
   "type": "module",
   "bin": {
-    "racks-wallet-mcp": "./build/index.js"
+    "rackswallet": "./build/index.js"
   },
   "scripts": {
     "build": "tsc && chmod 755 build/index.js",