@rackspay/wallet-mcp 1.0.5 → 1.2.0

package/README.md

@@ -1,8 +1,8 @@
 # @rackspay/wallet-mcp
 
-Crypto-native trading and betting infrastructure for AI agents via Model Context Protocol.
+Crypto-native trading, betting, and machine payments 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.
+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.
 
 ---
 
@@ -40,6 +40,9 @@ 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
+```
 
 ---
 
@@ -48,7 +51,10 @@ Find a Polymarket market on the US election and bet $20 on the leading outcome
 | 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_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 |
@@ -56,6 +62,7 @@ Find a Polymarket market on the US election and bet $20 on the leading outcome
 | `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) |
 
 ---
 
@@ -73,7 +80,20 @@ Hyperliquid (builder code attached)
 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.
+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 PathUSD (Tempo's USDC) via `racks_bridge_usdc` to enable paid requests.
 
 ---
 
@@ -92,6 +112,7 @@ 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.
@@ -118,8 +139,6 @@ npm run build
 
 - **[`@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
 
 ---
 
@@ -127,6 +146,7 @@ npm run build
 
 - [Dashboard](https://wallet.rackspay.com)
 - [Documentation](https://wallet.rackspay.com/docs)
+- [MPP Protocol](https://mpp.dev)
 - [MCP Protocol](https://modelcontextprotocol.io)
 
 ---

package/build/index.js

@@ -139,8 +139,8 @@ server.tool("racks_get_status", "Check this agent's current status: name, wallet
 // Tool: racks_get_wallet_balance
 // ─────────────────────────────────────────────────────────────────────────────
 server.tool("racks_get_wallet_balance", "Return this agent's USDC balance on every chain: Arbitrum (primary), Polygon (Polymarket), " +
-    "Solana, and HyperCore (funds deposited into Hyperliquid). " +
-    "Use this before trading or betting to verify sufficient funds.", {}, async () => {
+    "Solana, HyperCore (funds deposited into Hyperliquid), and Tempo (PathUSD for MPP payments). " +
+    "Use this before trading, betting, or making MPP requests to verify sufficient funds.", {}, async () => {
     const res = await request("GET", "/api/v1/agent/wallet/balance");
     if (!res.ok)
         return apiError(res, "Failed to fetch wallet balance");
@@ -154,10 +154,15 @@ server.tool("racks_get_wallet_balance", "Return this agent's USDC balance on eve
                     balance: {
                         arbitrum_usdc: d.arbitrum_usdc,
                         polygon_usdc: d.polygon_usdc,
+                        solana_usdc: d.solana_usdc,
                         hypercore_usdc: d.hypercore_usdc,
+                        tempo_pathusd: d.tempo_pathusd,
                         total_usdc: d.total_usdc,
                     },
-                    note: "HyperCore balance is USDC already deposited into Hyperliquid for trading.",
+                    notes: {
+                        hypercore: "HyperCore balance is USDC already deposited into Hyperliquid for trading.",
+                        tempo: "Tempo PathUSD is used for MPP machine-to-machine payments via racks_mpp_request.",
+                    },
                 }, null, 2),
             },
         ],
@@ -566,6 +571,48 @@ server.tool("racks_get_bet_positions", "List all open Polymarket positions for t
         ],
     };
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool: racks_mpp_request
+// ─────────────────────────────────────────────────────────────────────────────
+server.tool("racks_mpp_request", "Make a paid HTTP request on behalf of this agent using the Machine Payments Protocol (MPP / Tempo). " +
+    "The agent's Privy wallet automatically signs and pays the 402 payment challenge — " +
+    "no manual approval or wallet management needed. " +
+    "Use this to call any MPP-enabled API (LLM inference, image generation, web search, data feeds, etc.). " +
+    "Returns the API response data plus the on-chain Tempo payment receipt. " +
+    "Requires PathUSD (Tempo's USDC) at the agent's EVM wallet address on the Tempo chain. " +
+    "Bridge USDC to Tempo first using racks_bridge_usdc if the agent's Tempo balance is low.", {
+    url: z
+        .string()
+        .url()
+        .describe("The MPP-enabled API endpoint URL to call (must support HTTP 402 payment challenge)"),
+    max_amount: z
+        .string()
+        .optional()
+        .describe("Maximum USDC amount willing to spend on this request (e.g. '0.10' for 10 cents). " +
+        "Used for logging only — actual amount is determined by the server's 402 challenge."),
+}, async ({ url, max_amount }) => {
+    const res = await request("POST", "/api/v1/agent/mpp", { url, ...(max_amount ? { max_amount } : {}) });
+    if (!res.ok)
+        return apiError(res, "MPP request failed");
+    const d = res.data;
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    url: d.url,
+                    wallet_address: d.wallet_address,
+                    receipt: d.receipt,
+                    data: d.data,
+                    note: d.receipt
+                        ? "Payment completed. Receipt proves the Tempo on-chain settlement."
+                        : "Request completed (no payment was required).",
+                }, null, 2),
+            },
+        ],
+    };
+});
 // ============================================================================
 // SERVER STARTUP
 // ============================================================================

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rackspay/wallet-mcp",
-  "version": "1.0.5",
-  "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.",
+  "version": "1.2.0",
+  "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.",
   "type": "module",
   "bin": {
     "rackswallet": "./build/index.js"
@@ -23,7 +23,11 @@
     "hyperliquid",
     "polymarket",
     "trading",
-    "defi"
+    "defi",
+    "tempo",
+    "mpp",
+    "machine-payments",
+    "payments"
   ],
   "author": "Racks AI, Inc.",
   "license": "MIT",