# Churnkey MCP MCP > Churnkey connects your customer retention and cancellation automation flows directly into your conversation. Use this MCP to track entire user sessions, analyze exit survey data, identify common reasons for churn, and manage failed payment recovery contacts without leaving your agent interface. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** churn-reduction, cancellation-flows, retention-management, failed-payment-recovery, customer-feedback, saas-metrics ## Description Dealing with lost customers is a pain point that requires deep visibility but usually means jumping between dashboards, spreadsheets, and support tickets. This connector lets you handle all of that right within your chat client. You can instantly pull details on specific cancellation sessions or get grouped counts to see where most users are dropping off—is it the price? The complexity? List all retention sessions for a customer or check their entire history with one prompt. Beyond just tracking, you manage the fallout: update billing recovery contacts when payments fail or use GDPR data access tools to handle compliance requests. Because this MCP is hosted on Vinkius, you get instant access to these complex flows from any compatible AI client, giving you full control over your customer lifecycles via natural talk. ## Tools ### bulk_update_billing_contacts Changes the billing recovery contact information for a group of customers at once. ### delete_customer_gdpr_data Permanently removes all customer data associated with GDPR compliance requests. ### get_session_aggregates Generates high-level counts and statistics across all retention sessions for defined periods. ### list_customer_retention_history Lists every single cancellation session a specific customer has gone through. ### get_customer_gdpr_data Retrieves a copy of all stored customer data for auditing purposes related to GDPR. ### get_retention_session_details Fetches the full record and details of a single cancellation session. ### list_retention_sessions Retrieves a list of recent or general cancellation flow sessions. ### update_billing_contacts Updates the billing recovery contact information for one specific customer. ## Prompt Examples **Prompt:** ``` Show me the last 5 cancellation sessions in Churnkey. ``` **Response:** ``` Retrieving recent sessions... I found 5 sessions. 3 users were retained with a 'Pause' offer, 1 accepted a '50% Discount', and 1 proceeded to cancel. Would you like to see the reasons they provided? ``` **Prompt:** ``` What are the session aggregates for this month? ``` **Response:** ``` Analyzing session data... This month you had 150 cancellation attempts. Your retention rate is 45%, with 'Price' being the top reason for leaving (60% of sessions). ``` **Prompt:** ``` List all retention sessions for customer 'cust_123'. ``` **Response:** ``` Checking history for cust_123... I found 2 sessions. In January they accepted a '3 month pause', and yesterday they proceeded with the cancellation due to 'Product complexity'. ``` ## Capabilities ### Review a customer’s full cancellation journey List every session and interaction record for one specific customer. ### Identify the biggest churn reasons Retrieve grouped counts of sessions to pinpoint trends across your entire user base. ### Update payment recovery details Change billing contacts for multiple users or update a single customer's recovery information. ### Access and delete compliance data Get or delete all stored customer data to meet GDPR requirements. ## Use Cases ### The finance team needs a payment status report. A director asks their agent, 'Which customers need their billing contacts updated?' The agent runs 'list_retention_sessions' to pull the list and then uses 'bulk_update_billing_contacts' to update them all with new bank details in one go. ### The founder needs to know if a pricing change helped. The founder asks, 'What were the session aggregates last quarter?' The agent runs 'get_session_aggregates', showing that 'Price' was still the top churn reason, confirming the need for product changes. ### CSM needs to understand a high-value customer's departure. The CSM asks about user 'cust_123'. The agent runs 'list_customer_retention_history', showing that the user had accepted three different retention offers before finally canceling due to complexity. ### Ops needs to prove GDPR deletion. An audit requires data removal. The ops manager asks, 'Delete all records for this customer.' The agent executes 'delete_customer_gdpr_data', providing an immediate confirmation log. ## Benefits - Stop manually checking dashboards. You can use 'list_retention_sessions' to pull recent session lists instantly from your agent. - Know why customers leave without guesswork. Run 'get_session_aggregates' to find patterns in churn reasons across your whole user base. - Handle compliance requests quickly. Use 'get_customer_gdpr_data' or 'delete_customer_gdpr_data' directly through chat, minimizing legal risk. - Fix payment issues fast. Update a customer’s details with 'update_billing_contacts' or use 'bulk_update_billing_contacts' for large lists. - Track individual accounts deeply. Run 'list_customer_retention_history' to see every interaction and offer acceptance for one user. ## How It Works The bottom line is: your AI client uses this MCP to run complex retention reports and actions based purely on conversation. 1. Subscribe to this MCP and enter your Churnkey Data API Key and App ID into Vinkius. 2. Direct your AI client to the retention flow. You ask a question—like, 'Show me all sessions for user X.' 3. The agent executes the necessary tool calls, fetches the data (session history, aggregates, or compliance records), and answers you in plain English. ## Frequently Asked Questions **How do I check a single customer's full history using list_customer_retention_history?** You provide the unique customer ID to your agent. It then executes 'list_customer_retention_history', showing you every session they ever had, which is crucial for understanding their long-term behavior. **What are the limitations of get_session_aggregates?** This tool provides high-level counts and overall trends. It won't give you individual user details; it only shows generalized data like the top reasons for leaving across your entire base. **Can I use bulk_update_billing_contacts to change contacts?** Yes, 'bulk_update_billing_contacts' lets you feed the system a list of multiple customers and update their billing recovery details all at once. This saves massive time compared to doing it manually. **Is get_customer_gdpr_data safe for compliance?** Yes, this tool is designed specifically for GDPR compliance. It allows you to retrieve a verifiable copy of all data associated with a customer record when needed. **What credentials do I need to use the `list_retention_sessions` tool?** You must provide your Churnkey Data API Key and App ID. Vinkius manages the connection once you enter these specific keys during the initial setup. **When I call `get_retention_session_details`, what specific metadata does the tool provide about a cancellation session?** It returns comprehensive data, including offer types (like discounts or pauses) and billing intervals. This lets your AI client understand exactly why a user left or how they were saved. **If I run multiple updates, what are the performance or rate-limit considerations for `update_billing_contacts`?** The API uses standard usage quotas. For large batches of changes, you should chunk your requests to avoid temporary rate limits and ensure smooth execution. **What level of access is required when using the `list_retention_sessions` tool?** You need API keys connected to an account that has at least read-only permissions for session data. Your AI client only runs actions permitted by the credentials you provide. **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.