Paddle MCP Server

Official

Interact with the Paddle API using AI assistants, manage product catalog, billing, and subscriptions.

How to install ↓ Compare GitHub source repository ↗

Category: Other #10 of 230
Stars: ★ 49 Popular
Transport: stdio (local process)
Runtime: Node.js
Credentials: API key / credential required
License: Apache-2.0
Last commit: 6 months ago
Tools: 83

70FMRS · B

The Paddle MCP server provides comprehensive integration with the Paddle Billing API, offering numerous tools and robust functionality. However, attention must be paid to permission controls and environment settings to avoid mistakes.

Strongest · Maintenance 17/20 Weakest · Reliability 9/20

Reliability

9/20

Security and permissions

15/20

Maintenance

17/20

Documentation

16/20

Setup experience

13/20

Why each score

Reliability 9/20: Source includes build scripts (package.json), TypeScript source, test files, and GitHub Actions CI, suggesting a solid implementation. However, this review is static and did not execute the server, and CI configuration and test coverage details are not provided, so we cannot verify that key paths are reproducible or that failures are controlled. Deductions for not verifying runtime behavior and limited evidence of error handling.
Security and permissions 15/20: Example configs use placeholders; no hardcoded secrets. Credentials can be passed via environment variables or CLI args, but CLI args may be visible in process listings. The --tools filter and default non-destructive mode allow least privilege. No evidence of malicious behavior. Deductions for API key exposure via CLI and lack of explicit confirmation for destructive actions.
Maintenance 17/20: Apache-2.0 license, active repository with 50 stars and 5 open issues, not archived. CI and build scripts suggest a versioned release process. However, no recent commit history or release tags provided. Deductions for lack of maintainer response time and security response channel details.
Documentation 16/20: README includes installation, configuration, environment variables, CLI args, tool lists with read-only/non-destructive distinction, and one-click install examples for Cursor/VS Code. Missing detailed tool parameter documentation, troubleshooting, and limits/cost. Deductions for missing parameter schemas and troubleshooting section.
Setup experience 13/20: Multiple installation methods: npx, local build, one-click for Cursor/VS Code. Config examples are clear. However, user must manually obtain API key and set environment. Static review cannot confirm build success or compatibility across platforms. Deductions for not verifying execution and lacking platform-specific notes.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

Developers using Paddle Billing
Integrating AI assistants into payment and subscription workflows
Querying Paddle API data via natural language

Not for

Users of Paddle Classic
Scenarios where interaction with Paddle API is not needed

Required permissions

Requires a Paddle API key
Depending on tool filtering, can perform read-only, non-destructive, or destructive operations

Risks and side effects

API key leakage could lead to data exposure or unauthorized actions
Destructive tools (e.g., update, cancel, pause subscriptions) can cause irreversible changes
Ensure to test in sandbox before production

Setup

Before you start

Runtime：Node.js

PADDLE_API_KEY requiredsecret Paddle API key created in Paddle > Developer tools > Authentication (sandbox or live); required and secret.

Other optional settings (2)

PADDLE_ENVIRONMENT optional Target environment: sandbox or production; defaults to sandbox.

PADDLE_MCP_TOOLS optional Controls which tools load: all, read-only, non-destructive (default), or a comma-separated list of tool names.

Obtain a Paddle API key (create in Paddle > Developer tools > Authentication, sandbox or live).
Add the server configuration to your MCP client's settings file (e.g., Claude Desktop, Cursor, VS Code, Windsurf). You can use command-line arguments or environment variables.
Set the environment (sandbox or production) and tool filtering as needed (all, read-only, non-destructive, or specific tool names).

claude_desktop_config.json

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add paddle -- npx -y @paddle/paddle-mcp --api-key=your_api_key --environment=sandbox --tools=non-destructive

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

The paddle server's tools (e.g. list_products) should appear in your client's tool list; alternatively ask "List my Paddle products" — returning catalog data from your sandbox confirms the connection works.

Troubleshooting

Check that the API key is valid
Confirm environment variables or command-line arguments are correct (e.g., --environment=sandbox)
Use MCP Inspector to debug requests and responses

Things to try

Once connected, you can ask your AI assistant things like:

List all products in my Paddle sandbox account
Create a new product called Pro Plan with a monthly price of $29
Pause subscription sub_12345 and preview how the change affects the customer
Generate a revenue report for last month's transactions and download the CSV

Tools 83

list_products read-only

List products

create_product writes

Create a product

get_product read-only

Get a product

update_product writes

Update a product

list_prices read-only

List prices

create_price writes

Create a price

get_price read-only

Get a price

update_price writes

Update a price

