# ROAS Calculator MCP MCP

> The ROAS Calculator determines your Return on Ad Spend across every channel, giving you a concrete profit number instead of just an ad metric. It helps you set safe spending limits by comparing current performance against industry standards and calculating your absolute financial break-even point.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** ROAS, Return on Ad Spend, Ad Campaign, Benchmark, Profitability, Media Spend

## Description

Figuring out if media spend actually makes money is tough. Most companies struggle to connect what they paid for ads directly to the long-term revenue it generates, leaving them guessing when scaling budgets. This MCP solves that by systematically linking three crucial calculations: current performance, external goals, and minimum costs. You first run `calculate_roas` with your media spend and attributed revenue; this gives you a detailed look at how each campaign is performing right now. Next, use `get_target_benchmark` to see what the market expects for your specific type of business—this sets an external goal. Finally, running `calculate_break_even_roas` tells you the absolute minimum ROAS required just to cover all costs. The result isn't a number; it's an actionable blueprint. Because this involves sensitive financial data, every single tool call is logged and cryptographically signed by Vinkius, giving your team a tamper-proof audit trail of exactly where every dollar came from and went. This full visibility means nothing happens in the dark.

## Tools

### calculate_break_even_roas
Calculates the minimum ROAS required to cover all costs based on your contribution margin percentage.

### calculate_roas
Provides a calculation of Return on Ad Spend (ROAS) given total media spend and source revenue, with optional campaign breakdowns.

### get_target_benchmark
Retrieves the target ROAS benchmark for your specific type of business.

## Prompt Examples

**Prompt:** 
```
We spent $15,000 last month and generated $60,000 in revenue. Can you calculate the total ROAS and break down the performance by 'Google Ads' vs 'Facebook/Instagram'?
```

**Response:** 
```
Calling `calculate_roas` with mediaSpend=15000, sourceRevenue=60000, and groupByField='Channel'. The total ROAS is 4.0x. Google Ads contributed a ROAS of X, while Facebook/Instagram contributed Y.
```

**Prompt:** 
```
We are an E-commerce company reporting in USD. What is the minimum target ROAS we should aim for?
```

**Response:** 
```
Calling `get_target_benchmark` with businessType='E-commerce' and targetCurrencyCode='USD'. The system returns a benchmark of 4x, which serves as your minimum performance goal.
```

**Prompt:** 
```
Our current contribution margin is 0.55 (55%). What ROAS do we need to break even in EUR?
```

**Response:** 
```
Calling `calculate_break_even_roas` with contributionMarginPercentage=0.55 and targetCurrencyCode='EUR'. The required break-even ROAS is 1.82x, meaning your ad spend must generate at least this much revenue to cover all marginal costs.
```

## Capabilities

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### Reviewing Quarterly Ad Performance
The Marketing Director needs to know if the last quarter’s $100k ad spend yielding $450k in revenue was enough. They run `calculate_roas` and find a 4.5x ROAS, which looks good but they need confirmation it meets market standards.

### Setting Up New Campaign Budgets
Before spending extra money on Instagram, the E-commerce Owner first checks `get_target_benchmark` for their region. This sets a realistic minimum goal (e.g., 3.5x), allowing them to budget upward only when justified.

### Adapting to Margin Changes
If the Cost of Goods Sold suddenly increases, the Finance Analyst immediately runs `calculate_break_even_roas` with the new margin. This instantly updates the spending floor, preventing overspending before it happens.

### Comparing Campaign Profitability
A user wants to see if Google Ads or Facebook delivered better value for a $20k spend. They use `calculate_roas` with grouping enabled to break down the revenue and ROAS side-by-side.

## Benefits

- Stop guessing with `calculate_roas` to get a true ROAS metric, giving you clear performance numbers by channel or campaign.
- Use `get_target_benchmark` to instantly compare your results against industry best practices for your business type.
- Establish financial safety nets. `calculate_break_even_roas` tells you the absolute minimum required revenue just to break even on costs.
- Systematically link spending, goals, and profit floors in one automated process instead of juggling spreadsheets.
- Get a complete audit trail for every calculation run through Vinkius's secure logging system.

## How It Works

The bottom line is that you get a full financial picture: what you are doing now, where you should be going, and the minimum line you can't cross without losing money.

1. Start by feeding the MCP your total media ad spend and the corresponding attributed revenue into `calculate_roas` to get a performance baseline.
2. Next, use `get_target_benchmark` with your business type (like SaaS or E-commerce) to pull the industry's minimum acceptable ROAS goal.
3. Finally, input your contribution margin percentage into `calculate_break_even_roas` to calculate the absolute floor—the required ROAS just to break even.

## Frequently Asked Questions

**How do I calculate total ROAS using the `calculate_roas` tool?**
You provide your overall media spend and the corresponding source revenue. The MCP calculates the return, and you can optionally ask it to break down that performance by specific ad channels.

**What does `get_target_benchmark` tell me about my spending?**
It tells you what a typical business of your type should be achieving. This gives you an external yardstick, letting you know if your performance is competitive in the market.

**If I change my product costs, do I need to update `calculate_break_even_roas`?**
Yes. You must always provide the updated contribution margin percentage. The required break-even ROAS changes immediately when your underlying cost structure shifts.

**`calculate_roas` can it compare my spend between two platforms?**
It can, provided you supply the necessary media spend and revenue for each platform or channel. You'll get a detailed ROAS breakdown by the field you specify.

**When running `calculate_roas`, how is my sensitive media spend data secured?**
The system handles your credentials via a zero-trust proxy, meaning your key never sits on disk. All financial inputs are used only in transit for the calculation and produce a cryptographically signed audit trail.

**If I run `calculate_break_even_roas`, can it handle different currencies?**
Yes, you specify the target currency code when calling this MCP. The tool ensures that all calculations are performed and returned using the specified foreign exchange rate.

**What happens if I input an invalid business type to `get_target_benchmark`?**
The MCP will return a specific error code, telling you exactly what format or value is needed. This prevents guesswork and ensures your agent only proceeds when the data structure is correct.

**Is there a way to run multiple calculations using `calculate_roas` without excessive token use?**
Vinkius includes native token optimization for this MCP. This built-in feature cuts down on your overall token consumption, allowing you to perform complex comparisons and multi-step analyses efficiently.