Connectors · Accounting & finance
Paddle Billing MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Paddle Billing and the rest of your systems. It gives your agent 126 Paddle Billing actions (74 reads, 47 writes and 5 that wait for a confirmation) and holds the Paddle Billing credential itself, so the agent never does. It paces Paddle Billing's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "paddle_billing.products.list", intent: "check which Paddle Billing account is connected"}# List products · read · 1 upstream call- 126actionsin one signed file
- 74readlook, never change
- 47writecreate and update
- 5wait for a yesdestructive, confirmed first
Set up
Connect Paddle Billing in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect Paddle Billing.
Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
api_keyPaddle API keytenant_hostWhere your Paddle Billing lives: your tenant host
account { op: "connections.requirements", service: "paddle_billing" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "paddle_billing.products.list" }# list products · read · 1 upstream callcheck { action: "paddle_billing.products.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Paddle Billing at a glance
- Sign-in
- Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
api_key- Setup fields
tenant_host- Limits we pace to
- 240 calls a minute, per connection
- API covered
- Paddle Billing API v1 (OpenAPI 3.1, Paddle-Version 1)
api.paddle.com - Built from
- Paddle Billing's documentation, read 23 October 2026OpenAPI spec (GitHub)developer.paddle.com
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 65 of 74 reads, for up to an hour; a write clears what it affects
- Shared entities
- 5, so ask can line Paddle Billing up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Paddle Billing.
126 actions in 42 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 74readlook, never change
- 47writecreate and update
- 5destructivewait for a confirmation
Subscriptions
113 read · 6 write · 2 destructive
List subscriptions · Get a subscription · Update a subscription · Cancel a subscription
Metrics
99 read · 0 write · 0 destructive
Run an Explore metrics query · List Explore metric entities · Get active subscribers metrics · Get chargeback metrics
Transactions
74 read · 3 write · 0 destructive
List transactions · Get a transaction · Create a transaction · Preview a transaction
Customers
52 read · 3 write · 0 destructive
List customers · Create a customer · Get a customer · Update a customer
Notification settings
52 read · 2 write · 1 destructive
Create a notification setting · List notification settings · Update a notification setting · Get a notification setting
Prices
53 read · 2 write · 0 destructive
List prices · Create a price · Get a price · Update a price
Checkout domains
42 read · 1 write · 1 destructive
List checkout domains · Get a checkout domain · Verify a payment method for a checkout domain · Delete a checkout domain
Client tokens
42 read · 2 write · 0 destructive
Create a client-side token · List client-side tokens · Get a client-side token · Update a client-side token
34 more areas · 76 actions
- Customer addresses 4
- Customer businesses 4
- Discount groups 4
- Discounts 4
- Products 4
- Reports 4
- Simulations 4
- Adjustments 3
- Customer payment methods 3
- Notifications 3
- Simulation run events 3
- Simulation runs 3
- Account 2
- Balance currency 2
- Checkout features 2
- Checkout payment methods 2
- Checkout recovery 2
- Checkout styles overlay 2
- Checkout URL 2
- Currency conversions 2
- Statement descriptor 2
- Tax settings 2
- Verifications 2
- API root 1
- Countries 1
- Currencies 1
- Customer credit balances 1
- Customer portal sessions 1
- Event types 1
- Events 1
- Ip addresses 1
- Notification logs 1
- Simulation types 1
- Subscription history 1
Top actions
The Paddle Billing API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 40 of Paddle Billing's 40 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
paddle_billing.products.listList products | List products. | read | commerce.product.list112 connectors |
paddle_billing.customers.listList customers | List customers. | read | commerce.customer.list45 connectors |
paddle_billing.transactions.listList transactions | List transactions. | read | finance.invoice.list101 connectors |
paddle_billing.products.createCreate a product | Create a product. | write | commerce.product.create92 connectors |
paddle_billing.subscriptions.listList subscriptions | List subscriptions. | read | finance.subscription.list37 connectors |
paddle_billing.customers.createCreate a customer | Create a customer. | write | commerce.customer.create43 connectors |
paddle_billing.transactions.getGet a transaction | Get a transaction. | read | finance.invoice.get102 connectors |
paddle_billing.subscriptions.getGet a subscription | Get a subscription. | read | finance.subscription.get33 connectors |
paddle_billing.discounts.listList discounts | List discounts. | read | commerce.coupon.list29 connectors |
paddle_billing.discounts.createCreate a discount | Create a discount. | write | commerce.coupon.create29 connectors |
paddle_billing.prices.createCreate a price | Create a price. | write | commerce.price.create9 connectors |
paddle_billing.subscriptions.cancelCancel a subscription | Cancel a subscription. | destructive | finance.subscription.cancel19 connectors |
Try it
Prompts to paste into Claude.
Each one names the Paddle Billing actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Which Paddle Billing invoices are more than 30 days overdue? Group them by customer with the total owed.
calls
paddle_billing.transactions.list - Writewrite
Create a product in Paddle Billing. Show me exactly what you will send before you save it.
calls
paddle_billing.products.create
Governance for Paddle Billing
Destructive actions wait for a yes.
5 Paddle Billing actions are destructive. These are all of them:
- Cancel a subscription
paddle_billing.subscriptions.cancel - Delete a payment method for a customer
paddle_billing.customer_payment_methods.delete - Delete a notification setting
paddle_billing.notification_settings.delete - Create a one-time charge for a subscription
paddle_billing.subscriptions.create_charge - Delete a checkout domain
paddle_billing.checkout_domains.delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Cancel a subscription?
intent: the user asked me to cancel a subscription
account { op: "keys.create", name: "paddle-billing-agent", allowed_actions: ["paddle_billing.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "paddle_billing.subscriptions.cancel", approver: "[email protected]" }, { match: "paddle_billing.customer_payment_methods.delete", approver: "[email protected]" }, { match: "paddle_billing.notification_settings.delete", approver: "[email protected]" } ]}Cost
What Paddle Billing costs on actionlake.
Every Paddle Billing action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Paddle Billing refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 126 Paddle Billing actions
- 126actions pageeach page of a long list is one call
- 65reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Paddle Billing action.
126 actions by area: the id your agent calls, what it does, and its effect.
Subscriptions11
paddle_billing.subscriptions.activateActivate a trialing subscriptionwritepaddle_billing.subscriptions.cancelCancel a subscriptiondestructivepaddle_billing.subscriptions.create_chargeCreate a one-time charge for a subscriptiondestructivepaddle_billing.subscriptions.getGet a subscriptionreadpaddle_billing.subscriptions.get_update_payment_method_transactionGet a transaction to update payment methodwritepaddle_billing.subscriptions.listList subscriptionsreadpaddle_billing.subscriptions.pausePause a subscriptionwritepaddle_billing.subscriptions.preview_chargePreview a one-time charge for a subscriptionreadpaddle_billing.subscriptions.preview_updatePreview an update to a subscriptionwritepaddle_billing.subscriptions.resumeResume a paused subscriptionwritepaddle_billing.subscriptions.updateUpdate a subscriptionwrite
Metrics9
paddle_billing.metrics.active_subscribersGet active subscribers metricsreadpaddle_billing.metrics.chargebacksGet chargeback metricsreadpaddle_billing.metrics.checkout_conversionGet checkout conversion metricsreadpaddle_billing.metrics.exploreRun an Explore metrics queryreadpaddle_billing.metrics.list_explore_entitiesList Explore metric entitiesreadpaddle_billing.metrics.monthly_recurring_revenueGet MRR (monthly recurring revenue) metricsreadpaddle_billing.metrics.monthly_recurring_revenue_changeGet MRR change (monthly recurring revenue change) metricsreadpaddle_billing.metrics.refundsGet refund metricsreadpaddle_billing.metrics.revenueGet net revenue metricsread
Transactions7
paddle_billing.transactions.createCreate a transactionwritepaddle_billing.transactions.getGet a transactionreadpaddle_billing.transactions.get_invoice_pdf_urlGet a PDF invoice for a transactionreadpaddle_billing.transactions.listList transactionsreadpaddle_billing.transactions.previewPreview a transactionreadpaddle_billing.transactions.reviseRevise customer information on a billed or completed transactionwritepaddle_billing.transactions.updateUpdate a transactionwrite
Customers5
paddle_billing.customers.createCreate a customerwritepaddle_billing.customers.generate_auth_tokenGenerate an authentication token for a customerwritepaddle_billing.customers.getGet a customerreadpaddle_billing.customers.listList customersreadpaddle_billing.customers.updateUpdate a customerwrite
Notification settings5
paddle_billing.notification_settings.createCreate a notification settingwritepaddle_billing.notification_settings.deleteDelete a notification settingdestructivepaddle_billing.notification_settings.getGet a notification settingreadpaddle_billing.notification_settings.listList notification settingsreadpaddle_billing.notification_settings.updateUpdate a notification settingwrite
Prices5
paddle_billing.prices.createCreate a pricewritepaddle_billing.prices.getGet a pricereadpaddle_billing.prices.listList pricesreadpaddle_billing.prices.previewPreview pricesreadpaddle_billing.prices.updateUpdate a pricewrite
Checkout domains4
paddle_billing.checkout_domains.deleteDelete a checkout domaindestructivepaddle_billing.checkout_domains.getGet a checkout domainreadpaddle_billing.checkout_domains.listList checkout domainsreadpaddle_billing.checkout_domains.verify_payment_methodVerify a payment method for a checkout domainwrite
Client tokens4
paddle_billing.client_tokens.createCreate a client-side tokenwritepaddle_billing.client_tokens.getGet a client-side tokenreadpaddle_billing.client_tokens.listList client-side tokensreadpaddle_billing.client_tokens.updateUpdate a client-side tokenwrite
Customer addresses4
paddle_billing.customer_addresses.createCreate an address for a customerwritepaddle_billing.customer_addresses.getGet an address for a customerreadpaddle_billing.customer_addresses.listList addresses for a customerreadpaddle_billing.customer_addresses.updateUpdate an address for a customerwrite
Customer businesses4
paddle_billing.customer_businesses.createCreate a business for a customerwritepaddle_billing.customer_businesses.getGet a business for a customerreadpaddle_billing.customer_businesses.listList businesses for a customerreadpaddle_billing.customer_businesses.updateUpdate a business for a customerwrite
Discount groups4
paddle_billing.discount_groups.createCreate a discount groupwritepaddle_billing.discount_groups.getGet a discount groupreadpaddle_billing.discount_groups.listList discount groupsreadpaddle_billing.discount_groups.updateUpdate a discount groupwrite
Discounts4
paddle_billing.discounts.createCreate a discountwritepaddle_billing.discounts.getGet a discountreadpaddle_billing.discounts.listList discountsreadpaddle_billing.discounts.updateUpdate a discountwrite
Products4
paddle_billing.products.createCreate a productwritepaddle_billing.products.getGet a productreadpaddle_billing.products.listList productsreadpaddle_billing.products.updateUpdate a productwrite
Reports4
paddle_billing.reports.createCreate a reportwritepaddle_billing.reports.getGet a reportreadpaddle_billing.reports.get_download_urlGet a CSV file for a reportreadpaddle_billing.reports.listList reportsread
Simulations4
paddle_billing.simulations.createCreate a simulationwritepaddle_billing.simulations.getGet a simulationreadpaddle_billing.simulations.listList simulationsreadpaddle_billing.simulations.updateUpdate a simulationwrite
Adjustments3
paddle_billing.adjustments.createCreate an adjustmentwritepaddle_billing.adjustments.get_credit_noteGet a PDF credit note for an adjustmentreadpaddle_billing.adjustments.listList adjustmentsread
Customer payment methods3
paddle_billing.customer_payment_methods.deleteDelete a payment method for a customerdestructivepaddle_billing.customer_payment_methods.getGet a payment method for a customerreadpaddle_billing.customer_payment_methods.listList payment methods for a customerread
Notifications3
paddle_billing.notifications.getGet a notificationreadpaddle_billing.notifications.listList notificationsreadpaddle_billing.notifications.replayReplay a notificationwrite
Simulation run events3
paddle_billing.simulation_run_events.getGet an event for a simulation runreadpaddle_billing.simulation_run_events.listList events for a simulation runreadpaddle_billing.simulation_run_events.replayReplay an event for a simulation runwrite
Simulation runs3
paddle_billing.simulation_runs.createCreate a run for a simulationwritepaddle_billing.simulation_runs.getGet a run for a simulationreadpaddle_billing.simulation_runs.listList runs for a simulationread
Account2
paddle_billing.account.getGet accountreadpaddle_billing.account.updateUpdate accountwrite
Balance currency2
paddle_billing.balance_currency.getGet balance currency settingsreadpaddle_billing.balance_currency.updateUpdate balance currency settingswrite
Checkout features2
paddle_billing.checkout_features.getGet checkout feature settingsreadpaddle_billing.checkout_features.updateUpdate checkout feature settingswrite
Checkout payment methods2
paddle_billing.checkout_payment_methods.getGet checkout payment method settingsreadpaddle_billing.checkout_payment_methods.updateUpdate checkout payment method settingswrite
Checkout recovery2
paddle_billing.checkout_recovery.getGet checkout recovery settingsreadpaddle_billing.checkout_recovery.updateUpdate checkout recovery settingswrite
Checkout styles overlay2
paddle_billing.checkout_styles_overlay.getGet overlay checkout style settingsreadpaddle_billing.checkout_styles_overlay.updateUpdate overlay checkout style settingswrite
Checkout URL2
paddle_billing.checkout_url.getGet checkout URL settingsreadpaddle_billing.checkout_url.updateUpdate checkout URL settingswrite
Currency conversions2
paddle_billing.currency_conversions.getGet currency conversion settingsreadpaddle_billing.currency_conversions.updateUpdate currency conversion settingswrite
Statement descriptor2
paddle_billing.statement_descriptor.getGet statement descriptor settingsreadpaddle_billing.statement_descriptor.updateUpdate statement descriptor settingswrite
Tax settings2
paddle_billing.tax_settings.getGet tax settingsreadpaddle_billing.tax_settings.updateUpdate tax settingswrite
Verifications2
paddle_billing.verifications.getGet a verificationreadpaddle_billing.verifications.listList verificationsread
API root1
paddle_billing.api_root.getGet API rootread
Countries1
paddle_billing.countries.listList Paddle countriesread
Currencies1
paddle_billing.currencies.listList Paddle currenciesread
Customer credit balances1
paddle_billing.customer_credit_balances.listList credit balances for a customerread
Customer portal sessions1
paddle_billing.customer_portal_sessions.createCreate a customer portal sessionwrite
Event types1
paddle_billing.event_types.listList events typesread
Events1
paddle_billing.events.listList eventsread
Ip addresses1
paddle_billing.ip_addresses.getGet Paddle IP addressesread
Notification logs1
paddle_billing.notification_logs.listList logs for a notificationread
Simulation types1
paddle_billing.simulation_types.listList simulation typesread
Subscription history1
paddle_billing.subscription_history.listList history for a subscriptionread
Questions
The Paddle Billing MCP server, answered.
Is there a Paddle Billing MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 126 Paddle Billing actions across subscriptions, metrics, transactions and customers, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Paddle Billing.
What do I need to connect Paddle Billing?
Paddle API key. Plus your tenant host. The free call account { op: "connections.requirements", service: "paddle_billing" } lists exactly what to paste.
Can an AI agent delete or change things in Paddle Billing?
Only if its key allows it, and only with an explicit confirmation. 5 Paddle Billing actions are destructive, including cancel a subscription, delete a payment method for a customer and delete a notification setting. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my Paddle Billing API limit?
actionlake paces every call to the limits in the Paddle Billing service file: 240 calls a minute per connection. Repeated reads are answered from cache (65 Paddle Billing actions can be), which never reaches Paddle Billing.
What does a Paddle Billing action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (126 Paddle Billing actions page). Cache hits, searches, dry runs and calls Paddle Billing refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which Paddle Billing API does it cover?
The Paddle Billing API v1 (OpenAPI 3.1, Paddle-Version 1) at api.paddle.com by default, or the base URL set when you connect. It is built from Paddle Billing's documentation as read on 23 October 2026. 126 actions in 42 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my Paddle Billing data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to an hour, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Paddle Billing credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent Paddle Billing today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.