# Leftover Chef

> Turn leftovers and fridge odds and ends into 5 recipe ideas, using what expires first. List what is in your fridge and cupboard, mark what must be used soon, and set diet, equipment and time. Leftover Chef matches your ingredients against 37 flexible recipe templates (frittata, fried rice, soup, curry…) and ranks the five that use the most of what you have with the fewest missing items.

Part of usefulweb.site (https://usefulweb.site/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://leftoverchef.usefulweb.site/ (interactive tool at https://leftoverchef.usefulweb.site/tool)
- JSON API: POST https://leftoverchef.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://leftoverchef.usefulweb.site/api/v1/tool)
- OpenAPI: https://leftoverchef.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://leftoverchef.usefulweb.site/mcp - tool `leftover_chef`

## Inputs
- ingredients (list, required): Ingredients you have - One per line, e.g. "2 eggs", "leftover rice", "half a courgette".
- useSoon (list): Must use soon - Items close to expiry get priority (added to the ingredients automatically).
- diet (multiselect): Diet
- equipment (multiselect): Equipment available
- maxMinutes (integer): Maximum time

## Method
- Each ingredient line is normalised: lower-cased, quantities/units and words like "leftover", "fresh", "chopped" removed, plurals singularised, synonyms mapped (courgette → zucchini, garbanzo → chickpea…), then classified (vegetable, protein, grain, dairy…) with diet flags. "Vegan …", "dairy-free …", "gluten-free …" prefixes clear the matching flags.
- Templates are editorial: each has core requirements (one of several alternatives), flexible slots (e.g. 1–4 vegetables, optional cheese), equipment alternatives and a total time. Salt, pepper, cooking oil, water and dried spices are assumed available.
- A template is eligible if its time ≤ your maximum, you have one of its equipment options, every unmet core requirement still has a diet-compatible alternative, at least one of your ingredients is used and at most 3 items are missing.
- Core requirements are filled first, then slots; use-soon items are always tried first and each ingredient is used once per recipe.
- Score = 50 × share of core requirements you have + 30 × share of your use-soon items used + 3 × core requirements you have + 4 × number of your ingredients used (max 8) − 12 × missing items. Ties: fewer missing, shorter time, then template id.

## Limits
- Generic cooking templates, not tested recipes. Check that leftovers are still safe to eat and cook meat, fish and eggs thoroughly.