Paddlehq Paddle MCP Server

🚀 Paddle Billing MCP Server

Paddle Billing (Paddle Billing) is a merchant of record for developers. It handles payments, taxes, subscriptions, and metrics, providing a unified API for all operations.

This is a server based on the Model Context Protocol (MCP), offering tools to interact with the Paddle API.

⚠️ Important Note

This MCP server is designed for Paddle Billing and does not support Paddle Classic. For Paddle Classic, refer to the Paddle Classic API Documentation.

🚀 Quick Start

This server simplifies interactions with the Paddle API, enabling developers to manage products, prices, customers, and more efficiently.

✨ Features

• List products in the Paddle product catalog.
• Create new products.
• List product prices.
• Create new prices for products.
• List customers.
• List transaction records.
• List subscriptions.
• Create custom reports for financial analysis.

📦 Installation

Using the MCP server requires an API key. You can create and manage API keys in Paddle > Developer Tools > Authentication:

• Sandbox environment: https://sandbox-vendors.paddle.com/authentication-v2
• Production environment: 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 own API key and specify the correct environment value.

To run the server in clients such as 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, refer to:

• Claude Desktop
• Cursor
• Windsurf

💻 Usage Examples

Basic Usage

npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production)

Advanced Usage

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

🔧 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 a browser to view and debug MCP requests and responses.
3. Include the --api-key and --environment parameters.

📚 Documentation

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