Perly Pay
Create products, payment links and invoices for crypto payments from your editor
- 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-mcpAdd 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.RequiredPERLY_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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government