paddle MCP Server

Use This MCP server To

List and manage products in Paddle catalog via AI Create and update product prices programmatically Retrieve customer and transaction data for analysis Manage subscriptions and billing through AI workflows Generate custom financial reports automatically Integrate Paddle billing data into AI-powered IDEs Automate subscription lifecycle management Fetch real-time payment and tax information

README

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.

Learn more

paddle-mcp-server FAQ

Does paddle-mcp-server support Paddle Classic API?

No, it only supports Paddle Billing, not Paddle Classic.

How do I authenticate the paddle-mcp-server?

You need to provide your Paddle Billing API credentials during setup.

Can I create new products and prices using this server?

Yes, it supports creating products and prices in your Paddle catalog.

Is it possible to generate custom financial reports?

Yes, the server allows creating custom reports for financial analysis.

Can this server be used with AI assistants like Claude or IDEs like Cursor?

Yes, it is designed to integrate with AI assistants and AI-powered IDEs.

What kind of data can I retrieve from the paddle-mcp-server?

You can list products, customers, transactions, subscriptions, and prices.

Does the server handle payment, tax, and subscription management?

Yes, it leverages Paddle Billing's unified API for these functions.

Is the paddle-mcp-server open source?

Yes, it is available on GitHub for developers to use and contribute.