@rackspay/wallet-mcp 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +134 -0
  2. package/build/index.js +1 -1
  3. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,134 @@
1
+ # @rackspay/wallet-mcp
2
+
3
+ Crypto-native trading and betting infrastructure for AI agents via Model Context Protocol.
4
+
5
+ Trade perpetuals on Hyperliquid, place prediction market bets on Polymarket, and check on-chain balances — all from Claude Desktop or any MCP-compatible client.
6
+
7
+ ---
8
+
9
+ ## Quick Start
10
+
11
+ ### 1. Get Your API Key
12
+
13
+ Sign up at [wallet.rackspay.com](https://wallet.rackspay.com), create an agent, and copy your API key from the agent page.
14
+
15
+ ### 2. Configure Claude Desktop
16
+
17
+ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\Claude\claude_desktop_config.json` on Windows:
18
+
19
+ ```json
20
+ {
21
+ "mcpServers": {
22
+ "racks-wallet": {
23
+ "command": "npx",
24
+ "args": ["@rackspay/wallet-mcp", "--api-key", "YOUR_API_KEY"]
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+ Restart Claude Desktop. RACKS tools will appear in the tools menu.
31
+
32
+ ### 3. Try It
33
+
34
+ ```
35
+ What's my wallet balance?
36
+ ```
37
+ ```
38
+ Go long 0.1 ETH on Hyperliquid at market price
39
+ ```
40
+ ```
41
+ Find a Polymarket market on the US election and bet $20 on the leading outcome
42
+ ```
43
+
44
+ ---
45
+
46
+ ## Available Tools
47
+
48
+ | Tool | Description |
49
+ |---|---|
50
+ | `racks_get_status` | Agent name, wallet addresses, capabilities, and spend limits |
51
+ | `racks_get_wallet_balance` | USDC balance across Arbitrum, Polygon, and HyperCore |
52
+ | `racks_get_trade_account` | Full Hyperliquid account: margin, open positions, open orders |
53
+ | `racks_get_positions` | Open perp positions with unrealized PnL |
54
+ | `racks_place_order` | Place a limit or market order on Hyperliquid |
55
+ | `racks_cancel_order` | Cancel an open order by ID |
56
+ | `racks_get_markets` | Browse active Polymarket prediction markets |
57
+ | `racks_place_bet` | Place a bet on a Polymarket outcome |
58
+ | `racks_get_bet_positions` | Open Polymarket positions with current value |
59
+
60
+ ---
61
+
62
+ ## How It Works
63
+
64
+ ```
65
+ Claude Desktop (MCP client)
66
+ ↓ tool call: racks_place_order
67
+ @rackspay/wallet-mcp (this package)
68
+ ↓ POST /api/v1/agent/trade/order
69
+ RACKS API (api.wallet.rackspay.com)
70
+ ↓ EIP-712 signature via Privy
71
+ Hyperliquid (builder code attached)
72
+ ↓ order filled
73
+ Claude receives confirmation → position open
74
+ ```
75
+
76
+ 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.
77
+
78
+ ---
79
+
80
+ ## Options
81
+
82
+ | Flag | Env var | Required | Description |
83
+ |---|---|---|---|
84
+ | `--api-key` | `RACKS_API_KEY` | Yes | Agent API key from the dashboard |
85
+ | — | `RACKS_API_URL` | No | Override API endpoint (default: `https://api.wallet.rackspay.com`) |
86
+
87
+ ---
88
+
89
+ ## Capabilities
90
+
91
+ Agents have per-capability permissions set from the dashboard:
92
+
93
+ - **Trading** — required for Hyperliquid orders and positions
94
+ - **Betting** — required for Polymarket bets and positions
95
+ - **Spend limits** — daily and monthly USDC caps enforced server-side
96
+
97
+ Call `racks_get_status` to see what's enabled for your agent.
98
+
99
+ ---
100
+
101
+ ## Development
102
+
103
+ ```bash
104
+ git clone https://github.com/racks-ai/wallet-mcp.git
105
+ cd wallet-mcp
106
+ npm install
107
+
108
+ # Run in dev mode
109
+ npm run dev -- --api-key YOUR_API_KEY
110
+
111
+ # Build
112
+ npm run build
113
+ ```
114
+
115
+ ---
116
+
117
+ ## Also Available
118
+
119
+ - **[`@rackspay/mcp-server`](https://www.npmjs.com/package/@rackspay/mcp-server)** — fiat payments: issue virtual cards, manage budgets, view transactions
120
+ - **REST API** — direct integration via [api.wallet.rackspay.com/docs](https://api.wallet.rackspay.com/docs)
121
+ - **Python SDK** — coming Q2 2026
122
+ - **TypeScript SDK** — coming Q2 2026
123
+
124
+ ---
125
+
126
+ ## Links
127
+
128
+ - [Dashboard](https://wallet.rackspay.com)
129
+ - [Documentation](https://wallet.rackspay.com/docs)
130
+ - [MCP Protocol](https://modelcontextprotocol.io)
131
+
132
+ ---
133
+
134
+ MIT — Racks AI, Inc.
package/build/index.js CHANGED
@@ -14,7 +14,7 @@
14
14
  * "mcpServers": {
15
15
  * "racks-wallet": {
16
16
  * "command": "npx",
17
- * "args": ["@rackswallet/mcp", "--api-key", "rk_live_..."]
17
+ * "args": ["@rackspay/wallet-mcp", "--api-key", "rk_live_..."]
18
18
  * }
19
19
  * }
20
20
  * }
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@rackspay/wallet-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "bin": {
7
- "racks-wallet-mcp": "./build/index.js"
7
+ "rackswallet": "./build/index.js"
8
8
  },
9
9
  "scripts": {
10
10
  "build": "tsc && chmod 755 build/index.js",