MCP Server for Paddle Billing
About
MCP Server for Paddle Billing is a Model Context Protocol server that provides tools for interacting with the Paddle Billing API. It is designed for developers using Paddle Billing, the developer-first merchant of record, and does not support Paddle Classic.
Details
- Author
- MCP-Mirror
- Downloads
- 355
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server for Paddle BillingCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain a Paddle Billing API key from the Paddle dashboard (sandbox or live). Run the server using npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production). For client integration, add the server configuration to your MCP config file (e.g., for Claude Desktop, Cursor, or Windsurf).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server for paddle billing": {
"paddle": {
"command": "npx",
"args": [
"-y",
"@paddle/paddle-mcp",
"--api-key=PADDLE_API_KEY",
"--environment=(sandbox|production)"
]
}
}
}
}McpServers
{
"paddle": {
"command": "npx",
"args": [
"-y",
"@paddle/paddle-mcp",
"--api-key=PADDLE_API_KEY",
"--environment=(sandbox|production)"
]
}
}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
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 as environment.
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)"]
}
}
}
For detailed setup guides, see:
- Claude Desktop
- Cursor
- Windsurf
Development
1. Install dependencies:
pnpm install
2. Build the server:
pnpm build
3. 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:
1. Run the server with the inspector:
pnpm inspector
2. Open the provided URL in your browser to view and debug the MCP requests and responses.
3. Include the --api-key and --environment arguments.
Learn more
- Paddle developer docs
- Paddle API reference
- Sign up for Paddle Billing
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
