MCP Server for Paddle Billing

Paddle Billing is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.

This is a Model Context Protocol (MCP) server that provides LLMs and AI agents with tools for interacting with the Paddle API.

Important: This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: Paddle Classic API reference

Features

The MCP server has near parity with the Paddle API, allowing AI assistants and agents to:

• Manage your full Paddle catalog
• View customer, purchase, and provisioning information
• Handle subscription, payment, and refund workflows
• Debug billing and order management issues
• Create and adjust transactions directly in conversation
• Generate financial reports for financial and operational insights
• Implement and test Paddle integrations faster

Products

Operation	Tool	Non-destructive	Read only
List products	list_products	✅	✅
Create a product	create_product	✅	❌
Get a product	get_product	✅	✅
Update a product	update_product	❌	❌

Prices

Operation	Tool	Non-destructive	Read only
List prices	list_prices	✅	✅
Create a price	create_price	✅	❌
Get a price	get_price	✅	✅
Update a price	update_price	❌	❌
Preview prices	preview_prices	✅	❌

Discounts

Operation	Tool	Non-destructive	Read only
List discounts	list_discounts	✅	✅
Create a discount	create_discount	✅	❌
Get a discount	get_discount	✅	✅
Update a discount	update_discount	❌	❌

Discount Groups

Operation	Tool	Non-destructive	Read only
List discount groups	list_discount_groups	✅	✅
Create a discount group	create_discount_group	✅	❌
Get a discount group	get_discount_group	✅	✅
Update a discount group	update_discount_group	❌	❌
Archive a discount group	archive_discount_group	❌	❌

Customers

Operation	Tool	Non-destructive	Read only
List customers	list_customers	✅	✅
Create a customer	create_customer	✅	❌
Get a customer	get_customer	✅	✅
Update a customer	update_customer	❌	❌
List credit balances for a customer	list_credit_balances	✅	✅

Addresses

Operation	Tool	Non-destructive	Read only
List addresses for a customer	list_addresses	✅	✅
Create an address for a customer	create_address	✅	❌
Get an address for a customer	get_address	✅	✅
Update an address for a customer	update_address	❌	❌

Businesses

Operation	Tool	Non-destructive	Read only
List businesses for a customer	list_businesses	✅	✅
Create a business for a customer	create_business	✅	❌
Get a business for a customer	get_business	✅	✅
Update a business for a customer	update_business	❌	❌

Transactions

Operation	Tool	Non-destructive	Read only
List transactions	list_transactions	✅	✅
Create a transaction	create_transaction	✅	❌
Get a transaction	get_transaction	✅	✅
Update a transaction	update_transaction	❌	❌
Preview a transaction	preview_transaction_create	✅	❌
Revise customer information on a billed or completed transaction	revise_transaction	❌	❌
Get a PDF invoice for a transaction	get_transaction_invoice	✅	✅

Adjustments

Operation	Tool	Non-destructive	Read only
List adjustments	list_adjustments	✅	✅
Create an adjustment	create_adjustment	✅	❌
Get a PDF credit note for an adjustment	get_adjustment_credit_note	✅	✅

Subscriptions

Operation	Tool	Non-destructive	Read only
List subscriptions	list_subscriptions	✅	✅
Get a subscription	get_subscription	✅	✅
Update a subscription	update_subscription	❌	❌
Cancel a subscription	cancel_subscription	❌	❌
Pause a subscription	pause_subscription	❌	❌
Resume a paused subscription	resume_subscription	❌	❌
Activate a trialing subscription	activate_subscription	❌	❌
Preview an update to a subscription	preview_subscription_update	✅	❌
Create a one-time charge for a subscription	create_subscription_charge	✅	❌
Preview a one-time charge for a subscription	preview_subscription_charge	✅	❌

Saved Payment Methods

Operation	Tool	Non-destructive	Read only
List payment methods saved for a customer	list_saved_payment_methods	✅	✅
Get a payment method saved for a customer	get_saved_payment_method	✅	✅
Delete a payment method saved for a customer	delete_saved_payment_method	❌	❌

