Paddle MCP. Manage every aspect of SaaS billing from chat.

Paddle MCP Server - Billing Management

This server gives your agent direct access to all of Paddle's billing data, letting you run complex financial queries or manage service plans without ever logging into the main dashboard. You don't need to touch the UI; you just tell your AI client what you need done. It handles everything from checking tax boundaries on a single customer account to listing every product price in the entire catalog.

Customer and Account Records

You can start by getting a full roster of who’s paying you with list_customers, which pulls an array of every current customer ID managed within Paddle. Once you have that list, you run get_customer_details against any specific ID to pull all the core data points for that client—this includes their billing status and crucial tax identification boundaries.

Knowing these details lets your agent verify if a customer is set up correctly before running any changes.

Subscriptions and Plans

The subscription tools let you manage the entire service lifecycle. If you want an overview, list_subscriptions pulls basic status information and IDs for every plan active in your system. To drill down on one specific client's plan, use get_subscription_details. This tells you if the plan is currently active, suspended, or expired, plus its next scheduled billing date.

When it comes time to adjust a plan, you have three options: pausing an account. Running pause_subscription temporarily suspends the client's ability to be billed without deleting their whole account record. If you need to cancel, cancel_subscription marks the service for termination; remember that this tool lets you specify whether the change needs to take effect immediately or if it should wait until the end of their current paid billing cycle.

Transaction Auditing and History

The financial tools let you audit every single dollar coming in. You can get a high-level overview using list_transactions, which provides a paginated list of all billing transactions, making it easy to filter for payments within a specific date range or check recent activity. For the deep dive—the kind that tracks down where a tax charge came from—you use get_transaction_details.

This pulls every single piece of data associated with one payment record, including detailed breakdowns of any proration charges or localized taxes applied.

Product and Pricing Catalog

To manage what you're selling, your agent uses the catalog tools. You can get a complete inventory list using list_catalog_products, which returns the names, IDs, and general details for every single product defined in your Paddle setup. Separately, if you need to know how much those products cost right now, run list_catalog_prices.

This pulls a full definition of all pricing structures, including the localized checkout prices that apply across different regions.

By combining these tools—listing customer IDs with list_customers, pulling their core data with get_customer_details, checking their plan status with get_subscription_details, and then running an audit on a specific payment using get_transaction_details—your agent manages your entire billing backend. You'll handle everything from catalog pricing to complex tax calculations, keeping you out of the Paddle dashboard entirely.