OpenClaw MCP Setup Guide

Connect your AI Agent to Z-ZERO payment network. Step-by-step for beginners.

Back
🤖 For AI Agents — Quick Reference

If you're an AI agent reading this page, here's everything you need:

## OpenClaw MCP — Installation Summary **Package:** z-zero-mcp-server (npm) **Purpose:** Connect AI agents to Z-ZERO payment network ### 1. Install (one command) npx -y z-zero-mcp-server@latest ### 2. JSON Config (add to agent's MCP config file) { "mcpServers": { "openclaw": { "command": "npx", "args": ["-y", "z-zero-mcp-server@latest"], "env": { "Z_ZERO_API_KEY": "<ASK_USER_FOR_KEY>", "Z_ZERO_INTERNAL_SECRET": "<ASK_USER_FOR_SECRET>", "Z_ZERO_API_BASE_URL": "https://www.clawcard.store" } } } } ### 3. Config file locations - Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json - Cursor: Settings → Features → MCP → Add New - AntiGravity: Auto-detected via MCP protocol ### 4. Passport Key - User must sign in at https://www.clawcard.store/login - Then go to Dashboard → Agents → Create Agent Key - Key format: zk_live_xxxxx ### 5. Verify Ask: "Check my Z-ZERO balance" Expected: Card alias + balance response ### Auto-install (Mac/Linux) curl -sSL https://www.clawcard.store/install-mcp.sh | bash ### Auto-install (Windows PowerShell) iex (iwr https://www.clawcard.store/install-mcp.ps1).Content ### 🔄 Maintenance - Version warnings arrive automatically via the X-MCP-Version response header — no action needed. - visit https://www.clawcard.store/docs/agent/checkoutform → read latest checkout patterns

💡 Human users: This block is for your AI agent to read. Follow the step-by-step guide below instead.

What You Need

✅ A Passport Key from your dashboard (starts with zk_live_)

✅ An AI Agent app installed on your computer (e.g. Claude Desktop, Cursor, or AntiGravity)

✅ Node.js v18+ (we'll install it below if you don't have it)

Step 1: Install Node.js

Node.js is required to run the MCP server. Check if you already have it:

🍎 macOS

1. Press ⌘ Cmd + Space to open Spotlight

2. Type Terminal and press Enter

3. In the Terminal window, type:

node --version

If you see v18 or higher, skip to Step 2. Otherwise, install it:

brew install node

Don't have Homebrew? Install it first: brew.sh

🪟 Windows

1. Press Win key, type PowerShell, click “Run as Administrator”

2. Type:

node --version

If not installed:

winget install OpenJS.NodeJS

Or download from: nodejs.org

🐧 Linux (Ubuntu/Debian)

1. Open Terminal (Ctrl+Alt+T)

2. Run:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt-get install -y nodejs
Step 2: Add OpenClaw MCP to Your AI Agent

Add this configuration to your AI Agent. Replace YOUR_KEY_HERE with your Passport Key, and YOUR_INTERNAL_SECRET with the internal secret from Dashboard → Agents (required for completing payments). Z_ZERO_API_BASE_URL can stay as the default.

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["-y", "z-zero-mcp-server"],
      "env": {
        "Z_ZERO_API_KEY": "YOUR_KEY_HERE",
        "Z_ZERO_INTERNAL_SECRET": "YOUR_INTERNAL_SECRET",
        "Z_ZERO_API_BASE_URL": "https://www.clawcard.store"
      }
    }
  }
}

📁 Claude Desktop

Menu → Settings → Developer → Edit Config → Paste the JSON above

File: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

File: %APPDATA%\Claude\claude_desktop_config.json (Windows)

📁 Cursor

Settings → Features → MCP → Add New → Paste the JSON

📁 Other Agents

Ask your agent: “Install MCP package z-zero-mcp-server with my key: zk_live_...”

Step 3: Restart & Verify

After saving the config, close and reopen your AI Agent app.

Then ask your agent:

“Check my Z-ZERO balance”

If everything works, you'll see your card alias and balance. 🎉

Error? Make sure your Passport Key is correct. Get a new one at dashboard/agents.

Security

🔒 Your AI Agent will never see real card numbers.

🔒 All payments use single-use tokens that self-destruct.

🔒 You always approve transactions before they happen.

🤖 AI Agent? Read the full Payment SOP before your first purchase: clawcard.store/docs/agent/skill
Package: npmjs.com/package/z-zero-mcp-server