# Edamam MCP for AI Agents MCP

> Edamam brings advanced nutritional intelligence to your AI agents. Use it to analyze the nutrient content of complex meals—like '2 eggs and avocado toast'—from natural language descriptions. It also lets you search vast recipe databases using precise filters for diet, cuisine, or specific health labels like keto-friendly or gluten-free.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Tags:** nutritional-analysis, recipe-search, dietary-filters, food-database, natural-language-processing

## Description

This MCP gives your AI agent deep nutritional knowledge. Forget guessing macros from ingredient lists; Edamam’s engine reads any food description and instantly returns a detailed breakdown of calories, protein, fat, carbs, and fiber. Need to plan a meal? You can analyze complex combinations like '1 cup brown rice and 200g chicken breast' in plain language. Beyond basic counting, you can search millions of recipes using advanced dietary filters for cuisine type, specific health labels (like peanut-free or low-sodium), or diet goals (keto, vegan). Connecting this through Vinkius gives your agent access to the entire catalog, making it a central source for any recipe or food data need. It’s the most detailed nutrition engine available.

## Tools

### analyze_nutrition
Processes a list of food items provided in natural language and returns the detailed nutritional content, including calories, protein, fat, carbs, and fiber.

### search_edamam_recipes
Searches a vast recipe database using complex filters for cuisine type, diet category (like keto or vegan), and specific health requirements.

## Prompt Examples

**Prompt:** 
```
What are the macros for a standard breakfast of oatmeal with berries?
```

**Response:** 
```
**Breakfast Analysis: Oatmeal & Berries**

*   **Total Calories:** ~380 kcal
*   **Protein:** 12g (From rolled oats)
*   **Carbs:** 65g (Mostly from the fruit and oat fiber)
*   **Fat:** 7g

*Note: Adding a handful of walnuts would boost healthy fats by about 4g.*
```

**Prompt:** 
```
Find me some dinner ideas that are low-carb and vegetarian.
```

**Response:** 
```
I found three great options for you:

1. **Spinach Stuffed Portobello Caps:** (Cuisine: Mediterranean) - *Checks out for vegan, keto.* 
2. **Tofu Scramble with Greens:** (Cuisine: Asian) - *Dairy-free and high-protein.* 
3. **Mushroom & Feta Bake:** (Cuisine: Italian) - *Great option if you're okay with dairy!*

Which one should I pull the full ingredient list for?
```

**Prompt:** 
```
Analyze the nutrition for a standard turkey sandwich on wheat bread.
```

**Response:** 
```
**Turkey Sandwich Breakdown**

*   **Serving Size:** 1 sandwich (2 slices bread, 4 oz turkey)
*   **Calories:** ~310 kcal
*   **Protein:** 38g 
*   **Carbohydrates:** 25g
*   **Fat:** 9g

The majority of the protein comes from the lean turkey breast. If you add a layer of avocado, you'll boost healthy monounsaturated fats.
```

## Capabilities

### Analyze nutrient content from text
You give your agent a list of ingredients in natural language, and it returns precise nutritional figures like calories, protein, fat, carbs, and fiber.

### Search for recipes with advanced filters
Your agent searches the recipe database by combining criteria such as cuisine type (e.g., Italian) with specific dietary needs (e.g., dairy-free or high-protein).

## Use Cases

### Checking client meal compliance
A dietitian asks their agent to analyze the nutrients for a patient's lunch: 'chicken breast and brown rice.' The agent uses analyze_nutrition, providing instant confirmation that the meal meets the required protein goals.

### Developing a specialized recipe guide
A developer needs recipes for users with severe allergies. They use search_edamam_recipes, filtering specifically for 'gluten-free' and 'dairy-free' to compile a safe, reliable content library.

### Quickly calculating event catering macros
A chef needs to know the total nutritional impact of a mixed spread. They input all components into analyze_nutrition, getting a single macro count for planning and cost management.

## Benefits

- Stop guessing macros. Use analyze_nutrition to instantly get precise calorie, protein, fat, carbs, and fiber counts from any natural language food description.
- Plan meals with confidence. search_edamam_recipes lets you filter results not just by cuisine, but by 40+ health labels like peanut-free or low-sodium.
- Save hours on research. Your agent handles the tedious task of cross-referencing ingredients against dozens of complex dietary guidelines automatically.
- Handle ambiguous inputs. You don't need structured data; simply listing '2 eggs and a slice of avocado toast' gives you immediate, actionable results.
- Build robust apps. Access a comprehensive food database that supports multiple filtering dimensions, making your application reliable for health tracking.

## How It Works

The bottom line is your AI client turns complex food data and recipe searches into actionable, formatted information.

1. Tell your AI client exactly what you need analyzed, like listing ingredients for a meal.
2. The MCP sends that natural language description to the Edamam engine for processing.
3. Your agent receives structured data containing the nutritional breakdown or a list of filtered recipes.

## Frequently Asked Questions

**How does Edamam help me analyze nutrition for complex meals?**
Edamam lets your agent process ingredients from plain text. Just list the foods and weights, and it returns a detailed breakdown of calories, protein, fat, carbs, and fiber instantly. This is much faster than manual calculations.

**Can I use Edamam to find recipes that meet multiple dietary rules?**
Yes. You can search for recipes using advanced filters simultaneously. For example, you can ask for something that must be both 'gluten-free' and 'keto-friendly,' narrowing the results instantly.

**Is Edamam only good for US cuisine?**
No, it supports multiple global cuisines. When searching recipes, you can filter by American, Asian, Indian, Mediterranean, and many others to find what you need.

**What if I change the ingredients in a recipe? Can Edamam tell me the new macros?**
You can use the analysis tool. If you substitute one ingredient for another, simply list the new combination of items, and it will calculate the updated nutritional profile for you.

**Does Edamam support allergen filtering?**
Yes, it supports specific health labels, including major allergens like peanut-free or dairy-free. This is critical when building content for users with severe dietary restrictions.