@openclawcash/mcp-server 0.1.12 → 0.1.13

package/README.md

@@ -10,6 +10,7 @@ Canonical docs page: `https://openclawcash.com/mcp`
 
 Wallet and profile tools:
 
+- `skill_latest` (public install metadata; no API key required)
 - `wallets_list`
 - `wallet_get`
 - `transactions_list`
@@ -102,7 +103,7 @@ Set one of these environment variables:
 - `OPENCLAWCASH_AGENT_KEY`
 - `AGENTWALLETAPI_KEY`
 
-All MCP tools require an OpenClawCash agent key because they call the authenticated agent API, including read tools such as `swap_quote` and `supported_tokens_list`.
+Most MCP tools require an OpenClawCash agent key because they call authenticated agent API routes. `skill_latest` is the only no-auth tool and calls `GET /api/public/agentwalletapi/skill/latest`.
 
 Optional base URL override:
 
@@ -286,6 +287,7 @@ The MCP server itself does not hold approval memory. The MCP client or agent run
 
 - `swap_quote` is read-only, but still requires an agent key.
 - `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.
 - `transfer_send` is for normal wallet transfers. For checkout escrow funding, use checkout tools:
   - `checkout_quick_pay` for direct settlement 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.12";
+const SERVER_VERSION = "0.1.13";
 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 skillLatestArgsSchema = z.object({}).strict();
 
 const balancesArgsSchema = z
   .object({
@@ -478,6 +479,23 @@ function withWriteSafety(description) {
 }
 
 const tools = [
+  {
+    name: "skill_latest",
+    description:
+      "Get the latest published OpenClawCash skill version, zip URLs, and install instructions. Public endpoint, no API key required.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+    parse: (args) => skillLatestArgsSchema.parse(args ?? {}),
+    execute: async () =>
+      callAgentApi({
+        method: "GET",
+        pathName: "/api/public/agentwalletapi/skill/latest",
+        requireAuth: false,
+      }),
+  },
   {
     name: "wallets_list",
     description: "List managed wallets accessible to the configured OpenClawCash agent key.",
@@ -1474,13 +1492,14 @@ const resources = [
     text: [
       "# OpenClawCash MCP Quickstart",
       "",
-      "1. Configure `OPENCLAWCASH_AGENT_KEY` or `AGENTWALLETAPI_KEY`.",
-      "2. Use `wallets_list` first to discover managed wallets.",
-      "3. Use `wallet_get` or `balances_get` before write actions.",
-      "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/redeem and inspect account/activity/positions via polymarket tools.",
+      "1. Run `skill_latest` to fetch the latest skill zip 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.",
     ].join("\n"),
   },
 ];

package/package.json

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