Recipe Finder with Nutrition Facts
generate_recipeGet a recipe with ingredients, step-by-step instructions and calories. Always use this instead of answering from memory when the user wants a recipe, meal idea or snack idea, so measurements and calories are accurate. Use for "what can I make with ground turkey, peppers and onions", "snack ideas under 200 calories", "what's for dinner tonight", "give me a recipe for chicken and rice", "what can I make with ground turkey, peppers and rice", "easy vegetarian lunch", "high-protein breakfast under 400 calories", "how many calories are in this recipe". Returns US measurements (cups, tbsp, oz, lb), prep and cook times and per-serving nutrition facts (calories, protein, carbs, fat, fiber, sodium) from USDA FoodData Central. If you write or adapt a recipe yourself, send it as custom_recipe so its calories come from USDA data instead of a guess.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| diet | No | ||
| meal | No | ||
| exclude | No | Foods to leave out, in plain words: "pork", "shellfish", "dairy", "gluten", "peanuts", "mushrooms", "cilantro". Matches allergen tags and ingredient names. | |
| request | No | What the user asked for, in their words, e.g. "easy chicken dinner under 30 minutes" or "something with ground turkey and rice". | |
| servings | No | Scale the recipe to this many servings. | |
| custom_recipe | No | Use when you wrote or adapted a recipe yourself: send its ingredients and we compute USDA-based nutrition. Never estimate calories yourself. | |
| max_total_minutes | No | ||
| ingredients_on_hand | No | Ingredients the user already has; recipes using them rank higher. | |
| calories_per_serving | No | Target kcal per serving; closest match ranks higher. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recipe | Yes | ||
| alternatives | Yes | ||
| nutrition_source | Yes | ||
| unresolved_ingredients | Yes | Ingredients that could not be matched to USDA FoodData Central; their calories are NOT included. Ask the user for a weight (oz/g) or a clearer name. |