# Net Revenue Retention Calculator MCP

> Net Revenue Retention Calculator MCP. It computes NRR and GRR for customer cohorts so you can see if your SaaS revenue is actually growing or leaking. It pulls specific benchmarks for SMB and Enterprise segments and flags your cohort health status instantly. Stop guessing your growth and start using real data to see if your subscription model is actually healthy.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** nrr, grr, mrr, retention, saas-metrics

## Description

Most SaaS finance people spend way too much time in spreadsheets trying to figure out if their recurring revenue is actually healthy. It's easy to get lost in the noise of expansion, contraction, and churn. This MCP lets you stop doing the manual math. You can just tell your agent to run the numbers on a specific customer cohort and it'll spit out the Net Revenue Retention and Gross Revenue Retention immediately. It also knows what the "good" numbers look like for different sizes of customers, so you don't have to guess if your growth is actually impressive or just average. It's about getting a clear picture of your subscription stability without the headache of building custom formulas every time. You can see exactly how much revenue you're losing to churn versus how much you're gaining from expansion. It helps you see where the revenue is leaking and where it's actually growing. Since it's part of the Vinkius catalog, you can plug it into your existing AI workflow and get these answers in seconds. It's the truth layer for your finance stack. Instead of hunting through tabs to find the starting MRR for a specific group, you just feed the raw figures to your agent and get a health rating. It turns messy data into a clear "World Class" or "Healthy" status so you can make moves based on facts.

## Tools

### calculate_retention_metrics
Computes NRR and GRR for a specific cohort based on MRR changes.

### evaluate_cohort_health
Assigns a health status like World Class or Healthy based on your NRR.

### get_segment_benchmarks
Returns the target NRR and GRR for SMB or Enterprise segments.

## Prompt Examples

**Prompt:** 
```
Calculate retention for a cohort with 100k starting MRR, 10k expansion, 5k contraction, and 2k churn in the Enterprise segment.
```

**Response:** 
```
The calculated Net Revenue Retention (NRR) is 103.0% and the Gross Revenue Retention (GRR) is 93.0%.
```

**Prompt:** 
```
What are the performance targets for the SMB segment?
```

**Response:** 
```
For the SMB segment, the target NRR is 100.0% and the target GRR is 95.0%, categorized as a High-Growth tier.
```

**Prompt:** 
```
Is an NRR of 125% in the Enterprise segment considered good?
```

**Response:** 
```
Yes, an NRR of 125.0% for the Enterprise segment is classified as World Class status.
```

## Capabilities

### Calculate NRR and GRR
Get retention percentages for a specific customer cohort based on your revenue changes.

### Check cohort health
See if your current retention meets industry standards like World Class or Healthy.

### Pull segment benchmarks
Find out what Enterprise or SMB targets actually look like for your industry.

### Analyze revenue leaks
Identify how much revenue you're losing to churn versus what you're gaining from expansion.

### Compare growth tiers
Determine if your performance sits in a high-growth category or a standard tier.

## Use Cases

### Monthly reporting
A finance lead asks the agent to calculate retention for the Q3 Enterprise cohort using calculate_retention_metrics.

### Growth check
A manager wants to know if a 120% NRR is good for SMBs, so they use evaluate_cohort_health.

### Target setting
An analyst uses get_segment_benchmarks to set new KPIs for the sales team based on high-growth tiers.

### Churn analysis
A product manager wants to see how much contraction is hurting the Healthy status of their current users.

## Benefits

- Stop manual math: Use calculate_retention_metrics to get NRR and GRR instantly without opening a spreadsheet.
- Benchmark your growth: Use get_segment_benchmarks to see how your numbers stack up against high-growth targets.
- Identify health gaps: Use evaluate_cohort_health to see if your retention is actually World Class or just okay.
- Faster reporting: Get cohort analysis results in seconds so you can spend more time on strategy and less on data entry.
- Accurate segmentation: Get specific targets for SMB versus Enterprise segments to make better pricing decisions.

## How It Works

The bottom line is you get instant, accurate retention data instead of manual spreadsheet errors.

1. Provide your agent with your starting MRR, expansion, contraction, and churn figures for a cohort.
2. Tell the agent which customer segment you're looking at, like SMB or Enterprise.
3. Get a breakdown of your retention metrics and a health rating.

## Frequently Asked Questions

**How does the Net Revenue Retention Calculator handle churn?**
It takes your starting MRR and subtracts churn and contraction while adding expansion to give you an accurate NRR.

**Can the Net Revenue Retention Calculator check my cohort health?**
Yes, use evaluate_cohort_health to see if your NRR hits specific benchmarks like World Class or Healthy.

**What benchmarks does the Net Revenue Retention Calculator use?**
You can use get_segment_benchmarks to pull specific targets for Enterprise or SMB segments.

**Does the Net Revenue Retention Calculator work for any SaaS?**
It works for any subscription business that tracks MRR, expansion, and churn.

**How do I use the Net Revenue Retention Calculator with my agent?**
Just provide the raw revenue numbers and ask the agent to calculate the retention metrics for you.

**Does the Net Revenue Retention Calculator store my financial data?**
No, this MCP doesn't save your data. It processes the numbers you provide in real time and clears them once the calculation is finished.

**What clients are compatible with the Net Revenue Retention Calculator?**
You can use this MCP with Claude, Cursor, Windsurf, or any other MCP-compatible client. It works wherever you can connect the Vinkius catalog.

**How does the `calculate_retention_metrics` tool handle expansion and contraction?**
It treats expansion as a gain and contraction as a loss. The tool adds expansion to your starting MRR and subtracts contraction and churn to calculate your final NRR.