JSPM

@cipherpay/mcp

1.2.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 31
  • Score
    100M100P100Q74668F
  • License MIT

MCP server for CipherPay — let AI agents create invoices, verify Zcash payments (x402 + MPP), manage sessions, and check statuses.

Package Exports

  • @cipherpay/mcp
  • @cipherpay/mcp/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cipherpay/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

License

MIT — Atmosphere Labs