# Meal Cost Calculator MCP

> Meal Cost Calculator figures out exactly what a recipe costs in total and per serving. It takes ingredient names, unit prices, and amounts to give you precise budget data for food service or home cooking.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** cooking, recipe, costing, food, budgeting

## Description

Need to know if your signature dish is actually profitable? This MCP connects your AI agent directly to culinary costing logic. You can input any ingredients list and get accurate financial breakdowns instantly. It calculates the total expense of a recipe, determines the cost per person, and pinpoints which specific items are driving up your costs. Plus, it checks all your units—whether you're mixing grams with fluid ounces—to make sure your numbers are solid.

When you connect this to Vinkius, you get access to industry-leading financial tools alongside recipe costing. It eliminates the guesswork from kitchen budgeting, giving you actionable data so you stop guessing and start tracking profit margins.

## Tools

### get_cost_contribution_breakdown
Shows exactly which ingredients are responsible for the largest percentage of your recipe's cost.

### calculate_recipe_total
Calculates a single, accurate dollar amount representing the complete expense of an entire recipe.

### calculate_serving_split
Takes the total cost and divides it to give you the precise price for one individual serving or portion.

### validate_measurement_units
Checks your ingredient list and tells you if all units (like mass, volume, or count) are consistent together.

## Prompt Examples

**Prompt:** 
```
What is the total cost for a recipe using 2kg of flour at $1.50/kg and 500g of sugar at $2.00/kg?
```

**Response:** 
```
$6.00
```

**Prompt:** 
```
If my total recipe cost is $20 and it serves 5 people, how much does each serving cost?
```

**Response:** 
```
$4.00
```

**Prompt:** 
```
Which ingredients are driving the cost in a recipe with 1kg of beef at $15/kg and 0.2kg of salt at $0.50/kg?
```

**Response:** 
```
Beef: 96.77%, Salt: 3.23%
```

## Capabilities

### Determine Total Recipe Expenses
Calculates the combined cost of all ingredients listed in a complete recipe.

### Calculate Cost Per Serving
Divides the total recipe cost by the number of servings to find the precise price for one plate or portion.

### Identify Expense Drivers
Breaks down the total cost, showing exactly which ingredients contribute the most expense percentage-wise.

### Validate Measurement Consistency
Checks your ingredient list to ensure all units (like mass or volume) are compatible with each other.

## Use Cases

### Setting Menu Prices
A new restaurant owner needs to price a complex stir-fry dish. They ask their agent for the total cost and the cost per serving. The system runs `calculate_recipe_total` and then `calculate_serving_split`, giving them $12.50 total, which translates to an optimal $4.17 per plate.

### Adjusting Waste Costs
A catering manager needs to know which ingredients are dragging down the profit on a large pot roast recipe. They ask for a breakdown, and `get_cost_contribution_breakdown` immediately shows that beef is 78% of the cost, prompting them to source cheaper cuts.

### Cross-Checking Units
A home baker lists flour in kilograms but sugar in cups. Instead of getting a garbage total, they run `validate_measurement_units`, which flags the inconsistency and tells them how to standardize their measurements before proceeding.

### Scaling Recipes for Events
A catering company needs to scale a recipe from 10 servings up to 200. They calculate the initial total cost, use `calculate_serving_split` to verify the per-person rate, and can confidently quote their clients.

## Benefits

- Stop wasting time manually calculating costs. Use `calculate_recipe_total` to get the full budget figure instantly, regardless of how many ingredients you add.
- Never lose money on a menu item again. By running `calculate_serving_split`, you know exactly what to charge per plate, guaranteeing profitability.
- Pinpoint your expensive items with `get_cost_contribution_breakdown`. You'll immediately see if that one premium ingredient is tanking your margin.
- Avoid calculation errors before they happen. Use `validate_measurement_units` to ensure every gram and cup listed makes sense together, keeping your data clean.
- It’s all about accuracy. This MCP lets you treat cost analysis like a simple conversation with your agent, not a spreadsheet nightmare.

## How It Works

The bottom line is that you input a messy recipe list and walk away with clean, actionable financial data.

1. You provide the MCP with a recipe's ingredients, their specific quantities, and current unit prices.
2. The system first uses `validate_measurement_units` to ensure all listed units are consistent (e.g., you aren't mixing cups and kilograms).
3. It then calculates the costs using tools like `calculate_recipe_total`, giving you the final budget number, which can then be split per plate using `calculate_serving_split`.

## Frequently Asked Questions

**How do I use Meal Cost Calculator with different units?**
You must run `validate_measurement_units` first. It checks your ingredients list and tells you which measurements are mixed up, so the subsequent cost calculations will be accurate.

**Does Meal Cost Calculator handle scaling recipes?**
Yes. You find the initial total using `calculate_recipe_total`, then use `calculate_serving_split` to determine the per-person rate, which you can scale up or down.

**Which tool should I use to know my most expensive ingredient?**
Use `get_cost_contribution_breakdown`. This tool gives you a percentage breakdown of your costs so you know exactly where the bulk of the money goes in that dish.

**Is Meal Cost Calculator useful for budgeting groceries at home?**
It's great for budget analysis. You can treat a week's worth of planned meals as a 'recipe,' get a total cost, and see how much you're spending before you even shop.

**What if my recipe uses multiple types of measurements?**
The `validate_measurement_units` tool handles this. It ensures that every unit type—be it mass, volume, or count—is consistent across the whole list you provide.

**How do I calculate the total cost of my recipe?**
Use the `calculate_recipe_total` tool. Provide a JSON array of ingredients, each containing its name, unit price, and the quantity used.

**Can I see which ingredient is most expensive?**
Yes, use the `get_cost_contribution_breakdown` tool. It will return a list showing the percentage of the total cost contributed by each ingredient.

**How do I find out the cost per serving?**
First, calculate the total recipe cost using `calculate_recipe_total`, then pass that result into the `calculate_serving_split` tool along with the number of portions.