# Paddle MCP > Paddle provides direct access to merchant-of-record billing data. Use this MCP to manage SaaS subscriptions, inspect full transaction ledgers, and look up detailed customer financial profiles—all through your AI agent. You can check if a payment was prorated, pause an active account, or list every product sold without ever logging into the Paddle dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** billing, subscription-management, tax-compliance, payment-processing, revenue-analytics, invoice-management ## Description Running a subscription business means dealing with complex billing logic: prorations, tax boundaries, and varied plan cycles. This MCP lets you pull all that financial data directly into your AI workflow. Instead of manually navigating dashboards to find out why a payment failed or when an account is due to expire, your agent handles it. You can look up specific customer accounts, check their exact tax ID status, and even list every product in your catalog with its localized pricing. Need to adjust an account? You can pause an active subscription or cancel one immediately, controlling the full lifecycle of a user's paid access. Because Vinkius hosts this MCP, you connect once from any compatible client—Claude, Cursor, Windsurf, or others—and gain immediate control over your entire billing structure and transaction history. ## Tools ### cancel_subscription Stops an active user subscription, allowing you to set the date when service termination takes effect. ### get_customer_details Retrieves specific information about a single customer account managed by Paddle. ### get_subscription_details Fetches the complete details for one particular subscription, showing its status and billing cycle. ### get_transaction_details Gets full information on a single transaction, including amounts paid, tax rates, and proration data. ### list_customers Generates a list of every customer account connected to Paddle billing. ### list_catalog_prices Lists all defined pricing structures and tax-inclusive rates for your products. ### list_catalog_products Retrieves a complete list of every product available in the catalog, including its name and details. ### list_subscriptions Provides an overview and list of all currently active or inactive subscriptions. ### list_transactions Pulls a comprehensive report listing every billing transaction that has occurred in your system. ### pause_subscription Temporarily suspends an active subscription, preventing further charges while keeping the account record intact. ## Prompt Examples **Prompt:** ``` Find the subscription details for sub_01h9z2... ``` **Response:** ``` Subscription sub_01h9z2... is currently Active. Next billing date is set for Nov 14th, 2026. Billed at $49/month (Pro SaaS Tier). It is tied to customer ctm_01jh1. Want me to pause it? ``` **Prompt:** ``` List our most recent revenue transactions on Paddle. ``` **Response:** ``` I extracted the latest transactions from Paddle Billing. 1. txn_1w2... (Paid: $19.00 USD). 2. txn_4x9... (Prorated: $10.50 USD). 3. txn_9z2... (Paid: $99.00 USD). Want me to pull specific tax boundaries applied on the $99 payment? ``` **Prompt:** ``` Cancel subscription sub_active123 at the end of the billing cycle. ``` **Response:** ``` Action complete. Subscription sub_active123 has been marked for cancellation effective mapping `next_billing_period`. The user will not be charged again by the MoR, but remains active until the pre-paid term expires. ``` ## Capabilities ### Review Customer Financial Status Get specific details on a customer's account to verify payment methods, tax IDs, and current subscription tiers. ### Manage Subscriptions Lifecycle Pause an active plan or cancel a paid subscription, setting the effective date for when service ends. ### Audit Transaction History Pull detailed lists of all billing transactions, including one-off payments, prorations, and renewal charges. ### Check Product Catalog & Pricing List every product you sell and retrieve its localized pricing details for checkout or reporting. ## Use Cases ### A user asks, 'Why was my payment only $10?' The agent uses `get_transaction_details` to pull up the specific transaction record. It identifies that the payment of $19 was prorated down to $10 because the service period was shortened mid-cycle. The agent explains this clearly and provides a direct reference to the billing logic. ### RevOps needs an audit list of all active clients. The agent runs `list_customers` followed by `get_customer_details`. It compiles a clean, structured report showing every customer's name, account status, and tax ID boundaries for finance review. ### A developer needs to test billing failure paths. The agent uses `list_catalog_products` and then simulates trying to create a subscription using `get_subscription_details`. This allows the developer to validate edge case pricing or plan failures before pushing code. ### Support needs to temporarily lock an account due to fraud. The agent uses `pause_subscription` on the customer's specific subscription ID. It confirms that the user will remain active until their prepaid cycle expires, mitigating immediate risk without service interruption. ## Benefits - Stop jumping between tabs. You can check a customer's full payment history or pause an account directly from your chat interface using tools like `pause_subscription` and `list_transactions`. - Avoid manual data entry errors. Your agent pulls complex financial metrics, such as tax boundaries or prorated charges, automatically when you use `get_transaction_details`. - See your entire product lineup in one place. Use `list_catalog_products` to quickly verify names and retrieve pricing definitions without leaving your workflow. - Improve support efficiency. When a customer calls about their payment, your agent uses `get_customer_details` to pull up the necessary financial proof instantly. - Handle billing changes with precision. Need to cancel an account? The `cancel_subscription` tool lets you specify if termination should happen immediately or at the end of the paid term. ## How It Works The bottom line is you get your AI client to execute complex financial operations that used to require multiple dashboard logins and manual clicks. 1. Subscribe to this MCP and provide your Paddle API Key. 2. Instruct your AI client, like Cursor or Claude, to perform a billing action (e.g., 'List all active subscriptions'). 3. Your agent sends the request to the MCP, which returns structured data on customer accounts, transactions, or pricing definitions. ## Frequently Asked Questions **Can I use Paddle MCP to see all my users?** Yes, you can list all customers using `list_customers`. This gives you a directory of every customer account that has interacted with your billing system. **How do I check if a payment was prorated on Paddle MCP?** Use the `get_transaction_details` tool. This function pulls comprehensive data for any transaction, clearly specifying whether it's a full charge or a prorated amount. **Does Paddle MCP let me cancel subscriptions immediately?** Yes, the `cancel_subscription` tool allows you to set the cancellation effective date. You can decide if the account shuts down right away or remains active until the pre-paid period expires. **What is the difference between listing transactions and subscriptions?** Listing transactions (`list_transactions`) gives you a financial record of money moving (payments, refunds). Listing subscriptions (`list_subscriptions`) tells you which plans are currently active or pending. **Can I check the pricing for new products using Paddle MCP?** You can use `list_catalog_products` to get product names and then `list_catalog_prices` to retrieve all associated localized checkout prices, ensuring you're billing correctly.