# Sodium Total Calculator AI Agent Connect

> Sodium Total Calculator MCP lets your AI agent process food lists to monitor salt consumption. It handles everything from validating individual food entries to calculating total and average sodium levels across entire meals or daily logs. You can quickly identify high-sodium culprits or group your intake by food category to see exactly where your salt is coming from.

## Overview
- **Category:** health
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_APcYDdEsEU8Mo6di9MqVB5J4jqUpXDOjX8fp8HpL/ai-agent-connect
- **Tags:** sodium, nutrition, health, diet, food-analysis

## Description

Managing sodium intake becomes much easier when your AI client can actually crunch the numbers for you. Instead of manual math, you can hand a list of foods to your agent and get immediate feedback on your salt levels. This MCP gives your AI the specific tools needed to validate food entries, calculate totals, and filter out items that exceed your personal dietary limits. 

You can use it to audit a grocery list, analyze a restaurant menu, or keep a running log of everything you eat. If you need to know how much sodium is in a specific meal, your agent can use the calculation tools to give you a breakdown. If you are trying to stay under a strict limit, you can have your agent scan your food list and flag only the items that pose a risk. It turns a messy list of food items into structured, actionable nutritional data.

## Tools

### calculate_sodium_metrics
This tool calculates the total and average sodium content for any list of food items you provide.

### filter_high_sodium_items
Use this to pull out only the food items that meet or exceed a specific sodium threshold you set.

### get_sodium_summary_by_category
This tool groups your food items by type to show total sodium and item counts for each category.

### validate_sodium_entry
This tool checks a single food entry to ensure the name and sodium amount are formatted correctly.

## Prompt Examples

**Prompt:** 
```
What is the total and average sodium for 100mg of bread and 200mg of cheese?
```

**Response:** 
```
The total sodium is 300mg and the average is 150mg per item.
```

**Prompt:** 
```
Which of these items are high in sodium: bread (10mg), soup (500mg), and crackers (150mg) if my limit is 200mg?
```

**Response:** 
```
The high sodium items are soup (500mg) and crackers (150mg).
```

**Prompt:** 
```
Is a food entry with name 'Apple' and 0mg sodium valid?
```

**Response:** 
```
Yes, the entry is valid.
```

## Capabilities

### Sodium Math
Your agent calculates total and average salt content for food lists.

### Threshold Filtering
The AI identifies specific foods that cross your set sodium limits.

### Category Grouping
Your agent organizes sodium totals by food type.

### Data Validation
The AI checks that food names and sodium amounts are entered correctly.

## Use Cases

### Daily Intake Tracking
You give your agent a list of everything you ate today to see your total sodium count.

### Grocery List Auditing
Your agent scans your shopping list to find items that might be too high in salt.

### Meal Planning
You use the category summary to see which food groups contribute most to your salt intake.

### Restaurant Menu Analysis
Your agent checks menu items against your dietary constraints to find safe options.

## Benefits

- Eliminates manual math for sodium totals.
- Flags high-sodium foods based on custom limits.
- Organizes nutritional data into clear categories.
- Ensures data integrity with entry validation.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to sodium calculation tools.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Provide a list of food items and their sodium content to your agent.
3. Ask the agent to calculate totals, filter items, or group by category.
4. Review the structured nutritional data returned by the agent.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the Vinkius hosted MCP once, and then Claude can use the tools directly through the Model Context Protocol.

**Can I set a custom sodium limit?**
Yes, you can tell your agent to filter items that exceed a specific threshold using the filtering tool.

**Does this MCP work with Cursor or Windsurf?**
Yes, it works with any MCP-compatible client including Cursor and Windsurf.

**What happens if I enter an invalid food item?**
The validation tool checks the entry for a valid name and sodium amount to ensure your data stays accurate.

**Can I see sodium totals by food group?**
Yes, the tool can group sodium totals and item counts by category.

**How do I calculate the total sodium for my meals?**
You can use the `calculate_sodium_metrics` tool by providing a list of food items with their sodium amounts in milligrams.

**Can I filter items that are too salty?**
Yes, use the `filter_high_sodium_items` tool to identify any food items that meet or exceed your specified sodium threshold.

**How can I see sodium distribution by food group?**
The `get_sodium_summary_by_category` tool allows you to see total sodium and item counts grouped by categories like 'Dairy' or 'Snacks'.