@cipherpay/mcp

MCP server for CipherPay — let AI agents create Zcash invoices, verify shielded payments, and check statuses.

Works with Claude Desktop, Cursor, and any MCP-compatible client.

Install

npm install -g @cipherpay/mcp

Or run directly with npx:

npx @cipherpay/mcp

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cipherpay": {
      "command": "npx",
      "args": ["@cipherpay/mcp"],
      "env": {
        "CIPHERPAY_API_KEY": "cpay_sk_your_api_key_here"
      }
    }
  }
}

Cursor

Go to Settings > Tools & MCP > Add Custom MCP. Paste into the mcp.json that opens:

{
  "mcpServers": {
    "cipherpay": {
      "command": "npx",
      "args": ["@cipherpay/mcp"],
      "env": {
        "CIPHERPAY_API_KEY": "cpay_sk_your_api_key_here"
      }
    }
  }
}

Save, then reload the window (Cmd+Shift+P > "Reload Window").

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CIPHERPAY_API_KEY | For invoices + x402 | Your CipherPay API key (cpay_sk_...) | | CIPHERPAY_API_URL | No | API URL (default: https://api.cipherpay.app) |

Tools that don't require authentication (get_exchange_rates, get_invoice_status, get_product_info) work without an API key.

Tools

get_exchange_rates

Get current ZEC exchange rates against fiat currencies.

"What's the current ZEC price in USD?"

create_invoice

Create a Zcash payment invoice with amount, currency, and optional product details. Returns a payment address, ZIP-321 URI, and expiry time.

"Create an invoice for $25 USD" "Create an invoice for 50 EUR for product 'Annual Plan'"

get_invoice_status

Check if an invoice has been paid. Returns: pending, detected, confirmed, expired, or cancelled.

"Has invoice CP-1234 been paid?" "Check the status of invoice 8f3a..."

verify_x402_payment

Verify a shielded Zcash payment by transaction ID. For x402 (HTTP 402) resource servers that need to confirm a client's payment claim.

"Verify that transaction abc123... paid 0.001 ZEC"

get_product_info

Get product details and available prices from CipherPay.

"Show me the details for product 'premium-api'"

Resources

| URI | Description | |-----|-------------| | cipherpay://rates | Live ZEC exchange rates | | cipherpay://invoice/{id} | Invoice details by ID or memo code |

How It Works

The MCP server runs locally on your machine and acts as a bridge between your AI assistant and the CipherPay API:

AI Assistant (Claude, Cursor)
       │
       │ stdio (local, JSON-RPC)
       ▼
  @cipherpay/mcp (local process)
       │
       │ HTTPS (your API key)
       ▼
  api.cipherpay.app

Your API key stays on your machine. The MCP server makes authenticated REST calls to CipherPay on behalf of your AI assistant.

Get a CipherPay Account

1. Go to cipherpay.app and register as a merchant.
2. Provide your Zcash Unified Full Viewing Key (read-only, cannot spend funds).
3. Get your API key (cpay_sk_...).
4. Add it to your MCP config.

Links

• CipherPay — Zcash payment processor
• MCP Protocol — Model Context Protocol
• Documentation — Full API docs
• @cipherpay/x402 — x402 middleware SDK

License

MIT — Atmosphere Labs