Public npm package for agent-first wallet tooling

OpenClawCash MCP Server

Connect managed wallet tools to OpenClaw, OpenAI Codex-style runtimes, Claude Desktop, Cursor, or VS Code through one public MCP package. No app to create, no secrets to manage and no policy code to write: set limits in the dashboard, give your agent one scoped API key, and it is ready.

Public install path

Use npx or install globally. No repo checkout required.

API-key protected

The package is public. Most MCP tools use authenticated OpenClawCash agent API routes. One bootstrap read tool (`skill_latest`) is public and returns the latest skill version, GitHub repo URL, and install metadata.

Agent-ready tool surface

Wallet, user tag, checkout escrow lifecycle, swap, approvals, wallet creation/import, and Polymarket venue tools are exposed as MCP tools. Redeem-all flows are chunked and return hasMoreRedeemable for safe retry loops.

Install and verify

This is the easiest public setup path. Users install nothing in your repo. They just run the package and configure one API key.

Run with npxAgent-ready

text

1npx -y @openclawcash/mcp-server

Verify before IDE setupAgent-ready

text

1npx -y @openclawcash/mcp-server --self-test
2npx -y @openclawcash/mcp-server --print-openclaw-config

What users need

Runtime

Node.js 20+

Agent key env var

AGENTWALLETAPI_KEY

Optional base URL env var

AGENTWALLETAPI_URL

MCP client

OpenClaw or MCP-compatible agent

Write approval mode

confirm_each_writeoperate_on_my_behalf

IDE and agent config examples

OpenClawCash

Use the same stdio MCP shape and point it at the public package.

OpenClawCash MCP configAgent-ready

json

1{
2  "mcpServers": {
3    "openclawcash": {
4      "command": "npx",
5      "args": ["-y", "@openclawcash/mcp-server"],
6      "env": {
7        "AGENTWALLETAPI_KEY": "occ_your_api_key_here",
8        "AGENTWALLETAPI_URL": "https://openclawcash.com"
9      }
10    }
11  }
12}

Claude Desktop

Run the package through npx and pass your agent key through env.

Claude Desktop MCP configAgent-ready

json

1{
2  "mcpServers": {
3    "openclawcash": {
4      "command": "npx",
5      "args": ["-y", "@openclawcash/mcp-server"],
6      "env": {
7        "AGENTWALLETAPI_KEY": "occ_your_api_key_here",
8        "AGENTWALLETAPI_URL": "https://openclawcash.com"
9      }
10    }
11  }
12}

Cursor

If your Cursor build supports MCP, the same config works.

Cursor MCP configAgent-ready

json

1{
2  "mcpServers": {
3    "openclawcash": {
4      "command": "npx",
5      "args": ["-y", "@openclawcash/mcp-server"],
6      "env": {
7        "AGENTWALLETAPI_KEY": "occ_your_api_key_here",
8        "AGENTWALLETAPI_URL": "https://openclawcash.com"
9      }
10    }
11  }
12}

OpenAI Codex

Use the same stdio MCP command, args, and env values in MCP-capable OpenAI agent runtimes.

OpenAI Codex MCP configAgent-ready

json

1{
2  "mcpServers": {
3    "openclawcash": {
4      "command": "npx",
5      "args": ["-y", "@openclawcash/mcp-server"],
6      "env": {
7        "AGENTWALLETAPI_KEY": "occ_your_api_key_here",
8        "AGENTWALLETAPI_URL": "https://openclawcash.com"
9      }
10    }
11  }
12}

Approval model

Write tools are intentionally high-risk. Agents should ask once at the first write intent whether the user wants confirm_each_write or operate_on_my_behalf for the current session.

confirm_each_write

Ask before every transfer, swap, approval, import, or wallet creation.

operate_on_my_behalf

After onboarding approval, execute later write requests in the same session without re-asking.

read_only_discovery

Allow only wallet reads, balances, quotes, and metadata until the user explicitly enables writes.

session_write_window

Grant write access for a limited active session window, then revert automatically to confirmation mode.

Tool surface

The MCP server is a thin adapter over https://openclawcash.com/api/agent/*. It exposes a clean tool set instead of forcing every client to parse a long skill file first.

skill_latestwallets_listwallet_getwallet_renametransactions_listbalances_getsupported_tokens_listuser_tag_getuser_tag_settransfer_sendswap_quoteswap_executeapprove_tokenwallet_createwallet_importcheckout_payreq_createcheckout_payreq_getcheckout_escrow_getcheckout_funding_confirmcheckout_acceptcheckout_proof_submitcheckout_dispute_opencheckout_quick_paycheckout_swap_and_paycheckout_fundcheckout_releasecheckout_refundcheckout_cancelcheckout_webhooks_listcheckout_webhook_createcheckout_webhook_updatecheckout_webhook_deletepolymarket_order_limitpolymarket_order_marketpolymarket_market_resolvepolymarket_accountpolymarket_orderspolymarket_cancel_orderpolymarket_clear_integrationpolymarket_activitypolymarket_positionspolymarket_redeemablepolymarket_redeemopenclawcash-self-test