# ARR Bridge Calculator MCP for AI Agents AI Agent Connect

> ARR Bridge Calculator helps you break down exactly why your subscription revenue is moving up or down. Instead of looking at a flat number, you get a detailed look at New ARR, Expansion, Reactivation, Contraction, and Churn. It turns vague growth into specific, actionable data points for your recurring revenue.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DtBonQp8QQmMClYBP3KhRl28TnrOw4q4h9umudQj/ai-agent-connect
- **Tags:** arr, revenue, subscription, financial-metrics, saas-analytics

## Description

When you're managing a subscription business, a single 'revenue grew by 10%' figure doesn't tell you much. You need to know if that growth came from new logos, existing customers spending more, or just a lucky month of reactivations. This Connector handles the heavy lifting of decomposing your Annual Recurring Revenue into the specific drivers that actually matter. You can ask your agent to pull a summary for a specific month to see the breakdown of every moving part, or have it map out a chronological waterfall to see how your revenue flowed over a quarter. If you're trying to spot a trend, like whether expansion is actually accelerating or just plateauing, the tool handles that analysis too. It's designed for people who need to move past the surface-level metrics and get into the 'why' behind the numbers. By connecting this to your workflow via the Vinkius catalog, you get a way to turn raw data into a clear narrative of your business health without having to manually rebuild bridge tables in a spreadsheet every single week. It takes the guesswork out of your reporting. Instead of spending hours on data reconciliation, you can spend that time figuring out how to improve your retention or find new ways to expand your current customer base. It's about having the right data at the right time to make better decisions.

## Tools

### analyze_component_trends
Analyzes how specific revenue drivers are growing or shrinking over a period. It helps you identify if your expansion or churn rates are improving or declining.

### get_bridge_waterfall_sequence
Generates a chronological sequence of monthly bridge summaries over a specified range. You can use this to visualize how your revenue flowed over several months.

### get_monthly_bridge_summary
Provides a detailed breakdown of all ARR movement components for a single, specific month. It helps you see exactly where revenue came from in a given period.

## Prompt Examples

**Prompt:** 
```
Show me the ARR breakdown for January 2024.
```

**Response:** 
```
In January 2024, your revenue moved as follows:

| Component | Amount |
| :--- | :--- |
| **New ARR** | $50,000 |
| **Expansion** | $10,000 |
| **Reactivation** | $5,000 |
| **Contraction** | ($2,000) |
| **Churn** | ($3,000) |
| **Net New ARR** | **$60,000**
```

**Prompt:** 
```
What is the revenue trend for expansion from 2024-01 to 2024-06?
```

**Response:** 
```
The expansion component shows an improving trend over the first half of the year. 

* **Current Value:** $15,000 (June 2024)
* **Trend:** 12% increase compared to the previous period.

This suggests your current upsell strategies are gaining momentum.
```

**Prompt:** 
```
Give me a waterfall sequence of my revenue from 2024-01 to 2024-03.
```

**Response:** 
```
Here is the chronological waterfall for your Net New ARR:

* **Jan 2024:** $60,000 Net New
* **Feb 2024:** $55,000 Net New
* **Mar 2024:** $62,000 Net New
```

## Capabilities

### Break down monthly revenue drivers
See exactly how much New ARR, Expansion, and Churn contributed to your total for any given month.

### Generate chronological revenue waterfalls
Map out the sequential flow of your revenue movements across a specific date range.

### Identify growth trends for specific components
See if your expansion or contraction rates are improving or declining over a period of time.

### Track Net New ARR movements
Get a clear picture of your actual growth by isolating new revenue from existing customer spend.

### Compare expansion vs. churn metrics
Analyze the balance between your upsells and your customer losses to gauge business health.

### Analyze reactivation patterns over time
Determine how much of your revenue comes from bringing back previous customers.

## Use Cases

### Explaining a sudden drop in Net New ARR
A manager asks why March numbers look off. The agent uses get_monthly_bridge_summary to show a spike in Churn and a drop in New ARR.

### Validating an expansion strategy
A director wants to know if upsells are working. The agent uses analyze_component_trends to show a 12% increase in expansion over six months.

### Preparing a quarterly waterfall report
A finance lead asks for a Q1 summary. The agent uses get_bridge_waterfall_sequence to list Net New ARR for every month in the quarter.

### Comparing reactivation vs. new logos
A product lead wants to see which is driving growth. The agent pulls both components to show which is the bigger driver of revenue.

## Benefits

- Stop guessing where revenue comes from by using get_monthly_bridge_summary to see exact drivers like Reactivation and Expansion.
- See the big picture of your quarterly growth with get_bridge_waterfall_sequence to map out chronological flows.
- Spot problems early by using analyze_component_trends to see if contraction is accelerating before it hits your bottom line.
- Save hours of manual spreadsheet work by letting your agent pull Net New ARR figures on demand.
- Get a clearer view of your subscription health by separating New ARR from Expansion in every report.

## How It Works

The bottom line is it turns complex revenue movements into a clear, driver-based narrative.

1. Connect your revenue data source to the Connector.
2. Ask your agent to pull a specific month or a date range.
3. Get a detailed breakdown of New ARR, Expansion, and Churn.

## Frequently Asked Questions

**What is an ARR Bridge?**
An ARR Bridge is a way to show how your Annual Recurring Revenue changed from one period to the next. It breaks down the total change into specific drivers like new customers, upsells, and churn.

**How does the ARR Bridge Calculator help my SaaS business?**
It helps you see the 'why' behind your growth. Instead of just seeing a total revenue number, you can see exactly how much came from new logos versus expansion or reactivations.

**Can I track churn and expansion separately?**
Yes, this Connector specifically decomposes those movements. You can pull summaries that isolate expansion and contraction so you can see how they balance each other out.

**How do I see revenue trends over several months?**
You can ask your agent to generate a waterfall sequence. This will show you a chronological flow of your revenue movements over any date range you specify.

**Does this work for any subscription model?**
Yes, as long as you have data on your recurring revenue components. It's designed to handle the standard drivers of any subscription-based business.

**What is Net New ARR?**
Net New ARR is the total revenue added to your business, accounting for new customers and expansions, while subtracting any contraction or churn from existing customers.

**How can I see my revenue flow over several months?**
You can use the `get_bridge_waterfall_sequence` tool by providing a start and end date in YYYY-MM format to generate a chronological sequence of monthly summaries.

**Can I analyze if my churn is increasing or decreasing?**
Yes, by using the `analyze_component_trends` tool with 'churned' as the component name, you can see the trend direction and percentage change over a specified period.