Skip to content

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/mcp
the first call
do {  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.

  1. 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
  2. 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 key
    • tenant_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
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates 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
  1. Subscriptions

    11

    3 read · 6 write · 2 destructive

    List subscriptions · Get a subscription · Update a subscription · Cancel a subscription

  2. Metrics

    9

    9 read · 0 write · 0 destructive

    Run an Explore metrics query · List Explore metric entities · Get active subscribers metrics · Get chargeback metrics

  3. Transactions

    7

    4 read · 3 write · 0 destructive

    List transactions · Get a transaction · Create a transaction · Preview a transaction

  4. Customers

    5

    2 read · 3 write · 0 destructive

    List customers · Create a customer · Get a customer · Update a customer

  5. Notification settings

    5

    2 read · 2 write · 1 destructive

    Create a notification setting · List notification settings · Update a notification setting · Get a notification setting

  6. Prices

    5

    3 read · 2 write · 0 destructive

    List prices · Create a price · Get a price · Update a price

  7. Checkout domains

    4

    2 read · 1 write · 1 destructive

    List checkout domains · Get a checkout domain · Verify a payment method for a checkout domain · Delete a checkout domain

  8. Client tokens

    4

    2 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.

ActionWhat it doesEffectSame name in
paddle_billing.products.listList productsList products.readcommerce.product.list112 connectors
paddle_billing.customers.listList customersList customers.readcommerce.customer.list45 connectors
paddle_billing.transactions.listList transactionsList transactions.readfinance.invoice.list101 connectors
paddle_billing.products.createCreate a productCreate a product.writecommerce.product.create92 connectors
paddle_billing.subscriptions.listList subscriptionsList subscriptions.readfinance.subscription.list37 connectors
paddle_billing.customers.createCreate a customerCreate a customer.writecommerce.customer.create43 connectors
paddle_billing.transactions.getGet a transactionGet a transaction.readfinance.invoice.get102 connectors
paddle_billing.subscriptions.getGet a subscriptionGet a subscription.readfinance.subscription.get33 connectors
paddle_billing.discounts.listList discountsList discounts.readcommerce.coupon.list29 connectors
paddle_billing.discounts.createCreate a discountCreate a discount.writecommerce.coupon.create29 connectors
paddle_billing.prices.createCreate a priceCreate a price.writecommerce.price.create9 connectors
paddle_billing.subscriptions.cancelCancel a subscriptionCancel a subscription.destructivefinance.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.

  1. Readread

    Which Paddle Billing invoices are more than 30 days overdue? Group them by customer with the total owed.

    callspaddle_billing.transactions.list

  2. Writewrite

    Create a product in Paddle Billing. Show me exactly what you will send before you save it.

    callspaddle_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 subscriptionpaddle_billing.subscriptions.cancel
  • Delete a payment method for a customerpaddle_billing.customer_payment_methods.delete
  • Delete a notification settingpaddle_billing.notification_settings.delete
  • Create a one-time charge for a subscriptionpaddle_billing.subscriptions.create_charge
  • Delete a checkout domainpaddle_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.

dopaddle_billing.subscriptions.cancelconfirm_policy: human

Cancel a subscription?

intent: the user asked me to cancel a subscription

run suspended · waiting for a named person · key paddle-billing-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
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]" }  ]}
Illustrative. Scoped to Paddle Billing only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

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

See pricing

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 subscriptionwrite
  • paddle_billing.subscriptions.cancelCancel a subscriptiondestructive
  • paddle_billing.subscriptions.create_chargeCreate a one-time charge for a subscriptiondestructive
  • paddle_billing.subscriptions.getGet a subscriptionread
  • paddle_billing.subscriptions.get_update_payment_method_transactionGet a transaction to update payment methodwrite
  • paddle_billing.subscriptions.listList subscriptionsread
  • paddle_billing.subscriptions.pausePause a subscriptionwrite
  • paddle_billing.subscriptions.preview_chargePreview a one-time charge for a subscriptionread
  • paddle_billing.subscriptions.preview_updatePreview an update to a subscriptionwrite
  • paddle_billing.subscriptions.resumeResume a paused subscriptionwrite
  • paddle_billing.subscriptions.updateUpdate a subscriptionwrite
