# Churn Rate Calculator MCP > The Churn Rate Calculator determines if losing users is actually hurting your business. It calculates Customer Churn Rate, Revenue Churn Rate, and Net Revenue Retention (NRR) to give you an immediate health score against industry benchmarks. ## Overview - **Category:** finance - **Price:** Free - **Tags:** churn-rate, nrr, revenue-retention, customer-churn, metrics ## Description You need to know if user loss or revenue contraction is a minor blip or a major problem for the company. Many businesses track raw numbers—how many customers left last month—but they miss the financial impact and whether expansion efforts are even enough to offset that decline. This MCP solves that gap by connecting three critical calculations into one place. It assesses volume loss using customer metrics, measures monetary value loss with revenue tracking, and determines if your growth is enough to keep you afloat via Net Revenue Retention (NRR). All this data feeds into a single analysis that gives you an actionable health score: World-Class, Healthy, or Needs Improvement. You can connect the entire process through Vinkius’s catalog, giving your agent access to continuous financial monitoring. ## Tools ### analyze_churn_health Takes calculated metrics and compares your retention status against standard industry benchmarks. ### customer_churn_rate_calculator Calculates the rate of customer volume loss given a starting count and an ending count for a period. ### net_revenue_retention_calculator Determines Net Revenue Retention (NRR) by incorporating starting ARR, revenue lost, and expansion revenue amounts. ### revenue_churn_rate_calculator Calculates the financial rate of revenue loss based on a given starting Annual Recurring Revenue and total amount lost. ## Prompt Examples **Prompt:** ``` I started the year with 1000 customers and ended with 920. My NRR was 1.15, and I operate in the SaaS segment. Analyze our current health. ``` **Response:** ``` First, let's check the customer volume loss using `customer_churn_rate_calculator` (start: 1000, end: 920). Next, I will use `analyze_churn_health` with the segment 'SaaS', the calculated CCR, and NRR 1.15. ``` **Prompt:** ``` We lost $200k in revenue this quarter, starting from $5M ARR. We gained $350k in upsells. Calculate the NRR and RCR for us. ``` **Response:** ``` I will calculate the Net Revenue Retention Rate using `net_revenue_retention_calculator` (start: 5000000, lost: 200000, expansion: 350000). I will also run `revenue_churn_rate_calculator` to see the pure financial loss. ``` **Prompt:** ``` What is our current retention status? We have a CCR of 0.12 and an NRR of 0.98, and we are in the ECommerce sector. ``` **Response:** ``` I will run `analyze_churn_health` for the 'ECommerce' segment using your provided CCR (0.12) and NRR (0.98). Please provide the starting customer count so I can calculate any missing baseline metrics. ``` ## Capabilities ### Calculate Customer Volume Loss Determine how many users left during a specific time period given starting and ending customer counts. ### Assess Monetary Revenue Decline Figure out the financial cost of lost revenue using initial Annual Recurring Revenue (ARR) and total losses. ### Measure Net Retention Strength Calculate your Net Revenue Retention (NRR), factoring in both contract expansion and actual contraction amounts. ### Determine Business Health Score Analyze the combined rate metrics against industry averages to assign a clear health classification. ## Use Cases ### The quarterly board review A VP needs to present retention status. They run the `customer_churn_rate_calculator` for volume loss, calculate NRR using the `net_revenue_retention_calculator`, and then feed both results into `analyze_churn_health`. The agent returns a single health score they can use in their presentation. ### Investigating sudden revenue drops A finance analyst notices ARR fell last month. They run the `revenue_churn_rate_calculator` to isolate the pure financial loss, then compare that rate against what was calculated by `customer_churn_rate_calculator` for user count. ### Testing upsell effectiveness A Product Manager wants to know if new feature adoption is enough. They run the `net_revenue_retention_calculator`, inputting current expansion revenue, and compare the resulting NRR against the industry benchmark using `analyze_churn_health`. ## Benefits - Instead of just counting departing users, you know the dollar cost of that loss using the `revenue_churn_rate_calculator`. This gives finance teams immediate financial context. - The system tracks both volume and money simultaneously. You can use `customer_churn_rate_calculator` to see if user count is dropping while NRR remains high because of upsells. - You get an actionable, simple health score (World-Class, Healthy, Needs Improvement) by running the final analysis with `analyze_churn_health`. This cuts through the complexity. - It factors in expansion revenue. Using the `net_revenue_retention_calculator` shows if your upselling efforts are enough to offset any customer losses you experienced. - This MCP allows you to combine multiple metrics—from simple counts to complex ARR tracking—in one single workflow. ## How It Works The bottom line is: you get a clear, actionable assessment of your company's retention health without running multiple reports. 1. You feed the agent the necessary data points, like starting customer counts and ending ARR figures. 2. The MCP runs specialized calculations—for example, running `customer_churn_rate_calculator` to find volume loss, then `net_revenue_retention_calculator` for financial depth. 3. Finally, it feeds all these distinct metrics into the `analyze_churn_health` tool, giving you a single classification score. ## Frequently Asked Questions **How do I calculate the proportion of customers lost in a period?** You should use the `customer_churn_rate_calculator` tool. This function requires two inputs: the starting customer count and the ending customer count to determine the volume loss percentage. **What is NRR, and how does it account for growth?** NRR accounts for both losses and gains. You calculate this using the `net_revenue_retention_calculator` tool, providing the starting ARR, lost revenue value, and crucially, the expansion revenue from existing clients. **Does this system provide a general health score?** Yes. After running the core metrics, you must use the `analyze_churn_health` tool. This function compares your calculated rates against industry benchmarks (SaaS/ECommerce) to classify your company's overall retention health. **If I use the `revenue_churn_rate_calculator` and my starting ARR is lower than my lost revenue amount, what does that mean?** The tool will return an immediate error because you cannot lose more money than your total starting annual recurring revenue. You must ensure that your input values are financially logical before running the calculation. **When using the `customer_churn_rate_calculator`, what format do the start and end customer counts need to be in?** You need whole integers for both the starting and ending customer numbers. The tool accepts standard numeric inputs, so just provide the raw count without any text qualifiers or currency symbols. **How does the `analyze_churn_health` function account for different market segments?** You must explicitly specify the segment when running this analysis. The health score it provides is not universal; it's benchmarked against the specific industry you define (e.g., SaaS, ECommerce). **Are there any rate limits I should know about when frequently using the `net_revenue_retention_calculator`?** The service provides generous usage quotas designed for continuous operation. If you exceed a limit, your agent will return an explicit error code detailing exactly how long to wait before retrying. **What security protocols protect the data used by the `customer_churn_rate_calculator`?** All calculations are processed securely within your AI client's environment and Vinkius infrastructure. The platform does not store the underlying sensitive raw customer numbers after the calculation is complete.