# Chargebee MCP for AI Agents MCP

> Chargebee connects your AI agent directly to your SaaS billing backend, giving you control over every aspect of recurring revenue management. You can instantly list customers, create new B2B accounts, manage subscriptions, run detailed invoice checks, and even generate secure hosted checkout links—all by simply chatting with your AI client.

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

## Description

Need to understand why a customer's billing cycle is complicated? Chargebee lets you chat with your revenue data instead of drowning in spreadsheets. Your agent can handle complex financial operations, from listing all active accounts to generating an instant payment link for a specific product plan.

It’s about taking absolute control of your subscription lifecycle. Need to know if a user's card declined? Ask the AI client. Want to pause service until the end of their contract? It handles that complex logic automatically. Whether you're checking outstanding balances, reviewing past billing logs, or provisioning an entirely new customer record, the process is immediate and conversational.

By connecting this MCP via Vinkius, your agent becomes a single pane of glass for all billing actions. You bypass manually clicking through dashboards; instead, you just ask questions about your revenue pipeline and get actionable data back.

## Tools

### cancel_subscription
Permanently ends a subscription service, recording the termination date in your billing system.

### create_customer
Adds an entirely new B2B account to Chargebee, generating a unique customer ID.

### generate_hosted_checkout
Creates a secure, temporary payment link for customers to enter their credit card details immediately.

### get_customer_details
Retrieves detailed property information about an existing customer account.

### get_subscription_details
Inspecting a subscription to understand its deep internal plan structure and billing rules.

### list_customers
Pulls a full list of all customer records managed within the platform.

### list_invoices
Generates an enumerated list of past and active billing documents, including payment status.

### list_catalog_items
Retrieves the structured data for all product lines defined in your catalog.

### list_subscriptions
Provides a list of all current and historical subscription plans and their recurring limits.

### pause_subscription
Suspends an active subscription's billing cycle, keeping the service accessible but preventing further charges.

## Prompt Examples

**Prompt:** 
```
I need to see all customers whose subscriptions are set to expire next month.
```

**Response:** 
```
**Billing Status Report: Expiration Cycle**

*   **cust_3912**: Expires 2024-10-05 (Tier: Basic)
*   **cust_8876**: Expires 2024-10-15 (Tier: Pro - *Needs Attention*)
*   **cust_1102**: Expires 2024-10-30 (Tier: Enterprise)

We should follow up with cust_8876 about their usage spike. They might need an upgrade.
```

**Prompt:** 
```
Can you create a new account for Acme Corp and get me a checkout link?
```

**Response:** 
```
**New Account Provisioned.**

✅ Customer 'Acme Corp' created successfully. ID: cust_A9B2X.

Here is the secure hosted payment URL for your initial setup:
[https://checkout.chargebee.com/a9b2x?plan=pro]

You can share this link with their purchasing manager.
```

**Prompt:** 
```
Which customers have outstanding balances and need to be paused?
```

**Response:** 
```
**⚠️ Action Required: Billing Review**

I found 3 accounts with overdue payments:

*   cust_4012 (Overdue: $59.99)
*   cust_7188 (Overdue: $199.00)
*   cust_2201 (Overdue: $49.99)

I recommend pausing service for all three immediately to prevent further revenue loss.
```

## Capabilities

### Manage Customer Records
You can list existing accounts or create brand new B2B customer profiles instantly.

### Audit Subscription Status
Inspect any plan—whether active, trailing, or cancelled—and determine its current billing status or history.

### Control Subscriptions
Temporarily pause a service's renewal cycle or irreversibly cancel an account mid-term without issue.

### Review Payment History
Retrieve active billing logs and check if specific charges were approved or declined by the payment gateway.

### Process Payments On Demand
Get a secure, temporary hosted checkout link so customers can pay with their cards right from the chat interface.

## Use Cases

### A client calls, claiming they weren't billed correctly last month.
The support agent asks their agent to review active billing logs. The agent runs through the list_invoices tool and reports back: 'I see a charge on May 15th for $99. This was an upgrade triggered by product X, which is logged in the subscription details.' The client is informed instantly.

### The sales team needs to close a deal quickly.
Instead of emailing pricing sheets, the rep asks their agent: 'Generate a payment link for the Pro plan for this user.' The agent immediately uses generate_hosted_checkout and provides a secure, single-use URL right in the chat.

### An account is failing to pay on time.
The ops manager asks their agent to pull a list of customers with overdue payments. The agent uses list_customers and then checks individual records using get_customer_details, providing a prioritized list for immediate follow-up.

### A user's payment failed due to bank issues.
The support team asks the agent to review invoices. The agent runs list_invoices and detects 'Payment Declined' status, notifying the team that they need to manually pause the service using pause_subscription.

## Benefits

- Avoid manual data pulls. You can ask the agent to list all customers or retrieve specific financial details, eliminating time spent in complex dashboards.
- Speed up sales cycles by generating an instant hosted checkout URL for any product plan while you're still talking to a prospect.
- Support teams gain immediate visibility. Check if a user’s subscription status is paused, cancelled, or active without needing access to the billing platform itself.
- Maintain accurate revenue records. Your agent can analyze entire lists of invoices and tell you exactly which payments were declined by the gateway.
- Control the customer lifecycle precisely. You can pause service for a delinquent account or irreversibly cancel it at the end of its current term.

## How It Works

The bottom line is: your agent talks directly to your Chargebee database and executes commands on your behalf.

1. Subscribe to this MCP and provide your specific Chargebee Site ID along with an API Key.
2. Your AI client uses these credentials to authenticate against the live billing environment.
3. You interact naturally, asking for actions like 'List all customers who owe money' or 'Pause sub_123 until next month'.

## Frequently Asked Questions

**How does the Chargebee MCP help me manage customer subscriptions?**
This MCP lets your agent inspect every subscription—whether it's active, paused, or cancelled. You can determine if a plan is trailing or what its exact next renewal date is without opening any dashboards.

**Can I use the Chargebee MCP to process payments?**
Yes. Your agent can generate a secure hosted checkout URL on demand, allowing you to capture customer card details right within your chat interface instantly.

**What if an account is delinquent? Can this MCP help me pause service?**
Absolutely. You can ask the agent to pause a subscription immediately using the dedicated tool. It suspends billing while keeping the customer's access available until you reactivate it.

**Does the Chargebee MCP only handle simple billing tasks?**
No, it manages complex revenue operations. You can review entire lists of invoices to check for declined payments or verify historical billing logs against current customer details.

**Do I need developer help to use the Chargebee MCP with my AI agent?**
No. Once connected, you interact through natural conversation. You simply tell your agent what data you need—like a list of all active accounts or details for one specific customer.

**What if I need to onboard a brand new client account?**
Your agent can provision the entire record for you by running the create_customer tool. It creates the B2B account and keeps all the necessary billing records immediately ready.