# Nutritionix MCP

> Nutritionix MCP lets your agent analyze complex meals described in natural language. Just type out everything you ate—like 'three slices of pizza and a Coke'—and get an immediate, precise breakdown of calories, protein, fat, carbs, fiber, sugar, sodium, and cholesterol for every single item. It handles branded foods and restaurant menus.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** nutritional-analysis, natural-language-processing, calorie-tracking, macro-nutrients, health-data

## Description

This MCP gives your AI client access to one of the industry's best food analysis engines. You don't have to manually enter ingredients or search databases; you just describe what you ate in plain English. For example, if you type out a complex meal—say, 'a cup of oatmeal with peanut butter and a banana'—the MCP instantly calculates the total nutritional facts, item by item.

It provides metrics like calories, protein, fat, carbs, fiber, sugar, sodium, and cholesterol for every part of that meal. Need to check out a specific brand or common food? You can search its vast database of both generic and branded items, including extensive menu data from major restaurant chains. It's the kind of deep-dive health analysis tool that serious fitness apps rely on.

Connecting this MCP via Vinkius means your agent can take unstructured text—like a photo caption or a diary entry—and convert it into structured, actionable nutritional data right where you need it.

## Tools

### search_nutritionix_foods
Searches the database for either common or brand-specific food items to retrieve their individual nutritional facts.

### analyze_food_nutrition
Provides a precise breakdown of calories and macro-nutrients from any natural language meal description, handling specific quantities and multiple foods at once.

## Prompt Examples

**Prompt:** 
```
Analyze the nutrition of 2 eggs, 1 toast with butter, and a glass of orange juice.
```

**Response:** 
```
Here's your breakfast breakdown:
- 2 large eggs: 144 kcal, 12g protein, 10g fat
- 1 piece of toast with butter: 166 kcal, 3g protein, 6g fat, 24g carbs
- 1 glass OJ (240ml): 112 kcal, 2g protein, 26g carbs

Total: 422 kcal, 17g protein, 16g fat, 50g carbs.
```

**Prompt:** 
```
Calculate the macros for 1 cup of oatmeal with a sliced banana and a tablespoon of peanut butter.
```

**Response:** 
```
Breakdown:
- 1 cup cooked oatmeal: 166 kcal, 6g protein, 28g carbs, 4g fiber
- 1 medium banana: 105 kcal, 1.3g protein, 27g carbs
- 1 tbsp peanut butter: 94 kcal, 4g protein, 8g fat
Total: 365 kcal, 11g protein, 63g carbs, 10g fat.
```

**Prompt:** 
```
How many calories in a Starbucks Grande Caramel Macchiato with almond milk?
```

**Response:** 
```
A Starbucks Grande (16 oz) Caramel Macchiato made with almond milk contains approximately 190 calories, 4g of protein, 5g of fat, and 27g of carbohydrates (including 25g of sugar).
```

## Capabilities

### Analyze Meals by Description
Input a meal description in natural language and receive a precise breakdown of all macro-nutrients and calories for every component listed.

### Search Food Database
Look up common or branded food items within the database to retrieve specific nutritional facts and calorie counts.

## Use Cases

### Evaluating client dietary compliance
A dietitian receives a text message from a client listing their lunch: '3 slices of pizza with extra cheese and an iced tea.' Instead of having to guess, the agent uses `analyze_food_nutrition` to instantly generate the full macro breakdown, allowing the dietitian to provide immediate, informed feedback.

### Building a personalized meal plan
A fitness coach wants to create a high-protein menu. The agent first uses `search_nutritionix_foods` to find optimal protein sources (like salmon or lentils) and then uses `analyze_food_nutrition` to test how those items combine into balanced, macro-compliant meals.

### Cross-referencing restaurant menus
A health researcher is studying local eating habits. They feed the agent a photo caption listing several menu items from a chain. The MCP uses its extensive coverage to analyze all components, providing data on sodium and sugar that manual searching would miss.

### Calculating athletic meal totals
An athlete needs to calculate macros for pre-workout fuel. They type '1 cup of oatmeal with a banana and two tbsp peanut butter.' The agent runs `analyze_food_nutrition` and returns the precise total calories, carbs, and fats needed for optimal performance.

## Benefits

- Accurate tracking for complex meals. Instead of just getting a total number, the `analyze_food_nutrition` tool breaks down calories, protein, fat, carbs, fiber, sugar, sodium, and cholesterol per item.
- Handles real-world food descriptions. You don't need to write '2 large eggs'; you can describe them naturally, and the MCP figures out the precise nutritional content for everything listed.
- Checks branded foods instantly. The `search_nutritionix_foods` tool lets your agent look up specific items from national restaurant chains or brand-name goods, ensuring data accuracy.
- Saves research time. You eliminate the need to copy text snippets into multiple databases or use separate tracking apps; everything is parsed and quantified in one go.
- Supports diverse cuisine types. Whether it's pizza slices, oatmeal, or a Starbucks drink, the engine has coverage for common and regional menus, giving you comprehensive data.

## How It Works

The bottom line is that you transform messy text descriptions of food into clean, quantifiable nutritional reports.

1. Type a meal description into your agent, listing all the foods and quantities (e.g., 'two eggs, one slice of toast').
2. The MCP processes this natural language input using its advanced NLP engine to identify every ingredient.
3. You get back structured data showing total calories, protein, fat, carbs, fiber, sugar, sodium, and cholesterol for the entire meal.

## Frequently Asked Questions

**What types of foods can analyze_food_nutrition handle?**
It handles complex meals composed of multiple ingredients. You can list anything from common pantry items like rice or eggs to specific branded restaurant menu components.

**Does Nutritionix MCP cover international food brands?**
Yes, the tool has extensive coverage data for national and regional chains. This makes it useful for analyzing meals eaten in diverse settings.

**Is analyze_food_nutrition better than just using a standard Google search?**
Absolutely. A general search gives you links, but the MCP performs the calculation itself, giving you instant, structured data points like total sodium and cholesterol per meal.

**How does search_nutritionix_foods work?**
This tool lets your agent look up a specific food item. You provide the name of a common or branded food, and it returns the precise nutritional facts for that one item.

**Can I use this MCP to track my daily intake? **
Yes, you can feed your agent multiple meal descriptions throughout the day. The combination of `analyze_food_nutrition` and simple text aggregation allows you to build a full daily macro report.

**How accurate is the NLP food analysis?**
Nutritionix's NLP engine is used by major fitness and health apps globally. It can parse complex meal descriptions including quantities, cooking methods, and brand names with high accuracy, backed by a verified database of 1M+ food items.

**Can it recognize branded foods or restaurant items?**
Yes, Nutritionix excels at this. If you type '1 Big Mac and a medium fries from McDonald's', it will correctly map these to specific branded items in its database.

**Does it track micronutrients?**
Yes, in addition to macros (proteins, fats, carbs), it returns data on dietary fiber, sugars, sodium, cholesterol, and potassium for an incredibly comprehensive nutritional profile.