# FatSecret MCP

> FatSecret MCP connects your agent directly to a massive food database, giving you immediate access to nutritional data for millions of items. Need to know the exact macro count or calorie intake for something? This tool finds it, providing full breakdowns—from protein and fat percentages to various serving sizes—so you can track meals accurately without leaving your workflow.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** calorie-counting, nutrition-tracking, diet-management, macro-data, food-database, health-monitoring

## Description

This connection lets you ask questions about food composition and get reliable numbers back. Instead of juggling different recipe sites or guessing ingredient amounts, your agent accesses a database trusted by millions for diet management. You simply name an item, and the MCP handles the complex lookup process. The result is clean, structured data: calories, protein grams, fat content, and carbs. When you connect this through Vinkius, all that nutritional intelligence flows directly into your conversation or script, making meal planning straightforward. It's like having a dedicated nutritionist in your agent.

## Tools

### get_fatsecret_food_details
Retrieve complete nutritional breakdowns for a specific item, including multiple serving sizes (e.g., per cup or 100g).

### search_fatsecret_foods
Search the food database for general calorie, protein, fat, and carb data using a food name.

## Prompt Examples

**Prompt:** 
```
How many calories in a Big Mac?
```

**Response:** 
```
According to FatSecret data, a McDonald's Big Mac contains 563 calories per serving (215g). Breakdown: 33g fat, 44g carbs, and 26g protein.
```

**Prompt:** 
```
Search for the nutrition data of a medium apple.
```

**Response:** 
```
A medium apple (182g) has approximately 95 calories, 0.3g of fat, 25g of carbohydrates (including 4.4g of fiber), and 0.5g of protein.
```

**Prompt:** 
```
What are the macros for a serving of whey protein powder?
```

**Response:** 
```
A typical 30g scoop of whey protein powder contains roughly 110-120 calories, with 24g of protein, 2g of carbohydrates, and 1.5g of fat.
```

## Capabilities

### Find food items by name
Search the entire database to find general calorie and macro data for foods you might be considering.

### Get complete nutrition breakdowns
Fetch detailed nutritional stats for a specific item, including multiple serving size options (like per cup or per 100g).

## Use Cases

### Planning a post-workout meal
A coach asks the agent to build a meal around 40g of protein and 30g of carbs. The agent uses `search_fatsecret_foods` multiple times, pulling several options and generating a full menu that meets the exact macro split.

### Checking packaged ingredient labels
A client is trying to figure out if their cereal contains enough fiber. They ask about 'medium apple' or 'whey protein powder.' The agent uses `get_fatsecret_food_details` to pull the specific, reliable nutrient breakdown for comparison.

### Cross-referencing restaurant items
A user wants to know if a takeout meal is balanced. They input 'Big Mac' and `search_fatsecret_foods` provides the total calories and fat content, allowing them to adjust other parts of their day's intake.

### Determining recipe scale
A nutritionist needs to convert a recipe from 'per cup' to 'per 100g.' They use `get_fatsecret_food_details` to pull the specific weight-based data, ensuring the macro counts are perfectly scalable.

## Benefits

- Accurate Macro Tracking: You get detailed counts of protein, fat, and carbs instantly. Forget rounding off estimates; this gives you the hard numbers needed for serious diet planning.
- Multiple Serving Sizes Handled: Whether a recipe calls for grams, cups, or pieces, `get_fatsecret_food_details` provides the correct metrics for any unit you need.
- Brand Coverage: The database covers everything from generic ingredients to specific packaged goods and restaurant chains. You can check labels without leaving your agent conversation.
- Quick Comparison: Need to compare two similar items? Run a search using `search_fatsecret_foods` on both names, and get their full macro profiles side-by-side for an easy decision.
- Reliable Source: The data comes from a widely used platform trusted globally by millions. You're getting high-quality metrics you can count on.

## How It Works

The bottom line is you get accurate, standardized nutrition numbers directly into your workflow.

1. You ask your agent a question about food nutrition, like 'What are the macros in X?'
2. Your agent uses this MCP to query the FatSecret database and pull the required nutritional data.
3. The result returns structured metrics—calories, protein, fat, carbs—ready for your AI client to use.

## Frequently Asked Questions

**How can I use FatSecret MCP to track my daily protein intake?**
You can ask your agent about specific foods and it will pull the exact protein grams for you. Use `search_fatsecret_foods` first, then follow up with `get_fatsecret_food_details` if you need a full breakdown.

**Does FatSecret MCP cover international brands?**
Yes, the database is extensive and includes coverage for many branded goods and packaged items used globally. This lets you track foods from various sources accurately.

**Is the data provided by search_fatsecret_foods reliable enough for medical use?**
The tool accesses a widely trusted food tracking platform, providing comprehensive macronutrient and caloric counts suitable for dietary planning. Always confirm critical numbers with a professional.

**Can I get different serving sizes using FatSecret MCP?**
Yes. Using `get_fatsecret_food_details` ensures you receive the full nutritional information, including metrics calculated for multiple units like cups or grams.

**What if I don't know the exact brand name?**
Start by using `search_fatsecret_foods`. If the generic item is close enough to what you need, it will give you a solid macro estimate to work with.