@openclawcash/mcp-server 0.1.13 → 0.1.16

package/README.md

@@ -60,6 +60,8 @@ Polymarket tools:
 - `polymarket_clear_integration`
 - `polymarket_activity`
 - `polymarket_positions`
+- `polymarket_redeemable`
+- `polymarket_redeem`
 
 Utility tool:
 
@@ -289,6 +291,8 @@ The MCP server itself does not hold approval memory. The MCP client or agent run
 - `supported_tokens_list` is read-only, but still requires an agent key.
 - `skill_latest` is read-only and does not require an agent key.
 - `transfer_send`, `swap_execute`, `approve_token`, `wallet_create`, and `wallet_import` are write tools.
+- `polymarket_redeemable` is read-only and lists redeemable tokenIds; use this first for targeted redeem.
+- `polymarket_redeem` is a write tool. For `redeem all` (no tokenId), the API processes in chunks and returns `hasMoreRedeemable`; call again until it becomes `false`.
 - `transfer_send` is for normal wallet transfers. For checkout escrow funding, use checkout tools:
   - `checkout_quick_pay` for direct settlement funding
   - `checkout_swap_and_pay` for asset mismatch funding

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.13";
+const SERVER_VERSION = "0.1.16";
 const PROTOCOL_VERSION = "2024-11-05";
 const DEFAULT_BASE_URL = "https://openclawcash.com";
 
@@ -271,6 +271,17 @@ const polymarketRedeemArgsSchema = z
     walletAddress: z.string().min(1).optional(),
     tokenId: z.string().min(1).optional(),
     limit: z.number().int().positive().max(200).optional(),
+    signatureType: z.union([z.literal(0), z.literal(1), z.literal(2)]).optional(),
+  })
+  .refine((data) => [data.walletId, data.walletAddress].filter((v) => v !== undefined).length === 1, {
+    message: "Provide exactly one of walletId or walletAddress.",
+  });
+
+const polymarketRedeemableArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    limit: z.number().int().positive().max(200).optional(),
   })
   .refine((data) => [data.walletId, data.walletAddress].filter((v) => v !== undefined).length === 1, {
     message: "Provide exactly one of walletId or walletAddress.",
@@ -482,7 +493,7 @@ const tools = [
   {
     name: "skill_latest",
     description:
-      "Get the latest published OpenClawCash skill version, zip URLs, and install instructions. Public endpoint, no API key required.",
+      "Get the latest published OpenClawCash skill version, GitHub repo URL, and install instructions. Public endpoint, no API key required.",
     inputSchema: {
       type: "object",
       properties: {},
@@ -1448,9 +1459,29 @@ const tools = [
         query: args,
       }),
   },
+  {
+    name: "polymarket_redeemable",
+    description: "List currently redeemable Polymarket positions and tokenIds for a configured polygon-mainnet wallet.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        walletAddress: { type: "string" },
+        limit: { type: "integer", description: "Optional max redeemable positions to scan (1-200)." },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => polymarketRedeemableArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/agent/venues/polymarket/redeemable",
+        query: args,
+      }),
+  },
   {
     name: "polymarket_redeem",
-    description: withWriteSafety("Redeem Polymarket position(s) via gasless relay for a configured polygon-mainnet wallet. Pass tokenId to redeem one position, or omit tokenId to redeem all currently redeemable positions."),
+    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."),
     inputSchema: {
       type: "object",
       properties: {
@@ -1458,6 +1489,11 @@ const tools = [
         walletAddress: { type: "string" },
         tokenId: { type: "string", description: "Optional outcome tokenId. Omit to redeem all redeemable positions." },
         limit: { type: "integer", description: "Optional max redeemable positions to scan (1-200, default 100)." },
+        signatureType: {
+          type: "integer",
+          enum: [0, 1, 2],
+          description: "Optional defensive assertion (0 = direct EOA, 1 = proxy, 2 = Gnosis Safe). Server returns 400 if it does not match the wallet's configured signing type. Omit to dispatch by wallet config.",
+        },
       },
       additionalProperties: false,
     },
@@ -1492,14 +1528,14 @@ const resources = [
     text: [
       "# OpenClawCash MCP Quickstart",
       "",
-      "1. Run `skill_latest` to fetch the latest skill zip URL and install instructions.",
+      "1. Run `skill_latest` to fetch the latest skill version, GitHub repo URL, and install instructions.",
       "2. Configure `OPENCLAWCASH_AGENT_KEY` or `AGENTWALLETAPI_KEY` for authenticated tools.",
       "3. Use `wallets_list` first to discover managed wallets.",
       "4. Use `wallet_get` or `balances_get` before write actions.",
       "5. For writes, establish approval mode once per session.",
       "6. For checkout escrow funding, use `checkout_fund` (quick-pay first, swap fallback when needed).",
       "7. Use `swap_quote` before `swap_execute` for non-checkout swaps.",
-      "8. For Polymarket: ask your human to complete setup in dashboard (/venues/polymarket), then place/cancel/redeem and inspect account/activity/positions via polymarket tools.",
+      "8. For Polymarket: ask your human to complete setup in dashboard (/venues/polymarket), then place/cancel/redeem and inspect account/activity/positions/redeemable via polymarket tools.",
     ].join("\n"),
   },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawcash/mcp-server",
-  "version": "0.1.13",
+  "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.",
   "type": "module",
   "license": "Proprietary",