Best for
- Developers using Paddle Billing
- Integrating AI assistants into payment and subscription workflows
- Querying Paddle API data via natural language
P
Paddle MCP Server
Official
Interact with the Paddle API using AI assistants, manage product catalog, billing, and subscriptions.
GitHub source repository ↗
70FMRS · B
The Paddle MCP server provides comprehensive integration with the Paddle Billing API, offering numerous tools and robust functionality. However, attention must be paid to permission controls and environment settings to avoid mistakes.
This is a Model Context Protocol (MCP) server that provides LLMs and AI agents with tools for interacting with the Paddle API. It supports Paddle Billing, not Paddle Classic. The server has near parity with the Paddle API, allowing management of product catalog, viewing customer and purchase information, handling subscriptions, payments, and refunds, debugging billing issues, creating and adjusting transactions in conversation, and generating financial reports.
Tools
list_products
List products
create_product
Create a product
get_product
Get a product
update_product
Update a product
list_prices
List prices
create_price
Create a price
get_price
Get a price
update_price
Update a price
preview_prices
Preview prices
list_discounts
List discounts
create_discount
Create a discount
get_discount
Get a discount
update_discount
Update a discount
list_discount_groups
List discount groups
create_discount_group
Create a discount group
get_discount_group
Get a discount group
update_discount_group
Update a discount group
archive_discount_group
Archive a discount group
list_customers
List customers
create_customer
Create a customer
get_customer
Get a customer
update_customer
Update a customer
list_credit_balances
List credit balances for a customer
list_addresses
List addresses for a customer
create_address
Create an address for a customer
get_address
Get an address for a customer
update_address
Update an address for a customer
list_businesses
List businesses for a customer
create_business
Create a business for a customer
get_business
Get a business for a customer
update_business
Update a business for a customer
list_transactions
List transactions
create_transaction
Create a transaction
get_transaction
Get a transaction
update_transaction
Update a transaction
preview_transaction_create
Preview a transaction
revise_transaction
Revise customer information on a billed or completed transaction
get_transaction_invoice
Get a PDF invoice for a transaction
list_adjustments
List adjustments
create_adjustment
Create an adjustment
get_adjustment_credit_note
Get a PDF credit note for an adjustment
list_subscriptions
List subscriptions
get_subscription
Get a subscription
update_subscription
Update a subscription
cancel_subscription
Cancel a subscription
pause_subscription
Pause a subscription
resume_subscription
Resume a paused subscription
activate_subscription
Activate a trialing subscription
preview_subscription_update
Preview an update to a subscription
create_subscription_charge
Create a one-time charge for a subscription
preview_subscription_charge
Preview a one-time charge for a subscription
list_saved_payment_methods
List payment methods saved for a customer
get_saved_payment_method
Get a payment method saved for a customer
delete_saved_payment_method
Delete a payment method saved for a customer
create_customer_portal_session
Create a customer portal session
list_notification_settings
List notification settings
create_notification_setting
Create a notification setting
get_notification_setting
Get a notification setting
update_notification_setting
Update a notification setting
delete_notification_setting
Delete a notification setting
list_events
List events
list_notifications
List notifications
get_notification
Get a notification
replay_notification
Replay a notification
list_notification_logs
List logs for a notification
list_simulations
List simulations
create_simulation
Create a simulation
get_simulation
Get a simulation
update_simulation
Update a simulation
list_simulation_runs
List runs for a simulation
create_simulation_run
Create a run for a simulation
get_simulation_run
Get a run for a simulation
list_simulation_run_events
List events for a simulation run
get_simulation_run_event
Get an event for a simulation run
replay_simulation_run_event
Replay an event for a simulation run
list_reports
List reports
create_report
Create a report
get_report
Get a report
get_report_csv
Get a CSV file for a report
list_client_side_tokens
List client-side tokens
create_client_side_token
Create a client-side token
get_client_side_token
Get a client-side token
revoke_client_side_token
Revoke a client-side token
Setup
- Obtain a Paddle API key (create in Paddle > Developer tools > Authentication, sandbox or live).
- Add the server configuration to your MCP client's settings file (e.g., Claude Desktop, Cursor, VS Code, Windsurf). You can use command-line arguments or environment variables.
- Set the environment (sandbox or production) and tool filtering as needed (all, read-only, non-destructive, or specific tool names).
claude_desktop_config.json
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": [
"-y",
"@paddle/paddle-mcp",
"--api-key=your_api_key",
"--environment=sandbox",
"--tools=non-destructive"
]
}
}
}
Fit and risk
Not for
- Users of Paddle Classic
- Scenarios where interaction with Paddle API is not needed
Required permissions
- Requires a Paddle API key
- Depending on tool filtering, can perform read-only, non-destructive, or destructive operations
Risks and side effects
- API key leakage could lead to data exposure or unauthorized actions
- Destructive tools (e.g., update, cancel, pause subscriptions) can cause irreversible changes
- Ensure to test in sandbox before production
Troubleshooting
- Check that the API key is valid
- Confirm environment variables or command-line arguments are correct (e.g., --environment=sandbox)
- Use MCP Inspector to debug requests and responses
Use cases
Manage product catalog and pricing
Handle subscriptions, payments, and refunds
Debug billing and order management issues
Create and adjust transactions in conversation
Generate financial reports
Supported clients
Claude DesktopFull support
CursorFull support
VS CodeFull support
WindsurfFull support