# Chargebee MCP

> Chargebee MCP manages complex billing cycles, letting you automate subscription changes and track revenue data directly within your AI workflow. Connect to this service to list active subscriptions, query customer profiles, or cancel accounts without leaving your agent environment. It gives operations teams full control over the entire subscriber lifecycle—from onboarding a new user to reconciling overdue invoices.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** recurring-billing, revenue-operations, subscription-management, churn-reduction, invoicing, saas-metrics

## Description

This MCP connects your AI client directly to your billing engine, giving you natural language access to every aspect of your recurring revenue model. Instead of logging into a dashboard and clicking through menus, you simply ask your agent what needs to happen.

Need to onboard a new user? Your agent can execute the necessary steps: first creating the customer profile, then setting up the initial subscription based on available plans. Need to adjust an account mid-cycle? You can inspect existing subscriptions or even cancel them entirely.

This level of control means your billing data—customer details, payment statuses, and invoice history—is immediately actionable within a single workflow. When you connect this MCP via Vinkius, you bring the full power of Chargebee directly into your chat interface, letting you keep revenue operations inside your primary AI environment.

## Tools

### cancel_subscription
Cancels an existing customer's subscription account.

### create_customer
Creates a brand new profile for a paying customer.

### create_subscription
Sets up a paid, recurring subscription for an existing or new customer.

### get_customer
Retrieves all specific details associated with one customer ID.

### get_subscription
Fetches the full data sheet for a single subscription record.

### list_addons
Shows all additional product features or upgrades that can be sold.

### list_customers
Provides an overview list of all customers in your system.

### list_invoices
Lists billing invoices, allowing filtering by status or customer ID.

### list_plans
Shows the full catalog of standard product pricing plans available for sale.

### list_subscriptions
Lists all subscriptions, supporting filters like status or date range.

## Prompt Examples

**Prompt:** 
```
List all active subscriptions in Chargebee.
```

**Response:** 
```
I've fetched the subscriptions. You have 12 active subscriptions, including 'sub_123' (Premium Plan) and 'sub_456' (Standard Plan).
```

**Prompt:** 
```
Show me details for customer 'cust_789'.
```

**Response:** 
```
Customer 'cust_789' is John Doe (john@example.com), based in New York. They have an active payment source on file.
```

**Prompt:** 
```
Find all overdue invoices.
```

**Response:** 
```
I've analyzed your invoices. There are currently 3 overdue invoices totaling $450. Would you like the list of customer IDs for these invoices?
```

## Capabilities

### Manage Subscription Status
List all subscriptions—active, trialing, or cancelled—and retrieve specific details about them.

### Track Customer Profiles
Fetch complete records for any customer, including contact information and billing payment sources.

### Reconcile Invoices and Payments
Query the system to find invoices that are paid, pending, or overdue, helping you track immediate cash flow.

### Onboard New Users Programmatically
Create new customer accounts and immediately establish their initial subscription plan.

### Update Product Offerings
List available product plans and addons to understand what you can sell or bundle with a client account.

## Use Cases

### Handling an Immediate Churn Risk
A customer support rep needs to address a user threatening to leave. The agent checks the account details by running `get_customer`, sees their subscription is about to expire, and then uses `list_plans` to suggest upgrading them before they cancel. This keeps the revenue flow positive.

### Reconciling Q3 Payments
The finance team needs a list of all invoices that are past due for specific regional clients. The agent runs `list_invoices`, filtering by 'overdue' status, and provides the exact total amount owed, avoiding manual spreadsheet reconciliation.

### Onboarding Enterprise Clients
A sales rep closes a massive deal requiring three different service tiers. The agent first runs `create_customer` for the new entity, then uses `list_plans` to select the correct pricing, and finally executes `create_subscription` with all the necessary details.

### Investigating Account Errors
A user reports an incorrect charge. The agent retrieves both the subscription data using `get_subscription` and checks the payment history via `list_invoices`. By comparing these two records, they pinpoint exactly when the billing error occurred.

## Benefits

- Stop bouncing between tabs. Need to cancel an account or update a payment source? Your agent can execute the `cancel_subscription` tool and confirm the action, all in one chat window.
- Slash onboarding time by automating setup. Instead of manually creating profiles, your agent can run `create_customer` followed immediately by `create_subscription`, turning conversation into operational reality.
- Get a clear picture of cash flow instantly. You don't have to filter massive spreadsheets; you ask the agent to `list_invoices` and get immediate counts of overdue or pending payments.
- Better customer data means less churn risk. Use `get_customer` to pull up payment history, contact details, and current subscription status for any client ID on demand.
- Pricing clarity is now instant. When a salesperson asks what tiers are available, your agent can run `list_plans` or check out the full range of product addons using `list_addons`.

## How It Works

The bottom line is that your AI client handles the connection details and the necessary data calls, presenting you with clean answers without requiring manual authentication or dashboard navigation.

1. Subscribe to this MCP and provide your specific Chargebee Site name and API Key.
2. Your AI agent uses these credentials to authenticate against the billing system's tools.
3. You instruct the agent using natural language, which translates into a structured API call (e.g., 'Find all invoices over 60 days old').

## Frequently Asked Questions

**How do I find out what plans are available using Chargebee MCP?**
Use the `list_plans` tool to view all standard product pricing tiers. This gives you a comprehensive catalog of services and their base costs.

**Can I use Chargebee MCP to create an account from scratch?**
Yes, you can execute this in two steps: first, run `create_customer` to generate the profile. Then, immediately follow up with `create_subscription` to activate their paid service.

**What if I need to check all overdue invoices using Chargebee MCP?**
You simply ask your agent to list invoices and specify 'overdue' in the request. The system runs `list_invoices` and provides a filtered, actionable summary of what needs immediate attention.

**Is Chargebee MCP only for existing subscribers?**
No, it supports both new and existing accounts. You can create entirely new customer profiles using `create_customer` before setting up their first paid subscription.

**Does Chargebee MCP help with product add-ons?**
Yes, the `list_addons` tool shows you all available extra features or upgrades. You can use this information to upsell clients or structure new bundles for them.