Customer Portal Sessions

Operation	Tool	Non-destructive	Read only
Create a customer portal session	create_customer_portal_session	✅	❌

Notification Settings

Operation	Tool	Non-destructive	Read only
List notification settings	list_notification_settings	✅	✅
Create a notification setting	create_notification_setting	✅	❌
Get a notification setting	get_notification_setting	✅	✅
Update a notification setting	update_notification_setting	❌	❌
Delete a notification setting	delete_notification_setting	❌	❌

Events

Operation	Tool	Non-destructive	Read only
List events	list_events	✅	✅

Notifications

Operation	Tool	Non-destructive	Read only
List notifications	list_notifications	✅	✅
Get a notification	get_notification	✅	✅
Replay a notification	replay_notification	✅	❌

Notification Logs

Operation	Tool	Non-destructive	Read only
List logs for a notification	list_notification_logs	✅	✅

Simulations

Operation	Tool	Non-destructive	Read only
List simulations	list_simulations	✅	✅
Create a simulation	create_simulation	✅	❌
Get a simulation	get_simulation	✅	✅
Update a simulation	update_simulation	❌	❌

Simulation Runs

Operation	Tool	Non-destructive	Read only
List runs for a simulation	list_simulation_runs	✅	✅
Create a run for a simulation	create_simulation_run	✅	❌
Get a run for a simulation	get_simulation_run	✅	✅

Simulation Run Events

Operation	Tool	Non-destructive	Read only
List events for a simulation run	list_simulation_run_events	✅	✅
Get an event for a simulation run	get_simulation_run_event	✅	✅
Replay an event for a simulation run	replay_simulation_run_event	✅	❌

Reports

Operation	Tool	Non-destructive	Read only
List reports	list_reports	✅	✅
Create a report	create_report	✅	❌
Get a report	get_report	✅	✅
Get a CSV file for a report	get_report_csv	✅	✅

Client-Side Tokens

Operation	Tool	Non-destructive	Read only
List client-side tokens	list_client_side_tokens	✅	✅
Create a client-side token	create_client_side_token	✅	❌
Get a client-side token	get_client_side_token	✅	✅
Revoke a client-side token	revoke_client_side_token	❌	❌

Installation

To use the MCP server, you'll need an API key. You can create and manage API keys in Paddle > Developer tools > Authentication:

• Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
• Live: https://vendors.paddle.com/authentication-v2

To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)", "--tools=(all|read-only|non-destructive|tool_name1,tool_name2,...)"]
    }
  }
}

Replace PADDLE_API_KEY with your API key, and pass the correct value as environment.

You can also filter the tools available to the MCP server by passing the --tools argument. Accepted values are all, read-only, non-destructive, or a comma-separated list of tool names. The default is non-destructive.

For detailed setup guides, see:

• Claude Desktop
• Cursor
• Windsurf

Development

1. Install dependencies:

   pnpm install
   

2. Build the server:

   pnpm build
   

3. Update client to use the local build:

   {
     "mcpServers": {
       "paddle": {
         "command": "node",
         "args": ["path/to/paddle-mcp-server/build/index.js"],
         "env": {
           "PADDLE_API_KEY": "your_api_key",
           "PADDLE_ENVIRONMENT": "sandbox",
           "PADDLE_MCP_TOOLS": "all"
         }
       }
     }
   }
   

   The PADDLE_MCP_TOOLS environment variable accepts the same values as the --tools argument: all, read-only, non-destructive, or a comma-separated list of tool names. If not set, defaults to non-destructive.

Debugging

To debug the MCP server, you can use the MCP Inspector tool:

1. Run the server with the inspector:

   pnpm inspector
   

2. Open the provided URL in your browser to view and debug the MCP requests and responses.

3. Include the --api-key and --environment arguments.

Learn more

• Paddle developer docs
• Paddle API reference
• Sign up for Paddle Billing