@openclawcash/mcp-server 0.1.16 → 0.1.21

package/openclawcash-mcp.mjs

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 import { z } from "zod";
 
 const SERVER_NAME = "openclawcash";
-const SERVER_VERSION = "0.1.16";
+const SERVER_VERSION = "0.1.21";
 const PROTOCOL_VERSION = "2024-11-05";
 const DEFAULT_BASE_URL = "https://openclawcash.com";
 
@@ -104,6 +104,11 @@ const walletsListArgsSchema = z.object({
 });
 const skillLatestArgsSchema = z.object({}).strict();
 
+const tokenlistArgsSchema = z.object({
+  chainId: z.number().int().positive().optional(),
+  extended: z.boolean().optional(),
+}).strict();
+
 const balancesArgsSchema = z
   .object({
     walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
@@ -119,6 +124,7 @@ const balancesArgsSchema = z
 const transferArgsSchema = walletSelectorBaseSchema
   .extend({
     to: z.string().min(1),
+    network: z.string().min(1).optional(),
     amountDisplay: z.string().min(1).optional(),
     valueBaseUnits: z.string().min(1).optional(),
     amount: z.string().min(1).optional(),
@@ -165,6 +171,7 @@ const swapExecuteArgsSchema = z
     amountIn: z.string().min(1),
     slippage: z.number().positive().optional(),
     chain: z.enum(["evm", "solana"]).optional(),
+    network: z.string().min(1).optional(),
   })
   .refine((data) => [data.walletId, data.walletAddress].filter((value) => value !== undefined).length === 1, {
     message: "Provide exactly one of walletId or walletAddress.",
@@ -178,11 +185,40 @@ const approveArgsSchema = z
     spender: z.string().min(1),
     amount: z.string().min(1),
     chain: z.enum(["evm", "solana"]).optional(),
+    network: z.string().min(1).optional(),
+  })
+  .refine((data) => [data.walletId, data.walletAddress].filter((value) => value !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
+const bridgeQuoteArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    fromNetwork: z.string().min(1),
+    fromToken: z.string().min(1),
+    toNetwork: z.string().min(1),
+    toToken: z.string().min(1),
+    toAddress: z.string().min(1).optional(),
+    amountIn: z.string().min(1),
+    slippagePercent: z.number().min(0).max(50).optional(),
   })
   .refine((data) => [data.walletId, data.walletAddress].filter((value) => value !== undefined).length === 1, {
     message: "Provide exactly one of walletId or walletAddress.",
   });
 
+const bridgeExecuteArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    quoteId: z.string().min(1),
+  })
+  .refine((data) => [data.walletId, data.walletAddress].filter((value) => value !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
+const bridgeStatusArgsSchema = z.object({ bridgeTxId: z.string().min(1) });
+
 const supportedTokensArgsSchema = walletSelectorBaseSchema
   .extend({
     network: z.string().min(1).optional(),
@@ -193,7 +229,7 @@ const supportedTokensArgsSchema = walletSelectorBaseSchema
 
 const createWalletArgsSchema = z.object({
   label: z.string().min(1),
-  network: z.enum(["sepolia", "mainnet", "polygon-mainnet", "solana-devnet", "solana-testnet", "solana-mainnet"]).optional(),
+  network: z.enum(["sepolia", "mainnet", "polygon-mainnet", "base-mainnet", "solana-devnet", "solana-testnet", "solana-mainnet"]).optional(),
   exportPassphrase: z.string().trim().min(12),
   exportPassphraseStorageType: z.enum(["env", "secret_manager", "vault", "other"]),
   exportPassphraseStorageRef: z.string().trim().min(3),
@@ -202,7 +238,7 @@ const createWalletArgsSchema = z.object({
 
 const importWalletArgsSchema = z.object({
   label: z.string().min(1),
-  network: z.enum(["mainnet", "polygon-mainnet", "solana-mainnet"]),
+  network: z.enum(["mainnet", "polygon-mainnet", "base-mainnet", "solana-mainnet"]),
   privateKey: z.string().min(1),
 });
 
@@ -311,6 +347,43 @@ const polymarketMarketSearchArgsSchema = z.object({
   limit: z.number().int().positive().max(50).optional(),
 });
 
+const yieldwolfCasinoLinkArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    agentName: z.string().min(1).max(64).optional(),
+    lane: z.enum(["real", "test"]).optional(),
+  })
+  .strict()
+  .refine((data) => [data.walletId, data.walletAddress].filter((v) => v !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
+const yieldwolfCasinoUnlinkArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+  })
+  .strict()
+  .refine((data) => [data.walletId, data.walletAddress].filter((v) => v !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
+const yieldwolfCasinoCallArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    method: z.enum(["GET", "POST"]).optional(),
+    path: z.string().min(1),
+    body: z.unknown().optional(),
+    query: z.record(z.string()).optional(),
+    idempotencyKey: z.string().min(1).optional(),
+  })
+  .strict()
+  .refine((data) => [data.walletId, data.walletAddress].filter((v) => v !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
 const checkoutEscrowIdArgsSchema = z.object({
   id: z.string().min(1),
 });
@@ -437,7 +510,7 @@ function requireAgentKey() {
   return agentKey;
 }
 
-async function callAgentApi({ method, pathName, query, body, requireAuth = true }) {
+async function callAgentApi({ method, pathName, query, body, requireAuth = true, extraHeaders }) {
   const headers = {
     Accept: "application/json",
   };
@@ -452,6 +525,11 @@ async function callAgentApi({ method, pathName, query, body, requireAuth = true
   if (["POST", "PATCH", "DELETE"].includes(String(method || "").toUpperCase())) {
     headers["Idempotency-Key"] = `mcp-${Date.now()}-${Math.random().toString(16).slice(2)}`;
   }
+  if (extraHeaders && typeof extraHeaders === "object") {
+    for (const [k, v] of Object.entries(extraHeaders)) {
+      if (typeof v === "string" && v.length > 0) headers[k] = v;
+    }
+  }
 
   const url = `${getBaseUrl()}${pathName}${queryString(query || {})}`;
   const response = await fetch(url, {
@@ -507,6 +585,31 @@ const tools = [
         requireAuth: false,
       }),
   },
+  {
+    name: "tokenlist_get",
+    description:
+      "Fetch the public OpenClawCash Token Lists v1 document covering every supported chain (Mainnet, Polygon, Base, Sepolia, Solana mainnet). Default merges curated + Uniswap (EVM) + Jupiter (Solana). Pass extended=false for curated-only, or chainId=<num> to scope to one chain (1=Mainnet, 137=Polygon, 8453=Base, 11155111=Sepolia, 101=Solana). No API key required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        chainId: { type: "integer", description: "EIP-155 chain id (EVM) or Solana Labs convention (101=mainnet, 102=testnet, 103=devnet). Omit for all chains." },
+        extended: { type: "boolean", description: "Default true: merge Uniswap + Jupiter community lists. Set false for curated-only.", default: true },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => tokenlistArgsSchema.parse(args ?? {}),
+    execute: async (args) => {
+      const query = {};
+      if (typeof args.chainId === "number") query.chainId = String(args.chainId);
+      if (args.extended === false) query.extended = "false";
+      return callAgentApi({
+        method: "GET",
+        pathName: "/api/public/tokenlist",
+        query: Object.keys(query).length > 0 ? query : undefined,
+        requireAuth: false,
+      });
+    },
+  },
   {
     name: "wallets_list",
     description: "List managed wallets accessible to the configured OpenClawCash agent key.",
@@ -548,7 +651,7 @@ const tools = [
   },
   {
     name: "transactions_list",
-    description: "List merged transaction history for one managed wallet.",
+    description: "List merged transaction history for one managed wallet. EVM wallets accept optional `network` to scope to a single EVM chain (e.g. \"base-mainnet\") or `\"all\"` to merge activity across every supported EVM chain into one history. Solana wallets stay scoped to their cluster.",
     inputSchema: {
       type: "object",
       properties: {
@@ -556,6 +659,7 @@ const tools = [
         walletLabel: { type: "string", description: selectorDescription() },
         walletAddress: { type: "string", description: selectorDescription() },
         chain: { type: "string", enum: ["evm", "solana"] },
+        network: { type: "string", description: "Optional EVM network override: a known EVM network id (mainnet, polygon-mainnet, base-mainnet, sepolia) or the literal \"all\" to merge across the bucket. Omit to use the wallet's default chain." },
       },
       additionalProperties: false,
     },
@@ -614,7 +718,7 @@ const tools = [
   {
     name: "transfer_send",
     description: withWriteSafety(
-      "Send a native asset or token transfer from a managed wallet. Do not use for checkout escrow funding; use checkout_quick_pay or checkout_swap_and_pay.",
+      "Send a native asset or token transfer from a managed wallet. EVM wallets accept optional `network` (e.g. \"base-mainnet\") to operate on a non-default EVM chain. Do not use for checkout escrow funding; use checkout_quick_pay or checkout_swap_and_pay.",
     ),
     inputSchema: {
       type: "object",
@@ -623,6 +727,7 @@ const tools = [
         walletLabel: { type: "string" },
         walletAddress: { type: "string" },
         chain: { type: "string", enum: ["evm", "solana"] },
+        network: { type: "string", description: "Optional EVM network override (mainnet, polygon-mainnet, base-mainnet, sepolia). Omit to use the wallet's default chain." },
         to: { type: "string" },
         amountDisplay: { type: "string", description: "Human-readable decimal amount (preferred)." },
         valueBaseUnits: { type: "string", description: "Base-units integer amount (preferred)." },
@@ -698,7 +803,7 @@ const tools = [
   },
   {
     name: "swap_execute",
-    description: withWriteSafety("Execute a swap through OpenClawCash."),
+    description: withWriteSafety("Execute a swap through OpenClawCash. EVM wallets accept optional `network` to operate on a non-default EVM chain (mainnet, polygon-mainnet, base-mainnet, sepolia)."),
     inputSchema: {
       type: "object",
       properties: {
@@ -709,6 +814,7 @@ const tools = [
         amountIn: { type: "string" },
         slippage: { type: "number" },
         chain: { type: "string", enum: ["evm", "solana"] },
+        network: { type: "string", description: "Optional EVM network override; omit to use the wallet's default chain." },
       },
       required: ["tokenIn", "tokenOut", "amountIn"],
       additionalProperties: false,
@@ -723,7 +829,7 @@ const tools = [
   },
   {
     name: "approve_token",
-    description: withWriteSafety("Approve ERC-20 token spending for a managed wallet."),
+    description: withWriteSafety("Approve ERC-20 token spending for a managed wallet. Optional `network` lets EVM wallets approve on a non-default EVM chain (mainnet, polygon-mainnet, base-mainnet, sepolia)."),
     inputSchema: {
       type: "object",
       properties: {
@@ -733,6 +839,7 @@ const tools = [
         spender: { type: "string" },
         amount: { type: "string" },
         chain: { type: "string", enum: ["evm", "solana"] },
+        network: { type: "string", description: "Optional EVM network override; omit to use the wallet's default chain." },
       },
       required: ["tokenAddress", "spender", "amount"],
       additionalProperties: false,
@@ -745,6 +852,77 @@ const tools = [
         body: args,
       }),
   },
+  {
+    name: "bridge_quote",
+    description:
+      "Quote a cross-chain bridge transfer. The aggregator (LiFi) picks the underlying bridge automatically and returns provider+bridgeName so you know which bridge was selected. EVM-EVM is fully supported; Solana source-side execute is gated to a follow-up. Quote TTL ~60s; pass the returned quoteId to bridge_execute.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+        fromNetwork: { type: "string", description: "Source network. EVM-home wallets bucket-route across mainnet, polygon-mainnet, base-mainnet, sepolia." },
+        fromToken: { type: "string", description: "Source token symbol or contract address. Use 'native' for the chain's native gas token." },
+        toNetwork: { type: "string" },
+        toToken: { type: "string" },
+        toAddress: { type: "string", description: "Optional destination address. Defaults to the source wallet address." },
+        amountIn: { type: "string", description: "Source amount in base units (digits only)." },
+        slippagePercent: { type: "number", minimum: 0, maximum: 50 },
+      },
+      required: ["fromNetwork", "fromToken", "toNetwork", "toToken", "amountIn"],
+      additionalProperties: false,
+    },
+    parse: (args) => bridgeQuoteArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "POST",
+        pathName: "/api/agent/bridge/quote",
+        body: args,
+      }),
+  },
+  {
+    name: "bridge_execute",
+    description: withWriteSafety(
+      "Execute a previously quoted cross-chain bridge. Server signs the source-side transaction with the wallet's key, submits to chain, and collects the platform fee. Idempotency is automatic. Returns sourceTxHash; use bridge_status to track destination delivery.",
+    ),
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+        quoteId: { type: "string", description: "Quote identifier returned from bridge_quote." },
+      },
+      required: ["quoteId"],
+      additionalProperties: false,
+    },
+    parse: (args) => bridgeExecuteArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "POST",
+        pathName: "/api/agent/bridge/execute",
+        body: args,
+      }),
+  },
+  {
+    name: "bridge_status",
+    description:
+      "Look up the status of a bridge transfer. Returns the current state (submitted | source_confirmed | destination_confirmed | completed | failed) and, when available, the destination chain tx hash and amount received.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        bridgeTxId: { type: "string", description: "The bridgeTxId returned from bridge_execute (typically the source chain tx hash)." },
+      },
+      required: ["bridgeTxId"],
+      additionalProperties: false,
+    },
+    parse: (args) => bridgeStatusArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/agent/bridge/status",
+        query: { bridgeTxId: args.bridgeTxId },
+      }),
+  },
   {
     name: "wallet_create",
     description: withWriteSafety("Create a new managed wallet under the configured agent key."),
@@ -754,7 +932,7 @@ const tools = [
         label: { type: "string" },
         network: {
           type: "string",
-          enum: ["sepolia", "mainnet", "polygon-mainnet", "solana-devnet", "solana-testnet", "solana-mainnet"],
+          enum: ["sepolia", "mainnet", "polygon-mainnet", "base-mainnet", "solana-devnet", "solana-testnet", "solana-mainnet"],
         },
         exportPassphrase: { type: "string", minLength: 12 },
         exportPassphraseStorageType: { type: "string", enum: ["env", "secret_manager", "vault", "other"] },
@@ -790,12 +968,12 @@ const tools = [
   },
   {
     name: "wallet_import",
-    description: withWriteSafety("Import a mainnet, polygon-mainnet, or Solana mainnet wallet under the configured agent key."),
+    description: withWriteSafety("Import a mainnet, polygon-mainnet, base-mainnet, or Solana mainnet wallet under the configured agent key. EVM wallets work across all EVM chains regardless of which one is chosen here as the home network."),
     inputSchema: {
       type: "object",
       properties: {
         label: { type: "string" },
-        network: { type: "string", enum: ["mainnet", "polygon-mainnet", "solana-mainnet"] },
+        network: { type: "string", enum: ["mainnet", "polygon-mainnet", "base-mainnet", "solana-mainnet"] },
         privateKey: { type: "string" },
       },
       required: ["label", "network", "privateKey"],
@@ -1290,7 +1468,7 @@ const tools = [
   },
   {
     name: "polymarket_order_limit",
-    description: withWriteSafety("Place a Polymarket limit order from a configured polygon-mainnet wallet. Use this for explicit target-price orders; for close-position intent, prefer market SELL unless a limit price is explicitly requested."),
+    description: withWriteSafety("Place a Polymarket limit order from a configured Polymarket-linked EVM wallet. Use this for explicit target-price orders; for close-position intent, prefer market SELL unless a limit price is explicitly requested."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1314,7 +1492,7 @@ const tools = [
   },
   {
     name: "polymarket_order_market",
-    description: withWriteSafety("Place a Polymarket market order from a configured polygon-mainnet wallet. For close-position intent on open markets, default to side=SELL (SELL amount is shares); use limit SELL only for explicit target-price requests."),
+    description: withWriteSafety("Place a Polymarket market order from a configured Polymarket-linked EVM wallet. For close-position intent on open markets, default to side=SELL (SELL amount is shares); use limit SELL only for explicit target-price requests."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1339,7 +1517,7 @@ const tools = [
   },
   {
     name: "polymarket_account",
-    description: "Read Polymarket account summary for a configured polygon-mainnet wallet.",
+    description: "Read Polymarket account summary for a configured Polymarket-linked EVM wallet.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1358,7 +1536,7 @@ const tools = [
   },
   {
     name: "polymarket_orders",
-    description: "List Polymarket open orders for a configured polygon-mainnet wallet.",
+    description: "List Polymarket open orders for a configured Polymarket-linked EVM wallet.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1380,7 +1558,7 @@ const tools = [
   },
   {
     name: "polymarket_cancel_order",
-    description: withWriteSafety("Cancel a Polymarket order for a configured polygon-mainnet wallet."),
+    description: withWriteSafety("Cancel a Polymarket order for a configured Polymarket-linked EVM wallet."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1401,7 +1579,7 @@ const tools = [
   },
   {
     name: "polymarket_clear_integration",
-    description: withWriteSafety("Clear Polymarket integration for a configured polygon-mainnet wallet."),
+    description: withWriteSafety("Clear Polymarket integration for a configured Polymarket-linked EVM wallet."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1420,7 +1598,7 @@ const tools = [
   },
   {
     name: "polymarket_activity",
-    description: "List Polymarket trade activity for a configured polygon-mainnet wallet.",
+    description: "List Polymarket trade activity for a configured Polymarket-linked EVM wallet.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1441,7 +1619,7 @@ const tools = [
   },
   {
     name: "polymarket_positions",
-    description: "List Polymarket open positions (open-market filtered) for a configured polygon-mainnet wallet, including position PnL fields.",
+    description: "List Polymarket open positions (open-market filtered) for a configured Polymarket-linked EVM wallet, including position PnL fields.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1461,7 +1639,7 @@ const tools = [
   },
   {
     name: "polymarket_redeemable",
-    description: "List currently redeemable Polymarket positions and tokenIds for a configured polygon-mainnet wallet.",
+    description: "List currently redeemable Polymarket positions and tokenIds for a configured Polymarket-linked EVM wallet.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1481,7 +1659,7 @@ const tools = [
   },
   {
     name: "polymarket_redeem",
-    description: withWriteSafety("Redeem Polymarket position(s) for a configured polygon-mainnet wallet. The server picks the signing path from the wallet config: signatureType 0 redeems directly on-chain (small POL gas required); 1 / 2 redeems through Polymarket's gasless relayer. Run polymarket_redeemable first to pick a tokenId for single redeem. Omit tokenId to redeem all currently redeemable positions. All-mode is chunked; loop while hasMoreRedeemable=true. Response includes signingPath ('direct' | 'gasless') and signatureType."),
+    description: withWriteSafety("Redeem Polymarket position(s) for a configured Polymarket-linked EVM wallet. The server picks the signing path from the wallet config: signatureType 0 redeems directly on-chain (small POL gas required); 1 / 2 redeems through Polymarket's gasless relayer. Run polymarket_redeemable first to pick a tokenId for single redeem. Omit tokenId to redeem all currently redeemable positions. All-mode is chunked; loop while hasMoreRedeemable=true. Response includes signingPath ('direct' | 'gasless') and signatureType."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1505,6 +1683,80 @@ const tools = [
         body: args,
       }),
   },
+  {
+    name: "yieldwolf_casino_link",
+    description: withWriteSafety("Bind a Solana wallet to a YieldWolf Casino account. Lane is fixed at link time: 'real' = solana-mainnet (default), 'test' = solana-devnet/testnet. The response carries `proxy_base` and a runtime `instructions` payload (skill_doc, summary, flows, responsible_play, lane_note). The raw casino API key is intentionally not returned to the agent: every casino call must go through `yieldwolf_casino_call` so OpenClawCash can enforce wallet ownership, venue scope, and audit. The linked wallet is the only allowed withdrawal destination. To switch lanes later, call yieldwolf_casino_unlink and re-link."),
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+        agentName: { type: "string", description: "Optional agent display name registered at the casino (max 64 chars)." },
+        lane: { type: "string", enum: ["real", "test"], description: "Network lane. Defaults to 'real'." },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => yieldwolfCasinoLinkArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "POST",
+        pathName: "/api/agent/venues/yieldwolf-casino/link",
+        body: args,
+      }),
+  },
+  {
+    name: "yieldwolf_casino_unlink",
+    description: withWriteSafety("Clear the YieldWolf Casino binding for a linked wallet."),
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => yieldwolfCasinoUnlinkArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "POST",
+        pathName: "/api/agent/venues/yieldwolf-casino/unlink",
+        body: args,
+      }),
+  },
+  {
+    name: "yieldwolf_casino_call",
+    description: withWriteSafety("Generic dispatcher for a linked YieldWolf Casino wallet. Routes through OpenClawCash's proxy so wallet ownership, venue scope (read for GET, trade for non-GET), and audit are enforced server-side. `path` is the YieldWolf upstream path (multi-segment paths accepted; e.g. 'agents/me/balance', 'transactions/history', 'games', 'games/info' for reads; 'games/play', 'transactions/withdraw', 'arena/kuhn/check' for writes). `method` defaults to GET. `body` is forwarded verbatim for non-GET calls. Pass `idempotencyKey` so the casino does not double-submit a write on retry. See https://yieldwolf.finance/SKILL.md for the full upstream surface and request shapes."),
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+        method: { type: "string", enum: ["GET", "POST"], description: "HTTP method. Defaults to GET. Use POST for writes (play, withdraw, etc.)." },
+        path: { type: "string", description: "YieldWolf upstream path under /gw/. Multi-segment paths supported (e.g. 'agents/me/balance', 'games/play', 'arena/kuhn/check')." },
+        body: { description: "Optional JSON body, forwarded verbatim to YieldWolf for non-GET calls." },
+        query: { type: "object", additionalProperties: { type: "string" }, description: "Optional extra query params forwarded to YieldWolf (walletId is added automatically)." },
+        idempotencyKey: { type: "string", description: "Optional idempotency key forwarded as X-Idempotency-Key so the casino does not double-submit a write on retry." },
+      },
+      required: ["path"],
+      additionalProperties: false,
+    },
+    parse: (args) => yieldwolfCasinoCallArgsSchema.parse(args ?? {}),
+    execute: async (args) => {
+      const upstreamPath = String(args.path).replace(/^\/+/, "");
+      const method = (args.method || "GET").toUpperCase();
+      const walletQuery =
+        args.walletId !== undefined ? { walletId: String(args.walletId) } : { walletAddress: String(args.walletAddress) };
+      const query = { ...walletQuery, ...(args.query || {}) };
+      const extraHeaders = args.idempotencyKey ? { "X-Idempotency-Key": args.idempotencyKey } : undefined;
+      return callAgentApi({
+        method,
+        pathName: `/api/agent/venues/yieldwolf-casino/proxy/${upstreamPath}`,
+        query,
+        body: method === "GET" ? undefined : args.body,
+        extraHeaders,
+      });
+    },
+  },
 ];
 
 const resources = [

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclawcash/mcp-server",
-  "version": "0.1.16",
-  "description": "OpenClawCash MCP server for managed agent wallets, balances, transfers, swaps, approvals, Get Paid checkout escrow flows, and Polymarket market resolution/order tools.",
+  "version": "0.1.21",
+  "description": "OpenClawCash MCP server for managed agent wallets, balances, transfers, swaps, approvals, cross-chain bridges, Get Paid checkout escrow flows, Polymarket market resolution/order tools, and YieldWolf Casino link/unlink/proxy tools.",
   "type": "module",
   "license": "Proprietary",
   "homepage": "https://openclawcash.com/mcp",