@cipherpay/mcp

MCP server and Cursor plugin for CipherPay — let AI agents create Zcash invoices, manage products, verify shielded payments, and monitor your merchant account.

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

Install

Cursor Plugin

Install from the Cursor Marketplace or use the install link:

cursor://anysphere.cursor-deeplink/mcp/install?name=cipherpay&config=...

npm

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": ["-y", "@cipherpay/mcp@latest"],
      "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": ["-y", "@cipherpay/mcp@latest"],
      "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 authenticated tools | 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

Public (no auth required)

| Tool | Description | |------|-------------| | get_exchange_rates | Current ZEC exchange rates against fiat currencies | | get_invoice_status | Check if an invoice has been paid | | get_product_info | Get product details and available prices |

Merchant (requires API key)

| Tool | Description | |------|-------------| | create_invoice | Create a payment invoice (amount + currency) | | get_merchant_info | Your merchant account details and volume | | list_invoices | List recent invoices with status | | cancel_invoice | Cancel a pending invoice | | list_products | List your product catalog | | create_product | Create a new product | | list_prices | List prices for a product | | create_payment_link | Create a shareable checkout URL | | list_webhooks | Recent webhook delivery attempts | | verify_payment | Verify a shielded payment by txid (x402/MPP) | | open_session | Open a prepaid session with deposit | | get_session_status | Check session balance | | close_session | Close session and get refund info |

Example prompts

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

"Create an invoice for $25 USD"

"Has invoice CP-1234 been paid?"

"Create a product called 'API Access' for $10/month"

"List my recent invoices"

"Create a payment link for my Premium Plan product"

"Show me recent webhook deliveries"

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
• Zipher — Zcash wallet (mobile, desktop & CLI)

License

MIT — Atmosphere Labs