Metrics9
  • paddle_billing.metrics.active_subscribersGet active subscribers metricsread
  • paddle_billing.metrics.chargebacksGet chargeback metricsread
  • paddle_billing.metrics.checkout_conversionGet checkout conversion metricsread
  • paddle_billing.metrics.exploreRun an Explore metrics queryread
  • paddle_billing.metrics.list_explore_entitiesList Explore metric entitiesread
  • paddle_billing.metrics.monthly_recurring_revenueGet MRR (monthly recurring revenue) metricsread
  • paddle_billing.metrics.monthly_recurring_revenue_changeGet MRR change (monthly recurring revenue change) metricsread
  • paddle_billing.metrics.refundsGet refund metricsread
  • paddle_billing.metrics.revenueGet net revenue metricsread
Transactions7
  • paddle_billing.transactions.createCreate a transactionwrite
  • paddle_billing.transactions.getGet a transactionread
  • paddle_billing.transactions.get_invoice_pdf_urlGet a PDF invoice for a transactionread
  • paddle_billing.transactions.listList transactionsread
  • paddle_billing.transactions.previewPreview a transactionread
  • paddle_billing.transactions.reviseRevise customer information on a billed or completed transactionwrite
  • paddle_billing.transactions.updateUpdate a transactionwrite
Customers5
  • paddle_billing.customers.createCreate a customerwrite
  • paddle_billing.customers.generate_auth_tokenGenerate an authentication token for a customerwrite
  • paddle_billing.customers.getGet a customerread
  • paddle_billing.customers.listList customersread
  • paddle_billing.customers.updateUpdate a customerwrite
Notification settings5
  • paddle_billing.notification_settings.createCreate a notification settingwrite
  • paddle_billing.notification_settings.deleteDelete a notification settingdestructive
  • paddle_billing.notification_settings.getGet a notification settingread
  • paddle_billing.notification_settings.listList notification settingsread
  • paddle_billing.notification_settings.updateUpdate a notification settingwrite
Prices5
  • paddle_billing.prices.createCreate a pricewrite
  • paddle_billing.prices.getGet a priceread
  • paddle_billing.prices.listList pricesread
  • paddle_billing.prices.previewPreview pricesread
  • paddle_billing.prices.updateUpdate a pricewrite
Checkout domains4
  • paddle_billing.checkout_domains.deleteDelete a checkout domaindestructive
  • paddle_billing.checkout_domains.getGet a checkout domainread
  • paddle_billing.checkout_domains.listList checkout domainsread
  • paddle_billing.checkout_domains.verify_payment_methodVerify a payment method for a checkout domainwrite
Client tokens4
  • paddle_billing.client_tokens.createCreate a client-side tokenwrite
  • paddle_billing.client_tokens.getGet a client-side tokenread
  • paddle_billing.client_tokens.listList client-side tokensread
  • paddle_billing.client_tokens.updateUpdate a client-side tokenwrite
Customer addresses4
  • paddle_billing.customer_addresses.createCreate an address for a customerwrite
  • paddle_billing.customer_addresses.getGet an address for a customerread
  • paddle_billing.customer_addresses.listList addresses for a customerread
  • paddle_billing.customer_addresses.updateUpdate an address for a customerwrite
Customer businesses4
  • paddle_billing.customer_businesses.createCreate a business for a customerwrite
  • paddle_billing.customer_businesses.getGet a business for a customerread
  • paddle_billing.customer_businesses.listList businesses for a customerread
  • paddle_billing.customer_businesses.updateUpdate a business for a customerwrite
Discount groups4
  • paddle_billing.discount_groups.createCreate a discount groupwrite
  • paddle_billing.discount_groups.getGet a discount groupread
  • paddle_billing.discount_groups.listList discount groupsread
  • paddle_billing.discount_groups.updateUpdate a discount groupwrite
