# Churnkey MCP for AI Agents AI Agent Connect

> Churnkey MCP lets you manage customer retention and cancellation flows directly through your AI agent. It handles session tracking, exit survey analysis, and billing recovery contacts so you don't have to jump between tabs. You can pull churn reasons, update contact info for failed payments, and manage GDPR requests in plain English.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_RHAtnyH6hGMQxMCmjGfZIC4tU2vYZJCaSKnCmZu6/ai-agent-connect
- **Tags:** churn-reduction, cancellation-flows, retention-management, failed-payment-recovery, customer-feedback, saas-metrics

## Description

Managing customer churn usually feels like a game of whack-a-mole. You're constantly switching between your billing platform, your CRM, and your support tickets just to figure out why a customer is leaving or to try and save a failed payment. This Connector changes that by bringing your Churnkey data directly into your AI chat interface. Instead of digging through dashboards to find out why users are hitting the cancel button, you can just ask your agent for the latest trends. It handles the heavy lifting of pulling session metadata, identifying the most common reasons for churn, and updating recovery contacts for your finance team. It's a practical way to keep your retention efforts organized without the constant context switching. Since Vinkius hosts this Connector, you can plug it into your existing setup and start getting answers in seconds. Whether you're trying to spot a pattern in why people are pausing their subscriptions or you need to quickly scrub a customer's data for a GDPR request, the agent does the clicking for you.

## Tools

### get_retention_session_details
Get details for a specific cancellation session to see why a user left. It provides a deep dive into a single interaction.

### update_billing_contacts
Update recovery contacts for a specific customer to ensure you get paid. This is the fastest way to fix a single billing issue.

### bulk_update_billing_contacts
Update recovery contacts for multiple customers at once to fix payment issues. This saves time when updating records for several failed payments.

### delete_customer_gdpr_data
Delete all data for a customer to stay compliant with GDPR privacy laws. Use this to quickly fulfill data removal requests.

### get_customer_gdpr_data
Access all data stored for a customer to fulfill a GDPR request. This is useful for privacy audits and data access requests.

### list_retention_sessions
List cancellation flow sessions to see current activity. Use this to see what's happening in your retention flows right now.

### get_session_aggregates
Retrieve grouped counts of cancellation sessions to see overall churn trends. It helps you see which reasons matter most.

### list_customer_retention_history
List all cancellation sessions for a specific customer to understand their history. This shows you if they've tried to leave before.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 cancellation sessions.
```

**Response:** 
```
I've pulled the last 5 sessions for you. Here is the summary:

*   **3 users** stayed because they accepted a **Pause** offer.
*   **1 user** accepted a **50% Discount**.
*   **1 user** proceeded with the cancellation.

Would you like me to show you the specific reasons they gave for leaving?
```

**Prompt:** 
```
What are the session aggregates for this month?
```

**Response:** 
```
Analyzing the session data for this month...

| Metric | Value |
| :--- | :--- |
| **Total Cancellation Attempts** | 150 |
| **Retention Rate** | 45% |
| **Top Reason** | Price (60% of sessions) |

It looks like price is the biggest hurdle for your customers right now.
```

**Prompt:** 
```
List all retention sessions for customer 'cust_123'.
```

**Response:** 
```
Checking the history for customer **cust_123**...

I found **2 sessions** for this user:
1.  **January**: Accepted a 3-month pause.
2.  **Yesterday**: Proceeded with cancellation due to **Product complexity**.

Would you like to see more details on either of these?
```

## Capabilities

### Pull cancellation session details
Get the specific reasons and metadata for why a user chose to leave.

### View grouped churn reasons
See high-level trends on why customers are canceling across your entire base.

### Update billing recovery contacts
Change contact information for failed payments to help your finance team collect revenue.

### Check specific customer history
See every time a specific customer has interacted with your retention flows.

### Handle GDPR data requests
Access or delete customer data to stay compliant with privacy regulations.

### Fetch session metadata
Retrieve details on offer types like discounts or pauses from previous sessions.

## Use Cases

### Identifying churn trends
A founder asks the agent to summarize why people canceled this week. The agent uses get_session_aggregates to find that 'Price' is the main reason.

### Handling GDPR requests
An ops lead needs to delete a user's data for a privacy request. They ask the agent to use delete_customer_gdpr_data for the specific user ID.

### Recovering failed payments
A finance person needs to update 50 contact emails for failed payments. They ask the agent to use bulk_update_billing_contacts to fix them all at once.

### Deep diving into a user's history
A CS manager wants to know if a specific user has tried to cancel before. They ask the agent to use list_customer_retention_history for that user.

## Benefits

- Stop manual dashboard hopping by using list_retention_sessions to see live churn activity as it happens.
- Spot churn trends faster using get_session_aggregates to see which reasons matter most to your users.
- Fix payment issues quickly with bulk_update_billing_contacts for your finance team to recover lost revenue.
- Stay compliant easily by using delete_customer_gdpr_data for privacy requests without manual database work.
- Understand user behavior by pulling specific history with list_customer_retention_history for every user.
- Get instant clarity on offers by using get_retention_session_details to see which discounts actually work.

## How It Works

The bottom line is you get a direct line to your churn data without leaving your chat window.

1. Subscribe to the Connector on Vinkius and get your Churnkey credentials.
2. Enter your Churnkey Data API Key and App ID into your AI client.
3. Ask your agent to pull churn reports or update billing info in plain English.

## Frequently Asked Questions

**How can Churnkey MCP help my SaaS retention?**
Churnkey MCP gives you a direct way to see why customers are leaving. You can ask your agent to summarize churn reasons or pull specific session details to help your team take action.

**Can Churnkey MCP handle GDPR requests?**
Yes, Churnkey MCP can help with privacy. It lets your agent access or delete customer data to fulfill GDPR requests without you having to manually find every record.

**Can I use Churnkey MCP to fix failed payments?**
It can. You can use it to update billing recovery contacts for single or multiple customers, making it easier to chase down failed payments and recover revenue.

**What kind of churn data does Churnkey MCP show?**
Churnkey MCP provides a look at cancellation sessions, including offer types like discounts or pauses, and the specific reasons users gave for leaving.

**How do I connect Churnkey MCP to my AI agent?**
You just need your Churnkey API keys. Once you add them to your client through the Vinkius catalog, your agent can start pulling and managing your churn data.

**Can Churnkey MCP see individual customer histories?**
Yes, Churnkey MCP lets you pull the entire history of cancellation sessions for a specific user, which helps you see if they've tried to leave multiple times.

**Can I see the most common reason users are trying to cancel?**
Yes! Use the `get_session_aggregates` tool. The agent will return grouped data showing which reasons are being selected most frequently in your cancellation flows.

**How do I update the billing contact for a customer whose payment failed?**
Use the `update_billing_contacts` tool. Provide the customer ID and the new contact details. This ensures Churnkey sends dunning and recovery emails to the right person.

**Where do I find my Churnkey Data API Key and App ID?**
Log in to your Churnkey dashboard and navigate to **Settings > Account**. You can find your App ID and generate a Data API Key in the API section.