Z Zero MCP
Let AI agents pay at online shops with single-use virtual cards funded by USDC on Base
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 1.11.0
- Listing updated
- 4 days ago
Similar MCP servers
About Z Zero MCP
Z Zero MCP is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
The central idea is that the model never sees a card number. An agent requests a payment token for an exact amount, a single-use card is issued and capped at that amount, and the details are filled in locally through Playwright at checkout, then wiped from memory. The README describes cards as amount-locked with a one-hour lifetime.
The agent's wallet holds USDC on Base, with gas sponsored, and the site says human approval is part of the workflow. Before checkout, execute_payment hands back the criteria the agent recorded and needs a second call with go or pause, and a confirmed purchase seals that answer into a signed receipt.
get_merchant_hints serves checkout playbooks for platforms such as Shopify, Etsy and WooCommerce. Failed checkouts are labelled with one of 14 failure classes. It runs over stdio via npx z-zero-mcp-server and needs a Passport Key from the Z-ZERO dashboard.
Install
Run in a terminal
claude mcp add z-zero-mcp --env Z_ZERO_API_KEY='<Z_ZERO_API_KEY>' -- npx -y z-zero-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"z-zero-mcp": {
"command": "npx",
"args": [
"-y",
"z-zero-mcp-server"
],
"env": {
"Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"z-zero-mcp": {
"command": "npx",
"args": [
"-y",
"z-zero-mcp-server"
],
"env": {
"Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"z-zero-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"z-zero-mcp-server"
],
"env": {
"Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"z-zero-mcp": {
"command": "npx",
"args": [
"-y",
"z-zero-mcp-server"
],
"env": {
"Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"z-zero-mcp": {
"command": "npx",
"args": [
"-y",
"z-zero-mcp-server"
],
"env": {
"Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
Z_ZERO_API_KEYPassport Key (zk_live_...) from z-zero.xyz/dashboard/agentsRequired
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- get_merchant_hints
- Return checkout playbooks for a merchant or platform such as Shopify.
- request_payment_token
- Request a payment token for an amount, cart and criteria.
- execute_payment
- Run the checkout with the token, confirming the recorded criteria with go or pause.
What it does
- Single-use virtual cards
- Cards are amount-locked, last one hour and are burned after one use.
- Card data kept from the model
- Number, CVV and expiry exist only in RAM and are injected at the last step, then wiped.
- Gasless USDC funding
- The agent wallet holds USDC on Base with gas sponsored by Coinbase Paymaster.
- Checkout playbooks
- `get_merchant_hints` returns platform-specific steps for stores like Shopify, Etsy and WooCommerce.
- Signed purpose and outcome
- Criteria recorded at issuance are signed and sealed into the receipt after a confirmed purchase.
- Failure labels
- Failed checkouts get a fixed 14-class failure label stored as evidence for merchant hints.
Good for
- Let an agent buy an item on a Shopify store within a set budget
- Pay a card-only merchant from a USDC balance
- Audit what an agent said it was buying versus the receipt
- Reduce copy-pasting card details into agent workflows
Pricing
Pricing unknown
Pricing not published; requires a Z-ZERO account key
Prices change. Check z-zero.xyz before you buy.
Z Zero MCP FAQ
Does the agent ever see the card number?
No. The README says the model never sees the PAN, CVV or expiry; they are injected locally at the last step.
What do I need to run it?
Run `npx z-zero-mcp-server` with a Z_ZERO_API_KEY Passport Key from the Z-ZERO dashboard.
How long is a card valid?
Cards are single-use with a one-hour time to live.
Which currency funds it?
USDC on Base, with gas sponsored.
How do I add Z Zero MCP to Claude Code?
Run this command in your terminal: claude mcp add z-zero-mcp --env Z_ZERO_API_KEY='<Z_ZERO_API_KEY>' -- npx -y z-zero-mcp-server
What are the best alternatives to Z Zero MCP?
The closest alternatives to Z Zero MCP are MCP, PurseString, Payments Ai MCP, XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP and MCP Agentic Wallet — open-source session management for x402.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.