# Z Zero MCP

> Z Zero MCP is an MCP server for finance and payments. Let AI agents pay at online shops with single-use virtual cards funded by USDC on Base. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://z-zero.xyz
- **Repository:** https://github.com/dempty-glitch/z-zero-mcp
- **MCP Registry name:** io.github.Dempty-glitch/z-zero-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add z-zero-mcp --env Z_ZERO_API_KEY='<Z_ZERO_API_KEY>' -- npx -y z-zero-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "z-zero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "z-zero-mcp-server"
      ],
      "env": {
        "Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "z-zero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "z-zero-mcp-server"
      ],
      "env": {
        "Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "z-zero-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "z-zero-mcp-server"
      ],
      "env": {
        "Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "z-zero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "z-zero-mcp-server"
      ],
      "env": {
        "Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "z-zero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "z-zero-mcp-server"
      ],
      "env": {
        "Z_ZERO_API_KEY": "<Z_ZERO_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [MCP](https://ai-powered.com/mcp/mcp-mwep27q8): MCP is a paid MCP server for e-commerce.
- [PurseString](https://ai-powered.com/mcp/pursestring): PurseString is an open-source MCP server for finance and payments.
- [Payments Ai MCP](https://ai-powered.com/mcp/payments-ai-mcp-2): Payments Ai MCP is a paid MCP server for finance and payments.
- [XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP](https://ai-powered.com/mcp/xpayr-non-custodial-crypto-gateway-and-ai-agent-commerce-mcp): XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP is a paid MCP server for finance and payments.
- [MCP Agentic Wallet — open-source session management for x402](https://ai-powered.com/mcp/mcp-agentic-wallet-open-source-session-management-for-x402): MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments.
- [Pink Agentic AI Payments](https://ai-powered.com/mcp/pink-agentic-ai-payments): Pink Agentic AI Payments is a freemium MCP server for finance and payments.
- [SpendTheBits Gift Cards](https://ai-powered.com/mcp/spendthebits-gift-cards): SpendTheBits Gift Cards is a paid MCP server for finance and payments.
- [Voidpay Marketplace](https://ai-powered.com/mcp/voidpay-marketplace): Voidpay Marketplace is a free MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/z-zero-mcp
