# Paddle MCP for AI Agents AI Agent Connect

> Paddle MCP lets you manage your SaaS billing, subscriptions, and transactions directly through your AI agent. You can pull customer records, handle plan changes like pausing or canceling, and grab pricing data without leaving your chat interface.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_iApkUhC3WkMhTJGQ3RDbIZIvCfwGAJhDm0YuoHY3/ai-agent-connect
- **Tags:** billing, subscription-management, tax-compliance, payment-processing, revenue-analytics, invoice-management

## Description

Managing a SaaS business usually means jumping between your CRM and a billing dashboard to find out why a customer's payment failed or to manually pause a plan. You end up copy-pasting order IDs, hunting through transaction logs, and manually updating subscription statuses in different tabs. This Connector changes that by putting your billing data right where you're already working. Instead of hunting for invoice IDs, you just ask your agent to pull the latest records or check a subscription's status. It handles the heavy lifting of navigating the Merchant of Record platform so you can stay focused on your actual work. Whether you're troubleshooting a billing issue for a frustrated user or pulling revenue data for a monthly report, you can do it in a single conversation. It's one of the core tools in the Vinkius catalog that makes handling complex subscription lifecycles feel like a natural part of your workflow. You get a clear view of your customer base and your revenue streams without the friction of manual data entry or constant context switching. This is especially useful for support teams who need to act fast on billing disputes or for finance teams who need to pull structured revenue data for quarterly reports. You can finally stop worrying about the friction of the billing dashboard and start focusing on your customers.

## Tools

### cancel_subscription
Ends an active subscription. You can set it to happen right now or at the end of the current billing cycle.

### get_customer_details
Pulls the full profile for a specific customer. It's useful for seeing their contact info and tax details in one go.

### get_subscription_details
Shows the current status of a specific plan. Use it to check next billing dates and current payment amounts.

### get_transaction_details
Grabs the specifics of a single payment. This helps you see prorations and individual line items.

### list_customers
Returns a list of all accounts in your Paddle dashboard. It's the fastest way to see your entire customer base.

### list_catalog_prices
Shows all the different pricing definitions you've set up. Use this to see how different tiers are priced across regions.

### list_subscriptions
Pulls a list of every active and past subscription. Use it to audit your current recurring revenue.

### list_transactions
Shows every billing event in your history. This is your go-to for auditing payments and finding specific receipts.

### pause_subscription
Temporarily halts a recurring plan. It's perfect for customers who need a break without fully canceling.

### list_catalog_products
Lists every product you currently sell. It helps your agent understand what's available in your store.

## Prompt Examples

**Prompt:** 
```
Can you check the status of subscription sub_9921?
```

**Response:** 
```
The subscription **sub_9921** is currently **Active**. The next billing date is **December 1st, 2024**, for the amount of **$49.00 USD**. It's linked to customer **ctm_4432**. Would you like me to pause this for the user?
```

**Prompt:** 
```
What was the last payment for customer ctm_8821?
```

**Response:** 
```
The most recent transaction for customer **ctm_8821** was:

* **Amount:** $120.00 USD
* **Status:** Paid
* **Date:** Oct 15, 2024
* **Type:** Monthly Renewal

Would you like to see the full transaction details including the tax breakdown?
```

**Prompt:** 
```
List the prices for our Pro plan in different regions.
```

**Response:** 
```
I've pulled the pricing definitions for the **Pro Plan**. Here are the current localized prices:

| Region | Price | Tax Included |
| :--- | :--- | :--- |
| US | $49.00 | Yes |
| EU | €55.00 | Yes |
| UK | £52.00 | Yes |
```

## Capabilities

### Pull customer billing records
Get full customer profiles and tax identification details instantly.

### Modify subscription statuses
Pause or cancel active plans with specific timing instructions.

### Fetch transaction history
Retrieve payment logs including prorations and individual line items.

### Look up product pricing
Access localized pricing definitions for all your products.

### Verify tax boundaries
Extract exact tax identification data for your customer base.

## Use Cases

### Handling a subscription pause request
A customer wants to pause their seats for a month. The support agent asks the AI to use pause_subscription on the account ID to stop billing immediately.

### Auditing regional tax boundaries
RevOps needs to know the tax boundaries for a new country. The analyst asks the agent to list_customers to see the tax IDs for existing accounts in that region.

### Verifying a customer overcharge claim
A user claims they were overcharged. The agent pulls the specific payment history using get_transaction_details to verify the proration and line items.

### Checking localized product pricing
A developer needs to know the price of a specific SKU in the UK. They ask the agent to check list_catalog_prices for that product.

## Benefits

- Stop manual tab-switching by letting your agent fetch customer records with list_customers or get_customer_details.
- Handle plan changes instantly using cancel_subscription or pause_subscription to give users immediate support.
- Audit your revenue more accurately by pulling transaction history with list_transactions and get_transaction_details.
- Verify localized pricing across regions quickly using list_catalog_prices to ensure your agent gives correct quotes.
- Streamline support tickets by checking subscription statuses with get_subscription_details without leaving your chat window.

## How It Works

The bottom line is you get a direct line to your billing data without ever opening the Paddle dashboard.

1. Subscribe to the Paddle MCP on Vinkius.
2. Enter your Paddle API Key in the configuration.
3. Ask your agent to check a customer's billing status or update a plan.

## Frequently Asked Questions

**Can the Paddle MCP help my support team manage plan changes?**
Yes, it lets agents pause or cancel subscriptions directly. This means your team can handle requests in real-time without needing to switch to a different dashboard.

**Does the Paddle MCP allow me to see my transaction history?**
Yes, you can pull lists of all billing events and specific details. This is great for auditing payments or finding specific receipts for your customers.

**Can I use the Paddle MCP to check customer tax information?**
Yes, it lets you see the tax identification boundaries for your accounts. This is helpful for ensuring your billing records are accurate and compliant.

**How does the Paddle MCP help with revenue reporting?**
It lets you pull structured transaction arrays and pricing data for analysis. Your agent can gather these details instantly to help you build revenue models.

**Can the Paddle MCP handle refunds?**
No, this Connector is for managing subscription states and viewing records. For processing actual refunds, you still need to use the Paddle dashboard.

**Will the Paddle MCP show me my product catalog?**
Yes, it can list all your products and their localized pricing definitions. This helps your agent provide accurate quotes to potential customers.

**Can I cancel a customer subscription directly from chat?**
Yes. The agent leverages the `cancel_subscription` tool to stop recurring plans natively. You can instruct the agent to cancel it "immediately" or "at the next_billing_period" according to Paddle's API logical boundaries.

**How do I fetch the exact localized checkout prices?**
The `list_catalog_prices` query extracts the complete Price definitions from your Paddle system. It details the billing frequency, currency boundaries, tax-inclusiveness flags, and item descriptions seamlessly.

**Is Paddle Classic Supported or is this for Paddle Billing?**
This integration targets the modern Paddle Billing REST API which leverages robust structural objects (like Customers, Businesses, and Subscriptions) ensuring clean MoR tax boundaries and granular item mappings.