Payments · 1 skill

Paddle MCP: connect it to Claude Code, plus ready-made skills

Pull revenue, active and past-due subscriptions, cancellations and refunds from Paddle Billing, and report the week's SaaS numbers and the payments to chase.

How to connect Paddle MCP to Claude Code, Codex or Cursor

Paddle MCP server, Paddle's official open-source server for Paddle Billing (not Paddle Classic), @paddle/paddle-mcp (source). It runs locally with Node: in Claude Code, claude mcp add --env PADDLE_API_KEY=<key> --env PADDLE_ENVIRONMENT=production --env PADDLE_MCP_TOOLS=read-only --transport stdio paddle -- npx -y @paddle/paddle-mcp. Codex and Cursor take the same command with those three variables in the server's env. PADDLE_MCP_TOOLS accepts read-only, non-destructive (the default), all or a list of tool names.
API with an API key. Create a key on the Authentication page of the Paddle dashboard (vendors.paddle.com/authentication-v2, or sandbox-vendors.paddle.com/authentication-v2 for sandbox), choose its permissions, and store it in PADDLE_API_KEY. Live keys start with pdl_live_apikey_, expire after 90 days by default (a year at most), and go in Authorization: Bearer.

Give the key read permissions only (subscription.read, transaction.read, customer.read, report.read) and set PADDLE_MCP_TOOLS=read-only; the default non-destructive mode can still create transactions, discounts and customers.

1 Paddle skill

Payouts that never reached the bank: Stripe, Gumroad or Paddle, Mercury and your books

Every Monday: each Stripe, Gumroad and Paddle payout matched to a Mercury deposit and an entry in QuickBooks or Xero, with the ones that went missing.

FinanceMondays at 9:00Asks you

What agents do with Paddle

The Paddle Billing API (https://api.paddle.com) is built around subscriptions, transactions, customers, adjustments (refunds, credits and chargebacks) and products. GET /subscriptions?status=active,past_due lists subscriptions with their items, next_billed_at and any scheduled_change such as a cancellation at period end; GET /transactions filters on status and billed_at ranges; and GET /adjustments lists refunds and credits. The Metrics API has one endpoint per metric that takes from and to dates, such as GET /metrics/revenue, and the reports endpoints build CSV exports of transactions and subscriptions. Sandbox and live are separate environments with separate keys.

SaaS founders schedule weekly revenue with new and canceled subscriptions, past-due subscriptions and failed payments to chase, refunds and chargebacks, and subscriptions scheduled to cancel at the end of their period.

paddle.com

Often used with Paddle

Teams that use these

Your Paddle numbers, on one board with everything else

Skills are free to use with any agent. Briefkin is where their results land: one board for every report, number and question your agents send, with a ping when something needs you.

Join the open beta See a live demo board

Free during the open beta. No card.