Paddle MCP

How to Install and Use Paddle MCP

Paddle MCP is a helpful server that connects AI tools to the Paddle Billing API, making it easier to manage payments, subscriptions, and other business tasks. Here’s a simple guide on how to install and use Paddle MCP with real examples.

Getting Your Paddle API Key

Before installing Paddle MCP, you need a Paddle API key. This key lets Paddle MCP talk with your Paddle account securely.

You can create and manage API keys by going to Paddle's developer tools in the Authentication section here:

• Sandbox (testing): https://sandbox-vendors.paddle.com/authentication-v2
• Live (real account): https://vendors.paddle.com/authentication-v2

Make sure to copy your API key—you’ll need it later.

Installing Paddle MCP Using Cursor or VS Code

If you use Cursor or VS Code, installing Paddle MCP is super easy with one click. This method installs the server and sets it up quickly.

After the installation, open your MCP settings file and change the placeholder your_api_key to the actual API key you got earlier. You can also choose if you want to use the sandbox for testing or the production live environment.

Then adjust the tools you want, for example, "non-destructive" to allow safe write actions.

Installing Paddle MCP with Command-Line Arguments

If you prefer using the command line or want more control, you can add Paddle MCP to your MCP settings like this:

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

Here, replace your_api_key with your real Paddle API key. Set --environment to either "sandbox" or "production" to pick the environment. The --tools option controls which Paddle actions are available.

This method is recommended if you run MCP servers with npx or through a developer setup.

Installing Paddle MCP Using Environment Variables

You also have the option to use environment variables. This works well if you want to keep API keys secret or use configuration files.

Add this to your MCP settings:

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp"],
      "env": {
        "PADDLE_API_KEY": "your_api_key",
        "PADDLE_ENVIRONMENT": "sandbox",
        "PADDLE_MCP_TOOLS": "non-destructive"
      }
    }
  }
}

Again, update "your_api_key" with your actual API key. Choose the environment and tools as you want.

Choosing Which Tools to Load

Paddle MCP lets you control the tools available to AI assistants. You can load:

• all — every tool
• read-only — only tools that show data, no changes
• non-destructive — safe read and write tools (default)
• Or pick specific tools by name (e.g., list_products,get_product,create_product)

You set this choice with the --tools argument in command-line or the environment variable PADDLE_MCP_TOOLS.

Summary

1. Get your API key from Paddle Developer tools.
2. Pick an installation method:
   • One-click setup for Cursor or VS Code
   • Command-line with JSON config
   • Environment variables in config
3. Update your MCP settings file with your API key, environment, and tools choices.
4. Run Paddle MCP in your client to start managing your Paddle account with AI.

By following these steps, Paddle MCP will connect your AI assistant with Paddle Billing, making business management easier and faster.