Discounts4
  • paddle_billing.discounts.createCreate a discountwrite
  • paddle_billing.discounts.getGet a discountread
  • paddle_billing.discounts.listList discountsread
  • paddle_billing.discounts.updateUpdate a discountwrite
Products4
  • paddle_billing.products.createCreate a productwrite
  • paddle_billing.products.getGet a productread
  • paddle_billing.products.listList productsread
  • paddle_billing.products.updateUpdate a productwrite
Reports4
  • paddle_billing.reports.createCreate a reportwrite
  • paddle_billing.reports.getGet a reportread
  • paddle_billing.reports.get_download_urlGet a CSV file for a reportread
  • paddle_billing.reports.listList reportsread
Simulations4
  • paddle_billing.simulations.createCreate a simulationwrite
  • paddle_billing.simulations.getGet a simulationread
  • paddle_billing.simulations.listList simulationsread
  • paddle_billing.simulations.updateUpdate a simulationwrite
Adjustments3
  • paddle_billing.adjustments.createCreate an adjustmentwrite
  • paddle_billing.adjustments.get_credit_noteGet a PDF credit note for an adjustmentread
  • paddle_billing.adjustments.listList adjustmentsread
Customer payment methods3
  • paddle_billing.customer_payment_methods.deleteDelete a payment method for a customerdestructive
  • paddle_billing.customer_payment_methods.getGet a payment method for a customerread
  • paddle_billing.customer_payment_methods.listList payment methods for a customerread
Notifications3
  • paddle_billing.notifications.getGet a notificationread
  • paddle_billing.notifications.listList notificationsread
  • paddle_billing.notifications.replayReplay a notificationwrite
Simulation run events3
  • paddle_billing.simulation_run_events.getGet an event for a simulation runread
  • paddle_billing.simulation_run_events.listList events for a simulation runread
  • paddle_billing.simulation_run_events.replayReplay an event for a simulation runwrite
Simulation runs3
  • paddle_billing.simulation_runs.createCreate a run for a simulationwrite
  • paddle_billing.simulation_runs.getGet a run for a simulationread
  • paddle_billing.simulation_runs.listList runs for a simulationread
Account2
  • paddle_billing.account.getGet accountread
  • paddle_billing.account.updateUpdate accountwrite
Balance currency2
  • paddle_billing.balance_currency.getGet balance currency settingsread
  • paddle_billing.balance_currency.updateUpdate balance currency settingswrite
Checkout features2
  • paddle_billing.checkout_features.getGet checkout feature settingsread
  • paddle_billing.checkout_features.updateUpdate checkout feature settingswrite
Checkout payment methods2
  • paddle_billing.checkout_payment_methods.getGet checkout payment method settingsread
  • paddle_billing.checkout_payment_methods.updateUpdate checkout payment method settingswrite
Checkout recovery2
  • paddle_billing.checkout_recovery.getGet checkout recovery settingsread
  • paddle_billing.checkout_recovery.updateUpdate checkout recovery settingswrite
Checkout styles overlay2
  • paddle_billing.checkout_styles_overlay.getGet overlay checkout style settingsread
  • paddle_billing.checkout_styles_overlay.updateUpdate overlay checkout style settingswrite
Checkout URL2
  • paddle_billing.checkout_url.getGet checkout URL settingsread
  • paddle_billing.checkout_url.updateUpdate checkout URL settingswrite
Currency conversions2
  • paddle_billing.currency_conversions.getGet currency conversion settingsread
  • paddle_billing.currency_conversions.updateUpdate currency conversion settingswrite
Statement descriptor2
  • paddle_billing.statement_descriptor.getGet statement descriptor settingsread
  • paddle_billing.statement_descriptor.updateUpdate statement descriptor settingswrite
Tax settings2
  • paddle_billing.tax_settings.getGet tax settingsread
  • paddle_billing.tax_settings.updateUpdate tax settingswrite
Verifications2
  • paddle_billing.verifications.getGet a verificationread
  • paddle_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.