@openclawcash/mcp-server 0.1.21 → 0.1.23

package/README.md

@@ -13,6 +13,8 @@ Wallet and profile tools:
 - `skill_latest` (public install metadata; no API key required)
 - `wallets_list`
 - `wallet_get`
+- `policies_list`
+- `policy_get`
 - `transactions_list`
 - `balances_get`
 - `supported_tokens_list`

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.21";
+const SERVER_VERSION = "0.1.23";
 const PROTOCOL_VERSION = "2024-11-05";
 const DEFAULT_BASE_URL = "https://openclawcash.com";
 
@@ -102,6 +102,7 @@ const walletSelectorSchema = walletSelectorBaseSchema.refine(
 const walletsListArgsSchema = z.object({
   includeBalances: z.boolean().optional(),
 });
+const policiesListArgsSchema = z.object({}).strict();
 const skillLatestArgsSchema = z.object({}).strict();
 
 const tokenlistArgsSchema = z.object({
@@ -248,8 +249,8 @@ const userTagSetArgsSchema = z.object({
     .trim()
     .toLowerCase()
     .min(3)
-    .max(64)
-    .regex(/^[a-z0-9][a-z0-9._-]{2,63}$/),
+    .max(8)
+    .regex(/^[a-z0-9][a-z0-9._-]{2,7}$/),
 });
 
 const polymarketLimitArgsSchema = z
@@ -649,6 +650,44 @@ const tools = [
         query: args,
       }),
   },
+  {
+    name: "policies_list",
+    description:
+      "List active governance policies (spending limits, allowlists, testnet-only, etc.) for every managed wallet accessible to this agent key. Call this before suggesting or executing transfers/swaps so requests stay inside configured limits.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+    parse: (args) => policiesListArgsSchema.parse(args ?? {}),
+    execute: async () =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/agent/policies",
+      }),
+  },
+  {
+    name: "policy_get",
+    description:
+      "Get active governance policies for one managed wallet (whitelist, spending_limit, daily/weekly/monthly_spending_limit, disallow_live_transactions, wallet_purpose, checkout_access, venue_access, max_open_escrows, trusted_counterparty_tags). Call this before suggesting or executing a transfer/swap on the wallet so the request stays inside configured limits.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }], description: selectorDescription() },
+        walletLabel: { type: "string", description: selectorDescription() },
+        walletAddress: { type: "string", description: selectorDescription() },
+        chain: { type: "string", enum: ["evm", "solana"] },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => walletSelectorSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/agent/policy",
+        query: args,
+      }),
+  },
   {
     name: "transactions_list",
     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.",
@@ -1004,11 +1043,11 @@ const tools = [
   },
   {
     name: "user_tag_set",
-    description: withWriteSafety("Set global checkout user tag once (immutable after set)."),
+    description: withWriteSafety("Set global checkout user tag once (immutable after set). 3-8 lowercase characters: a-z, 0-9, '.', '_', '-'."),
     inputSchema: {
       type: "object",
       properties: {
-        userTag: { type: "string" },
+        userTag: { type: "string", minLength: 3, maxLength: 8, pattern: "^[a-z0-9][a-z0-9._-]{2,7}$" },
       },
       required: ["userTag"],
       additionalProperties: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclawcash/mcp-server",
-  "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.",
+  "version": "0.1.23",
+  "description": "OpenClawCash MCP server for managed agent wallets, balances, transfers, swaps, approvals, governance policy checks, 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",