MCP Server for Paddle Billing
Official Paddle Billing MCP server: catalog, customers, transactions, subscriptions and reports via your agent, with a filter for risky operations
Install
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp"],
"env": {
"PADDLE_API_KEY": "your_api_key",
"PADDLE_ENVIRONMENT": "sandbox",
"PADDLE_MCP_TOOLS": "non-destructive"
}
}
}
}PADDLE_ENVIRONMENT is sandbox or production. Cursor and VS Code have install buttons in the README.
This is third-party code. Review the repository files before installing.
What it does
The server exposes nearly the whole Paddle Billing API to the agent. The agent manages products, prices and discounts, views customers, addresses and businesses, creates and inspects transactions and fetches PDF invoices. It manages subscriptions: updates, pauses, cancels and creates one-time charges. It also handles reports with CSV export, notification settings, webhook simulations and client-side tokens. Tools can be limited to read-only, non-destructive, all or a list of names.
Who it is for. For developers and finance teams of products that take payments through Paddle Billing.
Good fit when
- You need to find out why a customer's payment failed or a subscription misbehaves
- You want to set up products and prices in the sandbox to test an integration
- You need a transaction or subscription report without manual exports
Not a fit when
- Your account is on Paddle Classic, which is not supported
- The agent must not access live payments and customer data
Example request
Find sandbox Paddle subscriptions that went past_due in the last week and show their transactionsLimitations
Works only with Paddle Billing; Classic is not supported. Needs an API key from the Paddle dashboard, separate for sandbox and live. Only non-destructive tools load by default; the all mode lets the agent cancel subscriptions and delete saved payment methods. Paddle does not serve sellers from Russia, and API access without a VPN is unverified.
How to disable. Remove the paddle block from your MCP config and revoke the API key under Developer tools in the Paddle dashboard.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| PADDLE_API_KEY required, secret | API key from Paddle under Developer tools, Authentication. |
| PADDLE_ENVIRONMENT | Environment: sandbox or production. |
| PADDLE_MCP_TOOLS | Tool set: all, read-only, non-destructive (default) or a comma-separated list of names. |
Security check
- Creates transactions and changes subscriptions in a payment system
- Has access to customer data and a secret API key
README in short
The README lists tools by API group, marking which are read-only and which are non-destructive. It gives three install options: buttons for Cursor and VS Code, npx command-line arguments and environment variables. It also explains the tool filter and running a local build with MCP Inspector. Apache 2.0 licensed.
FAQ
How do I stop the agent from changing data?
Set PADDLE_MCP_TOOLS=read-only or pass --tools=read-only. You can also list specific tools separated by commas.
Can I try it without real money?
Yes, set the environment to sandbox and use a sandbox API key.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio