# Recipe Calorie Calculator MCP. AI Agent Connect

> Recipe Calorie Calculator is a specialized MCP that handles the math for recipe energy content. Your AI client uses it to sum up ingredient calories, calculate specific portion sizes, and verify that serving counts make sense. It turns your agent into a nutrition-aware assistant that can handle dietary calculations without manual math errors.

## Overview
- **Category:** health
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_IH0u5Fqbcgq7gBoNty8zt9wPDxqtRC2VcIaqBvA8/ai-agent-connect
- **Tags:** calories, nutrition, recipe, diet, cooking

## Description

You can stop manually adding up ingredient calories every time you plan a meal. This MCP gives your AI client the specific tools it needs to handle nutritional math accurately. Instead of guessing, your agent can pull a full nutrition summary or just look at the total energy of a list of ingredients. 

It handles the logic of portioning, too. If you need to know what a single serving looks like, the MCP calculates that for you. It even includes a check to make sure your serving sizes are actually logical, preventing errors where a recipe might accidentally be assigned zero or negative portions. Whether you are building a meal planner or just checking the math on a new dinner idea, this MCP provides the raw numbers your agent needs to give you reliable answers.

## Tools

### calculate_per_serving_calories
This tool finds the calorie count for a single portion of your recipe. It divides the total energy by the number of servings provided.

### calculate_total_calories
This tool sums the energy content of all ingredients you provide. It gives you the cumulative calorie count for the entire recipe.

### get_recipe_nutrition_summary
This tool provides a full nutritional overview in one go. It returns both the total recipe energy and the calories per serving.

### validate_serving_size
This tool checks if your serving count is a valid number. It prevents your agent from using impossible values like zero servings.

## Prompt Examples

**Prompt:** 
```
What is the nutritional summary for a recipe with 500 calories in ingredients and 4 servings?
```

**Response:** 
```
The total calories are 500 and there are 125 calories per serving.
```

**Prompt:** 
```
Calculate the total calories for ingredients with 100, 250, and 50 calories.
```

**Response:** 
```
The total calories are 400.
```

**Prompt:** 
```
Is a serving size of 0 valid?
```

**Response:** 
```
No, a serving size of 0 is not a valid serving count.
```

## Capabilities

### Total Energy Summation
Your agent uses this to add up every ingredient's calorie count.

### Portion Math
The MCP calculates exactly how many calories are in one serving.

### Data Validation
It checks serving counts to ensure the math stays logical.

### Nutrition Summaries
Your agent gets both total and per-serving data in a single request.

## Use Cases

### Meal Planning
Your agent calculates the caloric load of a weekly meal plan based on ingredient lists.

### Dietary Tracking
You ask your agent to find the calories in a specific portion of a meal you just ate.

### Recipe Development
A chef uses the agent to check how changing ingredient amounts affects the total energy.

### Error Checking
The agent validates that serving sizes entered into a system are mathematically sound.

## Benefits

- Eliminates manual calorie addition errors.
- Provides instant per-serving breakdowns.
- Prevents logical errors in serving size calculations.
- Delivers complete nutritional summaries in one step.

## How It Works

Connecting this MCP to your AI client is a one-time setup that enables immediate nutritional calculations.

1. Connect your AI client to the Vinkius hosted MCP.
2. Provide your agent with a list of ingredients and their calories.
3. The agent calls the necessary tool to sum or divide the energy.
4. Your agent delivers the final calorie count or summary to you.

## Frequently Asked Questions

**How does this MCP calculate calories?**
It uses specific tools to sum the energy of provided ingredients or divide that total by the number of servings.

**Can I get both total and per-serving calories at once?**
Yes, the get_recipe_nutrition_summary tool provides both values in a single response.

**Does it check if my serving size is valid?**
Yes, the validate_serving_size tool checks that the serving count is a logically sound number.

**Which AI clients can use this?**
Any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code can use this MCP.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How do I calculate the total calories for my recipe?**
You can use the `calculate_total_calories` tool by providing a list of ingredients with their respective calorie counts.

**Can I get a full summary of the recipe nutrition?**
Yes, the `get_recipe_nutrition_summary` tool provides both the total calories and the calories per serving in a single call.

**What happens if I provide an invalid serving size?**
The `validate_serving_size` tool will check if the number is a positive integer. If it is zero or negative, it will return an invalid status.