# ProfitWell MCP for AI Agents AI Agent Connect

> ProfitWell lets you connect your Paddle Metrics data to your AI client. You can pull real-time MRR, churn rates, and LTV without leaving your chat interface. It handles subscription updates, customer history lookups, and revenue tracking so you can manage your SaaS growth through conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_eZqYy1HcsnlNVH9ei10ZD2GPFpk7hV5YPoBBfWrm/ai-agent-connect
- **Tags:** subscription-metrics, churn-analysis, mrr-tracking, revenue-intelligence, ltv-calculation

## Description

Managing subscription revenue usually means jumping between spreadsheets and dashboard tabs to see if your growth is actually moving the needle. You often have to export CSVs just to figure out why a specific customer left or how much they spent over their lifetime. This Connector changes that by putting your ProfitWell data directly into your AI's workspace. Instead of hunting for numbers, you just ask your agent to summarize last month's churn or check the health of a specific account. It handles the heavy lifting of data retrieval and basic updates, like reversing a cancellation or adding a new subscriber, through plain language. By using this via the Vinkius catalog, you turn your AI into a revenue analyst that knows your numbers as well as you do. You stop copy-pasting and start making decisions based on real-time data. It makes the connection between your billing backend and your daily workflow much tighter. You can see exactly how your unit economics are performing and make adjustments on the fly without the usual overhead of manual data entry.

## Tools

### get_customer_history
Look up a customer's full billing history. Use this to see every past transaction and change.

### get_daily_metrics
Pull your daily growth stats. It helps you see small fluctuations in your revenue daily.

### exclude_customer
Remove specific accounts from your metrics. This is perfect for filtering out test accounts.

### get_account_status
Check your API connection status. Use this to ensure your data sync is still active.

### get_customer_ltv
Get the total lifetime value for a specific user. Use this to identify your highest-value customers.

### get_monthly_metrics
Retrieve your monthly financial stats. It gives you a high-level view of your monthly growth.

### get_retention_stats
Pull your churn and retention metrics. Use this to see how well you're keeping your customers.

### unchurn_subscription
Reverse a cancellation for a customer. This lets you quickly react to a customer who wants to stay.

### update_subscription
Modify an existing subscription's details. Use this to change plans or billing info on the fly.

### churn_subscription
Mark a customer as churned. This ensures your metrics stay accurate when a user leaves.

### create_subscription
Add a new subscriber to your account. This makes it easy to onboard users via chat.

### list_subscription_plans
View all your available product plans. This helps you see what's currently offered to customers.

## Prompt Examples

**Prompt:** 
```
What was our MRR last month?
```

**Response:** 
```
I've pulled your monthly metrics. Here is the breakdown for last month:

| Metric | Value |
| :--- | :--- |
| **Monthly Recurring Revenue** | $15,200 |
| **Gross Churn** | 2.5% |
| **Net New MRR** | $7,000 |

Your MRR grew by 12% compared to the previous month. Would you like to see the daily growth breakdown?
```

**Prompt:** 
```
Who are my top 5 customers by LTV?
```

**Response:** 
```
Based on your ProfitWell data, here are your highest-value customers by Lifetime Value:

1. **DataFlow Inc** - $24,000
2. **CloudBridge** - $18,500
3. **TechVentures** - $15,200
4. **ScaleUp** - $12,000
5. **Streamline Co** - $11,800

Would you like to see the billing history for any of these accounts?
```

**Prompt:** 
```
Can you reverse the cancellation for user_123?
```

**Response:** 
```
I've successfully reversed the cancellation for user_123. Their subscription is now active again. I've updated the records to reflect this change in your metrics.
```

## Capabilities

### Pull revenue stats
Get daily and monthly metrics like MRR and churn rates instantly.

### Check billing history
Look up every past transaction and plan change for a specific customer.

### Add new subscribers
Create new subscription records directly through your AI chat.

### Reverse cancellations
Undo a customer's churn event to keep them on your plan.

### Update subscription details
Modify existing plans and billing info using natural language.

### Track customer LTV
Retrieve the total lifetime value of your users to identify top spenders.

### Monitor account health
Check your API status and system health with simple commands.

## Use Cases

### Analyzing churn trends
A growth lead asks for a churn breakdown to see why users are leaving and identifies high-risk segments using get_retention_stats.

### Resolving billing issues
A customer success rep needs to see a user's history to fix a billing error and uses get_customer_history to find the source.

### Quick revenue summaries
A founder wants a quick summary of last month's MRR and LTV trends to prepare for a board meeting using get_monthly_metrics.

### Bulk plan updates
An ops manager needs to update subscription plans for a new launch and uses update_subscription to manage the changes.

## Benefits

- Stop manual CSV exports by pulling monthly and daily metrics directly into your chat.
- Identify at-risk customers faster by checking history with get_customer_history.
- Keep your revenue data accurate by using unchurn_subscription to reverse cancellations.
- Monitor your unit economics more closely with get_customer_ltv to track high-value users.
- Save time on admin tasks by using create_subscription and update_subscription to manage accounts.
- Filter out noise in your reports by using exclude_customer to hide test data.

## How It Works

The bottom line is you get a real-time revenue dashboard powered by natural conversation.

1. Get your Private API Token from your ProfitWell integration settings.
2. Add the Connector to your AI client and paste your token.
3. Ask questions about your MRR, churn, or customer history.

## Frequently Asked Questions

**How can ProfitWell help my SaaS business?**
It connects your Paddle Metrics to your AI agent so you can ask questions about revenue, churn, and customer history using plain language instead of manual dashboard digging.

**Can I use this to see my churn rates?**
Yes, you can pull real-time retention and churn stats instantly. This helps you see exactly how many customers are leaving and why.

**How do I manage customer subscriptions with ProfitWell?**
You can create new subscriptions, update existing plans, and even reverse cancellations directly through your AI chat interface.

**Can I see how much a customer has spent over time?**
Yes, you can pull the full billing history and lifetime value for any specific customer to see their total spend and plan changes.

**How does this work with my Paddle account?**
It uses your ProfitWell Private API Token to securely sync your Paddle Metrics data with your AI agent for real-time analysis.

**Can I use this to identify at-risk users?**
By analyzing customer history and churn metrics, your AI can help you identify which accounts are showing signs of leaving so you can take action.

**Can my AI automatically find the MRR and churn metrics for the current month?**
Yes! Use the `get_monthly_metrics` tool. Your agent will respond with complete metadata for all key metrics, including MRR, churned revenue, and active customers in seconds.

**How do I find my ProfitWell Private API Token?**
Log in to your ProfitWell/Paddle account, navigate to **Account Settings** > **Integrations**, and look for the **ProfitWell API** card to find your Private Token.