LABSCO SUMMARY

Billing questions get answered where you are already typing.

It reaches most of the Paddle Billing API, so the catalogue work — a price that needs changing, a discount that needs building, a customer whose record you need to read — happens in the conversation rather than in a dashboard tab.

What it is

Paddle's own MCP server for Paddle Billing, with near parity to the Paddle API. The catalogue, customer records and discount setup you would otherwise click through in the dashboard are reachable as tool calls. It does not support Paddle Classic.

What you get

Products listed, opened, created and updated
Prices the same way, plus a preview of what a buyer would actually be charged
Customer records read and written, and their credit balances listed
Discounts created, updated and listed
Discount groups created, updated, listed and archived
Each tool marked non-destructive or not, so a read and a change are distinguishable before you call one

Requirements

A Paddle Billing account and an API key for it, plus npx to launch the server.

Setup effort

One command plus a key — npx -y @paddle/paddle-mcp --api-key=<YOUR_API_KEY> --environment=sandbox --tools=non-destructive, then supply credentials

See installation options

USE CASES

01

Publishing a new plan end to end

Create the product, hang prices off it, then read both back to confirm what the buyer will see. Three calls replace a walk through the catalogue screens.

create_productcreate_priceget_productlist_prices

02

Checking what a buyer will actually be charged

Preview the prices rather than reasoning about them. The preview accounts for what the stored price object really does, which is where hand calculations usually go wrong.

preview_pricesget_pricelist_prices

03

Answering a customer's billing question

Find the customer, open their record, and read the credit balances sitting against it — enough to answer most support questions without opening the dashboard.

list_customersget_customerlist_credit_balances

04

Running a promotion

Build the discount, group it with the others in the campaign, and archive the group when the promotion ends.

create_discountcreate_discount_grouplist_discountsarchive_discount_group

05

Correcting a price that went out wrong

Read the price as it stands, change it, and list the prices on the product to confirm nothing else moved.

get_priceupdate_pricelist_prices

83 tools

Listed in project docs. Your client may show a different list.

list_products

create_product

get_product

update_product

list_prices

create_price

get_price

update_price

preview_prices

list_discounts

create_discount

get_discount

update_discount

list_discount_groups

create_discount_group

BEFORE YOU INSTALL

What to know first

Tools you get

83 tools named in the project's documentation.

Requires

npx on PATH
PADDLE_API_KEY in your environment

Where it runs

Both documented setups run the server on your machine.

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @paddle/paddle-mcp --api-key=<YOUR_API_KEY> --environment=sandbox --tools=non-destructive

MCP Clients

Any MCP client — key in args

ANY MCP CLIENT — KEY IN ARGS · JSON

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": [
        "-y",
        "@paddle/paddle-mcp",
        "--api-key=<YOUR_API_KEY>",
        "--environment=sandbox",
        "--tools=non-destructive"
      ]
    }
  }
}

Any MCP client — key in env

ANY MCP CLIENT — KEY IN ENV · JSON

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": [
        "-y",
        "@paddle/paddle-mcp"
      ],
      "env": {
        "PADDLE_API_KEY": "<YOUR_PADDLE_API_KEY>",
        "PADDLE_ENVIRONMENT": "sandbox",
        "PADDLE_MCP_TOOLS": "non-destructive"
      }
    }
  }
}

Paddle Billing