Paddle MCP Server

What is Paddle MCP Server about?

Provides a Model Context Protocol (MCP) server that exposes Paddle Billing operations—product catalog, pricing, customers, transactions, subscriptions, and reporting—so AI assistants and IDE extensions can call these capabilities directly.

How to use Paddle MCP Server?

Obtain a Paddle API key from the Paddle dashboard (sandbox or production).
Add the server to your MCP configuration, e.g. in Claude Desktop, Cursor, or Windsurf, using the npx command shown below.
Run the server via the configured command; the MCP client will invoke the provided endpoints.

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"],
      "env": { "PADDLE_API_KEY": "<YOUR_API_KEY>" }
    }
  }
}

Replace PADDLE_API_KEY with your actual key and choose the appropriate environment.

Key Features

List and create products in the Paddle catalog
List and create pricing tiers for products
Retrieve customer information
Query transactions and subscription details
Generate custom financial reports for analysis
Works seamlessly with AI‑powered tools (Claude, Cursor, Windsurf) via MCP

Use Cases

AI‑assisted billing dashboards: Let an AI assistant fetch subscription status or revenue metrics on demand.
Automated product management: Use code generation tools to add new products or prices without manual API calls.
Financial reporting: Generate ad‑hoc reports through natural language prompts within an IDE.
Customer support bots: Retrieve a customer’s billing history instantly during a support interaction.

FAQ

Q: Does this server work with Paddle Classic? A: No, it only supports Paddle Billing. For Classic, see the Paddle Classic API reference.

Q: Which command should I use to run the server? A: Prefer npx as shown in the configuration; it installs the package on the fly.

Q: How do I switch between sandbox and production? A: Set the --environment flag to sandbox or production (or use the PADDLE_ENVIRONMENT env variable).

Q: Can I debug the server? A: Yes, run pnpm inspector to launch the MCP Inspector tool for request/response debugging.

Q: What runtime is required? A: Node.js (npm) environment; the server is distributed as an npm package.

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

List products in your Paddle catalog
Create new products
List prices for products
Create new prices for products
List customers
List transactions
List subscriptions
Create custom reports for financial analysis

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)"]
    }
  }
}

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

For detailed setup guides, see:

Development

Install dependencies:
```
pnpm install
```
Build the server:
```
pnpm build
```

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"
      }
    }
  }
}

Debugging

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

Run the server with the inspector:
```
pnpm inspector
```
Open the provided URL in your browser to view and debug the MCP requests and responses.
Include the --api-key and --environment arguments.