# Culinary Unit Converter MCP MCP

> Culinary Unit Converter handles precise conversions for cooking measurements. This MCP lets you switch between standard volumetric units like cups, milliliters, and fluid ounces, or estimate the weight in grams of an ingredient just by knowing its volume and type (liquid, solid, or granulated). It's built to take the guesswork out of recipes, whether you're baking bread or making cocktails.

## Overview
- **Category:** utilities
- **Price:** Free
- **Tags:** culinary, measurement, conversion, cooking, kitchen

## Description

You shouldn't have to look up conversion charts every time a recipe calls for a weird mix of measurements. This MCP gives your agent instant access to precise culinary math. Need to swap 'cup' for 'teaspoon'? Done. Want to know if 100ml is enough for the frosting? We calculate it, factoring in whether you're working with liquid or dry ingredients. It’s more than just a lookup table; it handles dimensional consistency automatically. Connecting this MCP via Vinkius means your agent can pull these conversion facts into any workflow—from meal planning to inventory management. You get accurate results instantly, letting you focus on the cooking part, not the math.

## Tools

### convert_volume
Converts a given amount from one volumetric unit type to another.

### estimate_mass
Calculates the estimated weight in grams for an ingredient based on its volume and type (liquid, granulated, or solid).

### get_unit_details
Provides descriptive metadata and usage context for any specific culinary unit.

## Prompt Examples

**Prompt:** 
```
Convert 2 cups to tablespoons.
```

**Response:** 
```
Using `convert_volume`, 2 cups is equal to 32 tablespoons.
```

**Prompt:** 
```
How many grams is 100ml of liquid ingredient?
```

**Response:** 
```
By calling `estimate_mass` with volume 100, unit 'ml', and type 'liquid', the estimated mass is 100 grams.
```

**Prompt:** 
```
What is the usage of a teaspoon?
```

**Response:** 
```
The `get_unit_details` tool for 'teaspoon' shows it has a standard volume of 5ml and is typically used for small amounts of spices or liquids.
```

## Capabilities

### Convert Volume Units
Switches a measurement's quantity between common volumetric units like fluid ounces, tablespoons, and liters.

### Estimate Ingredient Weight
Calculates the approximate mass in grams for an ingredient given its volume and whether it’s liquid, solid, or dry.

### Check Unit Details
Retrieves specific metadata about any culinary unit, like standard definitions or typical usage context.

## Use Cases

### Scaling a Recipe Upwards
The user has a cake recipe designed for 6 people but needs it for 30. They ask their agent to scale the volume from cups to liters, and then convert those liters into the necessary grams using `estimate_mass`. The agent gives them a clean, usable list of updated ingredient weights.

### Batch Cocktail Production
A bartender needs to make 50 servings of a drink that originally called for fluid ounces. They ask the MCP to first convert the total volume into milliliters using `convert_volume`, then calculate how many bottles they need.

### Ingredient Substitution
A cook runs out of buttermilk and needs to substitute milk plus an acid. They use their agent to check unit details via `get_unit_details` to confirm the proper ratio for a specific volume, ensuring the recipe doesn't fail.

## Benefits

- Eliminate math errors when scaling recipes; simply ask your agent to use `convert_volume` for perfect unit swaps, like turning cups into milliliters.
- Get weight estimates instead of just volume numbers. Use `estimate_mass` to know exactly how many grams an ingredient weighs, which is critical for baking science.
- Quickly understand any measurement. If you're unsure what a 'pinch' means, use `get_unit_details` to pull up the standard usage context instantly.
- Maintain consistency across international recipes. The MCP handles conversions between metric and imperial systems automatically every time.
- Saves deep digging through conversion charts. Your agent acts as the math reference book for your kitchen or lab.

## How It Works

The bottom line is you stop manually cross-referencing conversion charts and start getting actionable measurements directly from your agent.

1. Tell your agent the conversion you need, providing both the starting value and its current unit.
2. The MCP runs the calculation using the correct internal factors to find the equivalent measurement in the new unit.
3. You receive a single, accurate number (and the target unit) that replaces all the messy math.

## Frequently Asked Questions

**How can I convert cups to milliliters?**
You can use the `convert_volume` tool by providing the value, setting 'fromUnit' to 'cup', and 'toUnit' to 'ml'.

**How does mass estimation work?**
The `estimate_mass` tool uses the ingredient type (liquid, granulated, or solid) to apply a density multiplier to the volume provided.

**What units are supported?**
Supported units include cup, tablespoon, teaspoon, ml, oz, liter, and pinch. You can inspect specific unit metadata using `get_unit_details`.

**If I use `convert_volume` with an invalid unit or negative number, what happens?**
The system returns a precise error message instead of failing silently. It tells you exactly which value or unit is incorrect, letting you correct the input immediately.

**What specific data inputs does `estimate_mass` require to calculate weight?**
It needs three pieces of information: a numerical volume, the source unit (like 'ml'), and the ingredient type. You must specify if it’s 'liquid', 'solid', or 'granulated' for accuracy.

**Beyond basic definitions, what extra context does `get_unit_details` provide?**
It returns detailed metadata about the unit, including its standard volume definition and common usage scenarios. This gives you a fuller picture of how that measurement works in practice.

**Are there any performance limitations when using `convert_volume` multiple times?**
No. The MCP is designed for continuous use, so you can run conversions back-to-back without hitting artificial rate limits or slowdowns within your agent's workflow.

**Does the `estimate_mass` tool correctly handle different ingredient states like powders versus liquids?**
Yep. It handles three distinct types of materials: liquid, solid, and granulated. You just need to specify the correct type string when calling the tool for an accurate gram estimate.