Ingredient Convert MCP
# ingredient-convert-mcp
Cooking ingredient unit converter MCP server. Converts between cups, tablespoons, teaspoons,
millilitres, fluid ounces, grams and ounces using a per-ingredient density table
(1 cup all-purpose flour = 125 g, 1 cup water = 236.588 g, 1 cup honey = 340 g), and scales recipes.
Tools: `convert_ingredient`, `list_ingredients`, `scale_recipe`, `convert_bulk`,
`decimal_to_fraction`, `fraction_to_decimal`, `common_conversions`.
## Connect
Hosted endpoint (Streamable HTTP, no token, no sign-up):
```
https://ingredient-convert-mcp.lipmichal.workers.dev/mcp
```
Paste it into any MCP client that accepts a remote server URL (a custom connector, ChatGPT developer mode), or:
```
claude mcp add --transport http ingredient-convert https://ingredient-convert-mcp.lipmichal.workers.dev/mcp
```
Local stdio from this repository:
```
npm ci && npm run build
node dist/stdio.js
```
## Notes
- Deterministic: no network calls, no clock, no randomness. The hosted Worker makes no upstream request.
- Densities are US customary reference values (King Arthur Baking ingredient weight chart, USDA FoodData Central where available). Volume measures assume level, unpacked cups.
- The hosted Worker accepts a well-formed `mcp-protocol-version` newer than its SDK knows (for example `2026-07-28`) and serves it as the SDK's latest version; malformed values are still refused with 400.
- Web calculator: https://ingredientcalculator.com
## License
MIT
TDQS
Scored across 7 tools
Each tool has a distinct role: two inverse format converters, a static lookup, a density table lister, a single-item converter, a recipe scaler, and a batch converter. The main friction is convert_ingredient vs convert_bulk (bulk is clearly described as the batch variant with per-item error reporting) and common_conversions vs convert_ingredient, which overlap in output but differ by being a curated static lookup.
All names use consistent snake_case, and most follow verb_noun (list_ingredients, convert_ingredient, scale_recipe, convert_bulk). Minor deviations: decimal_to_fraction and fraction_to_decimal use an X_to_Y pattern, and common_conversions is a bare noun phrase, but all remain transparent.
Seven tools is well-scoped for a cooking-conversion server; each covers a distinct operation (format conversion, lookup, single, batch, scaling) with no filler.
The surface covers the core lifecycle: fraction/decimal conversion both ways, ingredient density listing, single and bulk ingredient conversion, and recipe scaling with friendly output. Minor gaps remain, notably temperature/oven conversions and a way to add or override ingredient densities.