cardzero-mcp
Provides tools for managing smart-contract wallets, checking USDC balances, sending payments, paying x402-protected resources, and handling ERC-8183 escrow jobs on the Base L2 (Ethereum).
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.
Related MCP server: x402tools MCP Server
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-mcpOr 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:
cardzeroCommand:
npx -y cardzero-mcpEnvironment 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
Variable | Required | Description |
| Yes (for tool calls) | Agent API Key ( |
| Yes (for wallet-scoped tools) | Wallet ID ( |
| No | API base URL — default |
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
Tool | Description |
| Create a new CardZero wallet. Returns address + one-time claim key for the human owner. No auth required. |
| Check current USDC balance of your wallet. |
| Send USDC to any Ethereum address. 2% fee deducted from your wallet. |
| View recent payment history. |
| Look up a specific payment by ID. No auth required. |
x402
Tool | Description |
| Pay for an x402-protected HTTP resource. Returns a payment header to retry the request with. |
ERC-8183 Jobs (escrow / A2A service delivery)
Tool | Description |
| Create a Job that escrows USDC until a Provider delivers and an Evaluator approves. |
| Lock the budget into escrow. Status: |
| Provider submits a deliverable. Status: |
| Read current state (status, txs, evaluation outcome). No auth required — Job state is public. |
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 ./distResources
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
Available Tools
10 toolscreate_jobA
Create a Job that escrows USDC payment until a Provider delivers and an Evaluator approves. Use this for A2A service delivery (vs send_payment for direct transfers). Confirm budget + provider with user first. Provider must have a CardZero wallet (Sprint 9 MVP requirement).
Inputs: providerAddress (required), budgetUsdc (required), expiredAt (required), title (required), +3 more.
create_walletA
Create a new CardZero wallet. Returns a wallet address and one-time claim key for the human owner. No authentication required.
Inputs: name.
fund_jobA
Fund a Job created via create_job. Locks the budget USDC into escrow. Requires that the Job is in 'open' state. Two on-chain operations: USDC.approve(jobs) + Jobs.fund. Status: open → funded.
Inputs: jobId (required).
get_balanceA
Check the current USDC balance of your CardZero wallet.
Inputs: no named parameters.
get_jobA
Get the current state of a Job (status, budget, transactions, evaluation outcome). No authentication required — Job state is public.
Inputs: jobId (required).
get_paymentA
Check the status of a specific payment by its ID. No authentication required.
Inputs: paymentId (required).
list_paymentsB
View recent payment history for your CardZero wallet.
Inputs: limit, offset.
pay_x402A
Pay for an x402-protected HTTP resource (HTTP 402 Payment Required). Use after receiving a 402 response. Returns a paymentHeader to include in the retry request as X-PAYMENT header.
Inputs: url (required), maxAmount (required), recipient (required), network, +2 more.
send_paymentA
Send a USDC payment to any Ethereum address. A 2% service fee is deducted automatically from your wallet. Confirm amount and recipient with the user before calling.
Inputs: to (required), amount (required), memo, idempotencyKey.
submit_jobA
Submit a deliverable for a Job (Provider side). Posts the deliverable hash on-chain; Evaluator then auto-approves or rejects. Status: funded → submitted.
Inputs: jobId (required), contentHash (required), contentURI.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Tools have distinct purposes overall, but send_payment and pay_x402 both involve sending payments, potentially causing slight confusion. Descriptions help differentiate them.
All tools follow a consistent verb_noun pattern with underscores, e.g., create_job, get_balance, send_payment. No mixing of styles.
10 tools cover the core wallet and job escrow functionality without being excessive or insufficient for the stated purpose.
Core workflows are covered, but missing tools like list_jobs or cancel_job could hinder full lifecycle management. Minor gap.
Maintenance
Related MCP Connectors
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Paid tools for AI agents via x402 (USDC on Base): text rewrite, writing grade, code lookups.
Give your AI agent an x402 wallet: discover and pay for services in USDC, or earn from your own.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceUSDC payments for AI agents on Base. Direct transfers, pre-funded tabs, x402 paywall handling, and service discovery.76 npmMIT
- AlicenseAqualityDmaintenanceProvides AI agents with 10 pay-per-call utility tools (QR generation, DNS lookup, OCR, etc.) using USDC on Base via the x402 protocol, with agent's private key never leaving the agent.11MIT

token4u-mcpofficial
AlicenseAqualityCmaintenanceEnables AI agents to call LLM APIs via x402 micropayments in USDC on Base network, manage a local wallet, and query consumption records.353 npmMIT- AlicenseNot gradedqualityBmaintenanceEnables AI agents to check their wallet address and USDC balance, preview the cost of an x402 call, and pay for API requests in USDC on Base without an account or API key. Spend caps, allow-lists and blocked contracts are enforced in code before anything is signed, so a prompt injection cannot bypass them.1MIT