# Perly Pay

> Perly Pay is a freemium MCP server for finance and payments. Create products, payment links and invoices for crypto payments from your editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://pay.perly.io/docs/mcp
- **Repository:** https://github.com/volodymyrslipak/perly-pay-mcp
- **MCP Registry name:** io.perly/pay-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Perly Pay takes payments in Bitcoin, USDC and USDT that go straight to your own wallet, and this server lets a coding assistant set that up. The assistant can create a product and price, make a payment link, raise an invoice, run a test payment and read back what came in, all from a prompt such as selling a one-hour consultation for $49.

The package runs on your machine over stdio and talks only to Perly Pay's API using your secret key; no relay of Perly's sits in between. Tools are generated from the API's OpenAPI description, so arguments match the API and amounts are integers in cents.

Safety is deliberate. With a live key (sk_live_) every tool that writes is refused, so live changes happen in the dashboard or your own code. Cancelling an invoice, opening a refund or deleting a webhook endpoint waits for an explicit confirm flag, and wallets, API keys, billing and going live have no tool at all.

## Features

- **Test-mode selling:** Build products, prices, links and invoices with an sk_test key and nothing real moves.
- **Simulated payments:** simulate_payment pays an invoice or link so receipts and webhooks fire as for a buyer.
- **Read-only live key:** With a live key, writes are refused and only lookups work.
- **Subscriptions and entitlements:** Create subscriptions renewed by invoice and check or consume access credits.
- **Webhook helpers:** Create endpoints and verify Perly-Signature values locally.
- **Confirmation on risky actions:** Cancels, refunds and deletions need a confirm flag the assistant sends after asking you.

## Good for

- Prototype a checkout flow with test payments
- Create payment links for a product from a chat
- Check a customer's entitlement from an assistant
- Verify a webhook signature while debugging
- List recent payments and receipts

## Install

### Claude Code (Terminal)

```sh
claude mcp add pay-mcp --env PERLY_PAY_SECRET_KEY='<PERLY_PAY_SECRET_KEY>' --env PERLY_PAY_WEBHOOK_SECRET='<PERLY_PAY_WEBHOOK_SECRET>' -- npx -y perly-pay-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perly-pay-mcp"
      ],
      "env": {
        "PERLY_PAY_SECRET_KEY": "<PERLY_PAY_SECRET_KEY>",
        "PERLY_PAY_WEBHOOK_SECRET": "<PERLY_PAY_WEBHOOK_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perly-pay-mcp"
      ],
      "env": {
        "PERLY_PAY_SECRET_KEY": "<PERLY_PAY_SECRET_KEY>",
        "PERLY_PAY_WEBHOOK_SECRET": "<PERLY_PAY_WEBHOOK_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "pay-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "perly-pay-mcp"
      ],
      "env": {
        "PERLY_PAY_SECRET_KEY": "<PERLY_PAY_SECRET_KEY>",
        "PERLY_PAY_WEBHOOK_SECRET": "<PERLY_PAY_WEBHOOK_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perly-pay-mcp"
      ],
      "env": {
        "PERLY_PAY_SECRET_KEY": "<PERLY_PAY_SECRET_KEY>",
        "PERLY_PAY_WEBHOOK_SECRET": "<PERLY_PAY_WEBHOOK_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perly-pay-mcp"
      ],
      "env": {
        "PERLY_PAY_SECRET_KEY": "<PERLY_PAY_SECRET_KEY>",
        "PERLY_PAY_WEBHOOK_SECRET": "<PERLY_PAY_WEBHOOK_SECRET>"
      }
    }
  }
}
```

## Tools

- `create_product`: Creates a product.
- `list_products`: Lists products.
- `update_product`: Updates a product.
- `create_price`: Creates a price.
- `list_prices`: Lists prices.
- `update_price`: Updates a price.
- `create_payment_link`: Creates a payment link.
- `list_payment_links`: Lists payment links.
- `update_payment_link`: Updates a payment link.
- `create_invoice`: Creates an invoice.
- `list_invoices`: Lists invoices.
- `retrieve_invoice`: Fetches one invoice.
- `cancel_invoice`: Cancels an invoice after confirmation.
- `create_checkout_session`: Creates a checkout session.
- `retrieve_checkout_session`: Fetches a checkout session.
- `create_customer`: Creates a customer.
- `list_customers`: Lists customers.
- `retrieve_customer`: Fetches one customer.
- `create_subscription`: Creates a subscription renewed by invoice.
- `list_subscriptions`: Lists subscriptions.
- `retrieve_subscription`: Fetches one subscription.
- `check_entitlement`: Checks a buyer's access.
- `list_entitlements`: Lists entitlements.
- `consume_entitlement_credits`: Spends entitlement credits.
- `list_credit_usage`: Lists credit usage.
- `list_payments`: Lists payments.
- `retrieve_payment`: Fetches one payment.
- `list_receipts`: Lists receipts.
- `retrieve_receipt`: Fetches one receipt.
- `list_events`: Lists events.
- `create_refund`: Opens a refund.
- `list_refunds`: Lists refunds.
- `create_webhook_endpoint`: Creates a webhook endpoint.
- `list_webhook_endpoints`: Lists webhook endpoints.
- `delete_webhook_endpoint`: Deletes a webhook endpoint.
- `simulate_payment`: Pays an invoice or payment link in test mode.
- `verify_webhook_signature`: Checks a Perly-Signature locally.
- `pay_links`: Returns dashboard pages for actions only you can do.

## FAQ

### What does it cost?

Perly Pay charges 2.5 cents a payment, never more than 0.5% of it; a month of up to 21 payments is free. The MCP package itself has no separate price listed.

### Does Perly hold my funds?

No. The site says buyers pay addresses derived from your public key and Perly only watches and notifies.

### Can the assistant make live changes?

No. With a live key, every write tool is refused.

### Which coins are accepted?

BTC, USDC on several networks, and USDT on Ethereum and TRON, plus USDT0 on Arbitrum and Optimism.

### What do I need to run it?

Node 20 or newer and a PERLY_PAY_SECRET_KEY from the dashboard.

### Is Perly Pay free?

Perly Pay has a free plan, with paid plans for more usage or features.

### How do I add Perly Pay to Claude Code?

Run this command in your terminal: claude mcp add pay-mcp --env PERLY_PAY_SECRET_KEY='<PERLY_PAY_SECRET_KEY>' --env PERLY_PAY_WEBHOOK_SECRET='<PERLY_PAY_WEBHOOK_SECRET>' -- npx -y perly-pay-mcp

### What are the best alternatives to Perly Pay?

The closest alternatives to Perly Pay are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/perly-pay
