@openclawcash/mcp-server 0.1.16 → 0.1.20

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.20";
 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),
 });
 
@@ -507,6 +543,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 +609,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 +617,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 +676,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 +685,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 +761,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 +772,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 +787,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 +797,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 +810,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 +890,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 +926,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 +1426,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 +1450,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 +1475,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 +1494,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 +1516,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 +1537,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 +1556,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 +1577,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 +1597,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 +1617,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: {

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.20",
+  "description": "OpenClawCash MCP server for managed agent wallets, balances, transfers, swaps, approvals, cross-chain bridges, Get Paid checkout escrow flows, and Polymarket market resolution/order tools.",
   "type": "module",
   "license": "Proprietary",
   "homepage": "https://openclawcash.com/mcp",