# Cheddar MCP for AI Agents AI Agent Connect

> Cheddar MCP lets you manage usage-based billing and subscriptions through your AI client. You can track usage, pull invoice history, and handle customer charges without leaving your chat interface. It connects your Cheddar account so you can manage the financial side of your SaaS using plain English. This is the fastest way to handle billing updates and customer account adjustments without manual dashboard navigation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CfhuOwWDvvEnQYVOyMtsygnLTVYUAdAin2hHmOfL/ai-agent-connect
- **Tags:** recurring-billing, usage-based-pricing, subscription-management, invoicing, revenue-operations

## Description

Managing a SaaS means constantly juggling different billing states. You're usually jumping between tabs to check if a customer was charged correctly, looking up their specific plan, or manually adding usage units for a custom deal. This Connector changes that by putting your Cheddar data directly into your AI client. Instead of hunting through a dashboard, you can just ask your agent to pull up a specific customer's history or see which promotions are currently active. It handles the heavy lifting of fetching transaction logs and pricing configurations so you can stay focused on your actual work. When you use this through the Vinkius catalog, you get a direct line to your billing data that feels like a natural extension of your workspace. You can audit transactions, verify plan details, and update charges on the fly, turning a multi-tab process into a single conversation.

## Tools

### get_cheddar_customer_details
Pulls complete profile information for a specific customer. It helps you see their current status and history in one view.

### add_cheddar_charge
Adds a one-time or quantity-based charge to a customer account. Use this to handle custom billing requests or manual adjustments.

### get_cheddar_product_info
Retrieves core product details and configuration metadata. It's the quickest way to see how your products are set up.

### list_cheddar_customers
Lists every customer associated with your product. This gives you a full bird's-eye view of your entire user base.

### list_cheddar_invoices
Pulls a list of recent customer invoices. You can use this to quickly check payment statuses or billing cycles.

### list_cheddar_plans
Lists all available pricing plans and their configurations. It helps you keep track of your different subscription tiers.

### list_cheddar_promotions
Lists active promotions and coupons. Use this to see which deals are currently live for your customers.

### list_cheddar_transactions
Lists recent billing transactions for your account. This is perfect for auditing payment flows and identifying issues.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 invoices in Cheddar.
```

**Response:** 
```
Retrieving your recent invoices... I found 5 items totaling $1,850.00. 3 are **Settled** and 2 are **Pending**. Would you like to see the customer associated with each?
```

**Prompt:** 
```
Add 10 units of usage for customer 'ACME-123' under charge code 'API_CALLS'.
```

**Response:** 
```
Adding usage... 10 units of **API_CALLS** have been successfully recorded for **ACME-123**. This will be reflected in their next billing cycle.
```

**Prompt:** 
```
List all my available pricing plans in Cheddar.
```

**Response:** 
```
Checking plans... You have 3 active plans:

* **Basic** ($29/mo)
* **Pro** ($99/mo)
* **Enterprise** (Usage-based)

I can show you the specific tracked items for each.
```

## Capabilities

### Fetch customer profiles
Retrieve full details for active and inactive users in a single request.

### Apply manual charges
Add one-time or quantity-based fees to any customer account.

### View pricing plans
List all available subscription tiers and their specific configurations.

### Audit billing history
Pull recent invoices and transaction logs to verify payment statuses.

### Check product metadata
Get core information on your products and active promotions.

## Use Cases

### Manual charge requests
A support agent gets a request for a one-time credit. They ask the agent to use add_cheddar_charge to apply the credit to the account immediately.

### Revenue auditing
A founder wants to see the latest billing activity. They ask the agent to list the last 20 transactions using list_cheddar_transactions.

### Subscription verification
A customer claims they aren't on the right plan. The admin uses list_cheddar_plans to check the tiers and get_cheddar_customer_details to verify the user's status.

### Promotion tracking
A marketing lead wants to see what deals are live. They ask the agent to pull all active coupons using list_cheddar_promotions.

## Benefits

- Stop tab-switching. You can check invoice statuses and customer details in your chat app using list_cheddar_invoices and get_cheddar_customer_details.
- Handle custom billing instantly. Use add_cheddar_charge to apply one-time fees or usage units without needing to access the full admin dashboard.
- Audit records faster. Pull complete transaction logs and promotion lists with list_cheddar_transactions and list_cheddar_promotions in seconds.
- Simplify plan oversight. Get a clear view of your pricing structure and product metadata using list_cheddar_plans and get_cheddar_product_info.
- Speed up support. Give your team the ability to look up customer history and apply charges directly from their existing chat tools.

## How It Works

The bottom line is you get a conversational interface for your entire Cheddar billing backend.

1. Subscribe to the Cheddar MCP on Vinkius
2. Provide your Cheddar Email, Product Secret, and Product Code
3. Ask your AI client to pull invoices, check plans, or add charges

## Frequently Asked Questions

**Can I use Cheddar MCP to manage my SaaS subscriptions?**
Yes. This Connector connects your Cheddar account to your AI client so you can manage plans, customers, and billing history through natural conversation.

**How do I add manual charges to a customer?**
You can just tell your agent to add a charge. The Connector will use the correct tools to apply one-time or quantity-based fees to a specific customer account.

**Can I see my recent invoices with Cheddar MCP?**
Yes. You can ask your agent to list recent invoices to check payment statuses or review billing history for any customer.

**Does Cheddar MCP support usage-based pricing?**
Yes. It's designed specifically for that. You can track usage, view product configurations, and manage the billing side of usage-based models easily.

**Can I use this to audit my billing transactions?**
Absolutely. You can pull transaction logs to verify payment statuses and audit your revenue operations without opening the dashboard.

**How does the Cheddar MCP handle promotions?**
It can list all your active promotions and coupons, making it easy to see which deals are currently live for your users.

**Can I record a new usage event for a customer?**
Yes! Use the `add_cheddar_charge` tool with the customer code, charge code (tracked item), and quantity. The agent will record the usage in Cheddar immediately.

**How do I see the billing history for a specific person?**
Use the `get_cheddar_customer_details` tool with the unique customer code. Your agent will fetch the full record, including active plans, status, and associated invoices.

**Where do I find my Product Secret and Product Code?**
Log in to your Cheddar dashboard and look for 'Product Settings'. You can view and copy your unique Product Code and generate a Secret Key from there.