# Cheddar MCP for AI Agents MCP

> Cheddar MCP gives your AI agent full control over usage-based and subscription billing. You can check customer records, pull recent invoices, track specific charges, or monitor active pricing plans—all without logging into a dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** recurring-billing, usage-based-pricing, subscription-management, invoicing, revenue-operations

## Description

Managing recurring revenue shouldn't require jumping between multiple admin panels. This MCP connects your Cheddar account to any AI agent, letting you handle complex billing tasks using natural conversation. Need to know if a customer is over their usage limit? Ask your agent. Want to audit last month’s transactions? Just ask.

Instead of manually navigating menus or copying data points, you get direct access to core financial records. You can list all customers, pull specific product metadata, and add charges instantly when needed. By connecting this MCP via the Vinkius catalog, your AI client treats billing data like a conversation topic, not a spreadsheet puzzle.

It's about getting answers immediately. Your agent doesn't just summarize; it performs actions—like pulling detailed invoice history or confirming an active promotion—giving you instant, accurate financial oversight.

## Tools

### add_cheddar_charge
Applies a one-time fee or quantity charge to a specific customer's account.

### get_cheddar_customer_details
Retrieves detailed information for any single customer ID you provide.

### get_cheddar_product_info
Pulls foundational data about a product, including its configuration and metadata.

### list_cheddar_customers
Generates a list of all accounts currently managed within the billing system.

### list_cheddar_invoices
Retrieves a recent batch of customer invoices, including status and totals.

### list_cheddar_plans
Shows all available pricing plans that the company uses for billing.

### list_cheddar_promotions
Lists active coupons and promotions currently running on accounts.

### list_cheddar_transactions
Provides a list of recent billing activities and payment transactions for auditing purposes.

## Prompt Examples

**Prompt:** 
```
Can you show me the invoices for our top three clients last month?
```

**Response:** 
```
**Invoice Summary Report**

*   **Client A (TechCorp):** Total: $4,200. Status: 3 Settled, 1 Pending.
*   **Client B (GlobalNet):** Total: $890. Status: All Settled.
*   **Client C (LocalBiz):** Total: $150. Status: 1 Drafted.

Do you want me to pull the full PDF details for any of these? I can also check their current usage against their plan limits.
```

**Prompt:** 
```
What pricing plans do we offer right now, and are there any active coupons?
```

**Response:** 
```
We currently have three main tiers: Basic ($29/mo), Pro ($99/mo), and Enterprise (Usage-based). 

✅ **Active Promotions:** We have one promotion running: 'SPRING10' which offers 10% off any plan for the next month.

I can also check if those promotions apply to a specific customer or give you details on what each plan covers.
```

**Prompt:** 
```
Apply usage charges for Client X and list all recent activity
```

**Response:** 
```
Got it. I'm adding 50 units of 'API_CALLS' to the account now... 

✅ **Success:** 50 units added successfully for Client X. This will appear on their next bill.

Here is a quick summary of recent activity (last 3 transactions):
*   2/1: Payment Received - $99.00 (Status: Settled)
*   1/28: Usage Charge Added - $50.00 (Status: Pending)
```

## Capabilities

### Retrieve customer account details
Get specific information for any customer record in the billing system.

### List all customers and plans
Access a comprehensive directory of all active and inactive accounts, along with available pricing structures.

### Fetch billing history and invoices
Pull detailed lists of recent customer invoices, transaction records, and payment statuses.

### Manage usage charges
Add one-time or quantity-based charges directly to a customer's account for billing purposes.

### Check product and promotion status
Retrieve core details about products, including configuration metadata and currently running promotions.

## Use Cases

### Auditing a large cohort of clients
A financial analyst needs to confirm payment status across 50 accounts. Instead of running complex reports, they ask their agent to list recent transactions and retrieve the invoice details for specific groups of customers using `list_cheddar_transactions` and `list_cheddar_invoices`.

### Handling a usage overage complaint
A support rep learns a customer went over their monthly API limit. They ask the agent to pull the current billing details, check for active promotions (`list_cheddar_promotions`), and then use `add_cheddar_charge` to apply the necessary overage fee.

### Onboarding a new product line
A Product Manager needs to verify the technical parameters for a brand-new service. They ask their agent, which uses `get_cheddar_product_info` to pull core configuration metadata and confirm if there are existing billing plans (`list_cheddar_plans`) that conflict.

### Quickly checking a major client's status
A Sales Director is speaking with a prospect and needs to know the current billable details for an existing account. They ask their agent, which uses `get_cheddar_customer_details` to pull all necessary customer records instantly.

## Benefits

- Audit complex financial data instantly. Instead of opening the dashboard to check transaction volumes or payment statuses, your agent executes `list_cheddar_transactions` and presents the findings immediately.
- Handle customer inquiries without friction. If a support rep needs billing history for 'ACME-123', they simply ask their agent, which uses `get_cheddar_customer_details` to fetch everything needed in one step.
- Control revenue streams directly from chat. Need to add usage charges? You can trigger the `add_cheddar_charge` tool and update a client's bill instantly, logging the action for audit.
- Keep pricing current and accurate. Your agent can pull details on all available pricing plans using `list_cheddar_plans`, ensuring your team knows exactly what options are offered.
- Verify product status fast. Use `get_cheddar_product_info` to retrieve core product configuration, checking metadata or promotion rules without needing access to the admin console.

## How It Works

The bottom line is that you talk to your AI client like you’re talking to a dedicated billing specialist who lives inside your chat window.

1. Subscribe to the Cheddar MCP and enter your specific credentials (Cheddar Email, Product Secret, and Product Code).
2. Your AI client connects these secure details, granting it read/write access to your billing records.
3. You then tell your agent what you need—for example, 'List the last five invoices'—and the MCP executes the necessary commands.

## Frequently Asked Questions

**How can the Cheddar MCP help me audit my company's billing records?**
The Cheddar MCP lets you pull comprehensive lists of recent transactions and invoices directly into your chat. This means you don’t have to manually click through multiple pages in the dashboard, giving you a complete financial overview instantly.

**Do I need to know API keys or technical details to use Cheddar MCP?**
No. You connect your account credentials once, and then you only talk to your agent using plain English. The complexity of the billing system is handled entirely by the MCP in the background.

**Can I use Cheddar MCP to check if a customer went over their usage limit?**
Absolutely. You can ask your agent to retrieve detailed customer information, which includes checking current usage against available plans and flagging any potential overages for you.

**What is the best way to apply charges through Cheddar MCP?**
You simply tell your agent what charge code and quantity are needed. The tool executes an immediate update, ensuring that the usage fee or one-time charge is logged accurately against the correct customer account.

**Does this MCP help me manage different pricing plans?**
Yes. You can ask your agent to list all available pricing plans and check for active promotions, so you always know what options are on the table when talking to clients or designing new services.