Paddle Billing

🚀 Paddle Billing MCP Server

Paddle Billing is a merchant of record for developers. It handles payments, taxes, subscriptions, and metrics through a unified API.

Paddle Billing serves as a merchant of record for developers. We take charge of handling payments, taxes, subscriptions, and metrics, all accessible via a unified API.

This is a Model Context Protocol (MCP) server that offers tools for interacting with the Paddle API.

⚠️ Important Note

This MCP server is designed for Paddle Billing and does not support the Paddle Classic version. If you need to use the Paddle Classic version, please refer to the Paddle Classic API Reference.

✨ Features

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

📦 Installation

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

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

You can run the Paddle MCP server using npx with the following command:

npx -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 for environment.

To run the server in clients like Claude Desktop, Cursor, or Windsurf, add the following to your MCP configuration:

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

For detailed installation guides, please refer to:

• Claude Desktop
• Cursor
• Windsurf

🔧 Technical Details

Development

1. Install dependencies:

   pnpm install
   

2. Build the server:

   pnpm build
   

3. Update the 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:

1. Run the server with the inspector:

   pnpm inspector
   

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

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

📚 Documentation

• Paddle Developer Documentation
• Paddle API Reference
• Sign up for Paddle Billing