Show 75 more tools

preview_prices read-only

Preview prices

list_discounts read-only

List discounts

create_discount writes

Create a discount

get_discount read-only

Get a discount

update_discount writes

Update a discount

list_discount_groups read-only

List discount groups

create_discount_group writes

Create a discount group

get_discount_group read-only

Get a discount group

update_discount_group writes

Update a discount group

archive_discount_group destructive

Archive a discount group

list_customers read-only

List customers

create_customer writes

Create a customer

get_customer read-only

Get a customer

update_customer writes

Update a customer

list_credit_balances read-only

List credit balances for a customer

list_addresses read-only

List addresses for a customer

create_address writes

Create an address for a customer

get_address read-only

Get an address for a customer

update_address writes

Update an address for a customer

list_businesses read-only

List businesses for a customer

create_business writes

Create a business for a customer

get_business read-only

Get a business for a customer

update_business writes

Update a business for a customer

list_transactions read-only

List transactions

create_transaction writes

Create a transaction

get_transaction read-only

Get a transaction

update_transaction writes

Update a transaction

preview_transaction_create read-only

Preview a transaction

revise_transaction destructive

Revise customer information on a billed or completed transaction

get_transaction_invoice read-only

Get a PDF invoice for a transaction

list_adjustments read-only

List adjustments

create_adjustment writes

Create an adjustment

get_adjustment_credit_note read-only

Get a PDF credit note for an adjustment

list_subscriptions read-only

List subscriptions

get_subscription read-only

Get a subscription

update_subscription writes

Update a subscription

cancel_subscription destructive

Cancel a subscription

pause_subscription writes

Pause a subscription

resume_subscription writes

Resume a paused subscription

activate_subscription writes

Activate a trialing subscription

preview_subscription_update read-only

Preview an update to a subscription

create_subscription_charge writes

Create a one-time charge for a subscription

preview_subscription_charge read-only

Preview a one-time charge for a subscription

list_saved_payment_methods read-only

List payment methods saved for a customer

get_saved_payment_method read-only

Get a payment method saved for a customer

delete_saved_payment_method destructive

Delete a payment method saved for a customer

create_customer_portal_session writes

Create a customer portal session

list_notification_settings read-only

List notification settings

create_notification_setting writes

Create a notification setting

get_notification_setting read-only

Get a notification setting

update_notification_setting writes

Update a notification setting

delete_notification_setting destructive

Delete a notification setting

list_events read-only

List events

list_notifications read-only

List notifications

get_notification read-only

Get a notification

replay_notification writes

Replay a notification

list_notification_logs read-only

List logs for a notification

list_simulations read-only

List simulations

create_simulation writes

Create a simulation

get_simulation read-only

Get a simulation

update_simulation writes

Update a simulation

list_simulation_runs read-only

List runs for a simulation

create_simulation_run writes

Create a run for a simulation

get_simulation_run read-only

Get a run for a simulation

list_simulation_run_events read-only

List events for a simulation run

get_simulation_run_event read-only

Get an event for a simulation run

replay_simulation_run_event writes

Replay an event for a simulation run

list_reports read-only

List reports

create_report writes

Create a report

get_report read-only

Get a report

get_report_csv read-only

Get a CSV file for a report

list_client_side_tokens read-only

List client-side tokens

create_client_side_token writes

Create a client-side token

get_client_side_token read-only

Get a client-side token

revoke_client_side_token destructive

Revoke a client-side token

Use cases

Manage product catalog and pricing

Handle subscriptions, payments, and refunds

Debug billing and order management issues

Create and adjust transactions in conversation

Generate financial reports

Supported clients

Claude Desktop

Cursor

VS Code

Windsurf

Listed from the project's documentation, not tested by this site.

Overview

This is a Model Context Protocol (MCP) server that provides LLMs and AI agents with tools for interacting with the Paddle API. It supports Paddle Billing, not Paddle Classic. The server has near parity with the Paddle API, allowing management of product catalog, viewing customer and purchase information, handling subscriptions, payments, and refunds, debugging billing issues, creating and adjusting transactions in conversation, and generating financial reports.

Similar servers

Hevy MCP 77 · B

Manage your Hevy workout data from AI assistants via MCP.

★ 509 · Tools 26 Compare with this →

Firecrawl MCP Server 75 · B

Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents

★ 7.6k · Tools 11 Compare with this →

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 654 · Tools 11 Compare with this →

Compartment 75 · B

Encrypted, fully offline long-term memory for AI agents

★ 579 · Tools 14 Compare with this →

Compare with other MCP servers

Source revision befead4560be Data synced 2026-10-12 Read the FMRS scoring method