Skip to content
MCP server

Perly Pay

Create products, payment links and invoices for crypto payments from your editor

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.3.0
Listing updated
3 days ago

About Perly Pay

Perly Pay is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • PERLY_PAY_SECRET_KEYYour key from Dashboard → Developers: sk_test_… while you build.Required
  • PERLY_PAY_APIOptional. Default https://pay.perly.io.
  • PERLY_PAY_WEBHOOK_SECRETOptional whsec_…, the default for verify_webhook_signature.

Tools this server provides (38)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

2.5 cents a payment (max 0.5%); up to 21 payments a month free; test mode free

Prices change. Check pay.perly.io before you buy.

Perly Pay 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 to Perly Pay

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government