cardzero-mcp

MCP Server for CardZero — a smart-contract wallet for AI agents on Base, denominated in USDC.

Gives your AI agent the ability to:

• Create wallets and check USDC balances

• Send direct USDC payments (2% platform fee)

• Pay x402-protected HTTP resources (HTTP 402 paywall)

• Run ERC-8183 escrow Jobs for A2A service delivery (2% platform + 5% evaluator fee)

• Look up payment / job state on-chain

CardZero is the underlying API layer; this MCP wraps the REST endpoints so any MCP-aware client (Claude Desktop, Claude Code, Cursor, VS Code, …) can call them via stdio.

Prerequisites

A CardZero API Key and Wallet ID, obtained from the CardZero Dashboard after claiming a wallet.

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cardzero": {
      "command": "npx",
      "args": ["-y", "cardzero-mcp"],
      "env": {
        "CARDZERO_API_KEY": "czapi_...",
        "CARDZERO_WALLET_ID": "wallet_..."
      }
    }
  }
}

Claude Code

claude mcp add cardzero -- npx -y cardzero-mcp

Or add to .mcp.json in your project:

{
  "mcpServers": {
    "cardzero": {
      "command": "npx",
      "args": ["-y", "cardzero-mcp"],
      "env": {
        "CARDZERO_API_KEY": "czapi_...",
        "CARDZERO_WALLET_ID": "wallet_..."
      }
    }
  }
}

Cursor

Settings → MCP Servers → Add new server:

• Name: cardzero

• Command: npx -y cardzero-mcp

• Environment variables: CARDZERO_API_KEY, CARDZERO_WALLET_ID

VS Code

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "cardzero": {
        "command": "npx",
        "args": ["-y", "cardzero-mcp"],
        "env": {
          "CARDZERO_API_KEY": "czapi_...",
          "CARDZERO_WALLET_ID": "wallet_..."
        }
      }
    }
  }
}

Environment Variables

The server starts and responds to tools/list even without these vars — individual tool calls then return a clean config_missing error.

Available Tools (10)

Direct payments

x402

ERC-8183 Jobs (escrow / A2A service delivery)

How it works

This MCP server is a thin client that calls the CardZero REST API. It runs locally on your machine and communicates with your AI assistant over stdio. No data is stored locally.

AI Assistant (Claude / Cursor / VS Code)
  ⇅ stdio (JSON-RPC)
cardzero-mcp (local Node process)
  ⇅ HTTPS
api.cardzero.ai → Base mainnet (USDC + ERC-4337 + ERC-8004 + ERC-8183)

Development

git clone https://github.com/mrocker/cardzero-mcp.git
cd cardzero-mcp
npm install
npm run dev   # tsx-watch the source
npm run build # compile to ./dist

Resources

• Website: https://cardzero.ai

• Docs: https://cardzero.ai/docs

• API reference: https://cardzero.ai/docs/api-reference/overview

• Full LLM-friendly corpus: https://cardzero.ai/llms-full.txt

• Mainnet contracts: documented in /docs/reference/contracts

License

MIT