@openclawcash/mcp-server 0.1.10 → 0.1.12

package/README.md

@@ -50,6 +50,7 @@ Get Paid checkout tools:
 Polymarket tools:
 
 - `polymarket_market_resolve`
+- `polymarket_market_search`
 - `polymarket_order_limit`
 - `polymarket_order_market`
 - `polymarket_account`
@@ -173,6 +174,27 @@ Typical config shape:
 }
 ```
 
+## OpenAI Codex Example
+
+If your OpenAI Codex environment supports MCP server configuration, use the same local stdio command pattern:
+
+```json
+{
+  "mcpServers": {
+    "openclawcash": {
+      "command": "npx",
+      "args": ["-y", "@openclawcash/mcp-server"],
+      "env": {
+        "OPENCLAWCASH_AGENT_KEY": "occ_your_api_key_here",
+        "OPENCLAWCASH_BASE_URL": "https://openclawcash.com"
+      }
+    }
+  }
+}
+```
+
+If your Codex setup expects a different config file location or wrapper schema, keep the same `command`, `args`, and `env` values and adapt only the surrounding structure required by that client.
+
 ## Cursor Example
 
 You can print a config snippet with:

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.10";
+const SERVER_VERSION = "0.1.12";
 const PROTOCOL_VERSION = "2024-11-05";
 const DEFAULT_BASE_URL = "https://openclawcash.com";
 
@@ -264,6 +264,17 @@ const polymarketCancelArgsSchema = z
     message: "Provide exactly one of walletId or walletAddress.",
   });
 
+const polymarketRedeemArgsSchema = z
+  .object({
+    walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    walletAddress: z.string().min(1).optional(),
+    tokenId: 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.",
+  });
+
 const polymarketUnlinkArgsSchema = z
   .object({
     walletId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
@@ -283,6 +294,11 @@ const polymarketMarketResolveArgsSchema = z
     message: "Provide exactly one of marketUrl or slug.",
   });
 
+const polymarketMarketSearchArgsSchema = z.object({
+  query: z.string().min(2),
+  limit: z.number().int().positive().max(50).optional(),
+});
+
 const checkoutEscrowIdArgsSchema = z.object({
   id: z.string().min(1),
 });
@@ -1223,6 +1239,26 @@ const tools = [
         query: args,
       }),
   },
+  {
+    name: "polymarket_market_search",
+    description: "Search Polymarket markets by query text. Use this when market_resolve returns market_not_found.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search string for market slug/question." },
+        limit: { type: "number", description: "Optional max results (1-50)." },
+      },
+      required: ["query"],
+      additionalProperties: false,
+    },
+    parse: (args) => polymarketMarketSearchArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/agent/venues/polymarket/market/search",
+        query: args,
+      }),
+  },
   {
     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."),
@@ -1394,6 +1430,27 @@ const tools = [
         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."),
+    inputSchema: {
+      type: "object",
+      properties: {
+        walletId: { oneOf: [{ type: "integer" }, { type: "string" }] },
+        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)." },
+      },
+      additionalProperties: false,
+    },
+    parse: (args) => polymarketRedeemArgsSchema.parse(args ?? {}),
+    execute: async (args) =>
+      callAgentApi({
+        method: "POST",
+        pathName: "/api/agent/venues/polymarket/redeem",
+        body: args,
+      }),
+  },
 ];
 
 const resources = [
@@ -1423,7 +1480,7 @@ const resources = [
       "4. For writes, establish approval mode once per session.",
       "5. For checkout escrow funding, use `checkout_fund` (quick-pay first, swap fallback when needed).",
       "6. Use `swap_quote` before `swap_execute` for non-checkout swaps.",
-      "7. For Polymarket: ask your human to complete setup in dashboard (/venues/polymarket), then place/cancel orders and inspect account/activity/positions via polymarket tools.",
+      "7. For Polymarket: ask your human to complete setup in dashboard (/venues/polymarket), then place/cancel/redeem and inspect account/activity/positions via polymarket tools.",
     ].join("\n"),
   },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawcash/mcp-server",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "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",