Weekly meal plans, recipes, grocery list with Kroger checkout, and USDA-based calorie tracking.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Make a grocery list and a checkout link. Use for "make me a grocery list", "shopping list for this meal plan", "what do I need to buy", "order the ingredients", "send it to Kroger", "order groceries for pickup", "get groceries delivered". Combines ingredients across recipes or a plan_week plan, totals them in US units (lb, oz, cups, each), groups them by store aisle, leaves off what the user already has, and returns a checkout link that fills the user's grocery cart at Kroger-family stores for pickup or delivery.
plan_id from plan_week.
Catalog recipes to shop for, with how many servings to make.
Anything else to add, e.g. {"name": "coffee"}.
Items the user already has; they are left off the list.
Leave off salt, pepper, oil, flour, sugar and common spices.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Make a grocery list and a checkout link. Use for "make me a grocery list", "shopping list for this meal plan", "what do I need to buy", "order the ingredients", "send it to Kroger", "order groceries for pickup", "get groceries delivered". Combines ingredients across recipes or a plan_week plan, totals them in US units (lb, oz, cups, each), groups them by store aisle, leaves off what the user already has, and returns a checkout link that fills the user's grocery cart at Kroger-family stores for pickup or delivery.
| Argument | Type | Description |
|---|---|---|
| plan_id | string | plan_id from plan_week. |
| recipes | array | Catalog recipes to shop for, with how many servings to make. |
| extra_items | array | Anything else to add, e.g. {"name": "coffee"}. |
| have_on_hand | array | Items the user already has; they are left off the list. |
| skip_pantry_staples | boolean | Leave off salt, pepper, oil, flour, sugar and common spices. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"plan_id": {
"type": "string",
"description": "plan_id from plan_week."
},
"recipes": {
"type": "array",
"items": {
"type": "object",
"required": [
"recipe_id",
"servings"
],
"properties": {
"servings": {
"type": "number",
"exclusiveMinimum": 0
},
"recipe_id": {
"type": "string"
}
}
},
"default": [],
"description": "Catalog recipes to shop for, with how many servings to make."
},
"extra_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"unit": {
"type": "string"
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"default": [],
"description": "Anything else to add, e.g. {\"name\": \"coffee\"}."
},
"have_on_hand": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"description": "Items the user already has; they are left off the list."
},
"skip_pantry_staples": {
"type": "boolean",
"default": false,
"description": "Leave off salt, pepper, oil, flour, sugar and common spices."
}
}
}Get 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.
| Argument | Type | Description |
|---|---|---|
| diet | array | |
| meal | string | |
| exclude | array | Foods to leave out, in plain words: "pork", "shellfish", "dairy", "gluten", "peanuts", "mushrooms", "cilantro". Matches allergen tags and ingredient names. |
| request | string | What the user asked for, in their words, e.g. "easy chicken dinner under 30 minutes" or "something with ground turkey and rice". |
| servings | integer | Scale the recipe to this many servings. |
| custom_recipe | object |
Log what I ate and count calories. Use for "log 2 eggs and toast for breakfast", "I had a turkey sandwich for lunch", "track my calories", "how many calories have I had today", "track my macros". Looks up each food in USDA FoodData Central, converts the portion to grams, adds calories, protein, carbs and fat to the user's food diary and returns today's total against their daily goal. Send foods with a quantity and US unit (each, cup, tbsp, oz, slice). Call with no foods to read today's totals. Keep the returned diary_id and pass it on later calls.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD in the user's local time. Defaults to today (UTC). |
| meal | string | |
| foods | array | What the user ate, e.g. [{"name":"banana","quantity":1,"unit":"each"},{"name":"peanut butter","quantity":2,"unit":"tbsp"}]. |
| recipe | object | Log servings of a recipe from plan_week or generate_recipe. |
| diary_id | string | Food diary id from an earlier log_calories call. Omit on first use; a new diary is created. Remember and reuse it. |
| daily_goal | integer | Daily calorie goal; saved on the diary. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD in the user's local time. Defaults to today (UTC)."
},
"meal": {
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
],
"type": "string",
"default": "snack"
},
"foods": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"quantity",
"unit"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Plain ingredient name, e.g. \"boneless skinless chicken breast\"."
},
"note": {
"type": "string"
},
"unit": {
"type": "string",
"description": "US unit: tsp, tbsp, cup, fl oz, oz, lb, g, each, clove, slice, can, pinch."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"default": [],
"description": "What the user ate, e.g. [{\"name\":\"banana\",\"quantity\":1,\"unit\":\"each\"},{\"name\":\"peanut butter\",\"quantity\":2,\"unit\":\"tbsp\"}]."
},
"recipe": {
"type": "object",
"required": [
"recipe_id",
"servings"
],
"properties": {
"servings": {
"type": "number",
"exclusiveMinimum": 0
},
"recipe_id": {
"type": "string"
}
},
"description": "Log servings of a recipe from plan_week or generate_recipe."
},
"diary_id": {
"type": "string",
"description": "Food diary id from an earlier log_calories call. Omit on first use; a new diary is created. Remember and reuse it."
},
"daily_goal": {
"type": "integer",
"maximum": 6000,
"minimum": 800,
"description": "Daily calorie goal; saved on the diary."
}
}
}Plan my meals for the week. Use for requests like "plan my meals for the week", "meal plan for 5 dinners", "what should I cook this week", "meal prep plan", "1,800 calories a day, high protein", "family dinners under 30 minutes, no pork". Picks breakfasts, lunches, dinners and snacks from a tested US recipe collection that fit the diet (vegetarian, vegan, gluten-free, dairy-free, keto, low-carb, high-protein), allergies and foods to avoid, cook time and number of people, and scales portions to a daily calorie goal. Calories and macros come from USDA FoodData Central, never estimated. Returns a day-by-day plan plus a plan_id; then call build_shopping_list with the plan_id for the grocery list and checkout link.
| Argument | Type | Description |
|---|---|---|
| days | integer | How many days to plan (1-7). '5 dinners' = days 5, meals ['dinner']. |
| diet | array | Diet preferences every meal must satisfy. |
| seed | integer | Change to get a different plan with the same constraints. |
| meals | array | Which meals to plan each day. |
| people | integer | How many people you're cooking for (scales the grocery list). |
| exclude | array | Foods to leave out, in plain words: "pork", "shellfish", "dairy", "gluten", "peanuts", "mushrooms", "cilantro". Matches allergen tags and ingredient names. |
| 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 | integer |
| ingredients_on_hand | array | Ingredients the user already has; recipes using them rank higher. |
| calories_per_serving | integer | Target kcal per serving; closest match ranks higher. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"diet": {
"type": "array",
"items": {
"enum": [
"vegetarian",
"vegan",
"pescatarian",
"gluten-free",
"dairy-free",
"low-carb",
"keto",
"high-protein",
"nut-free",
"mediterranean",
"kid-friendly"
],
"type": "string"
},
"default": []
},
"meal": {
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
],
"type": "string"
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"default": [],
"maxItems": 30,
"description": "Foods to leave out, in plain words: \"pork\", \"shellfish\", \"dairy\", \"gluten\", \"peanuts\", \"mushrooms\", \"cilantro\". Matches allergen tags and ingredient names."
},
"request": {
"type": "string",
"default": "",
"maxLength": 500,
"description": "What the user asked for, in their words, e.g. \"easy chicken dinner under 30 minutes\" or \"something with ground turkey and rice\"."
},
"servings": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Scale the recipe to this many servings."
},
"custom_recipe": {
"type": "object",
"required": [
"name",
"servings",
"ingredients"
],
"properties": {
"name": {
"type": "string"
},
"steps": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"servings": {
"type": "integer",
"maximum": 24,
"minimum": 1
},
"ingredients": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"quantity",
"unit"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Plain ingredient name, e.g. \"boneless skinless chicken breast\"."
},
"note": {
"type": "string"
},
"unit": {
"type": "string",
"description": "US unit: tsp, tbsp, cup, fl oz, oz, lb, g, each, clove, slice, can, pinch."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"maxItems": 60,
"minItems": 1
},
"total_minutes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"description": "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": {
"type": "integer",
"maximum": 240,
"minimum": 5
},
"ingredients_on_hand": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"description": "Ingredients the user already has; recipes using them rank higher."
},
"calories_per_serving": {
"type": "integer",
"maximum": 2000,
"minimum": 100,
"description": "Target kcal per serving; closest match ranks higher."
}
}
}| cuisines |
| array |
| Preferred cuisines, e.g. ["Mexican", "Italian"]. Soft preference. |
| daily_calories | integer | Calorie goal per person per day, e.g. 2000. Portions are scaled to hit it. |
| max_cook_minutes | integer | Max total prep + cook time per meal, e.g. 30 for quick weeknight meals. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"type": "integer",
"default": 7,
"maximum": 7,
"minimum": 1,
"description": "How many days to plan (1-7). '5 dinners' = days 5, meals ['dinner']."
},
"diet": {
"type": "array",
"items": {
"enum": [
"vegetarian",
"vegan",
"pescatarian",
"gluten-free",
"dairy-free",
"low-carb",
"keto",
"high-protein",
"nut-free",
"mediterranean",
"kid-friendly"
],
"type": "string"
},
"default": [],
"description": "Diet preferences every meal must satisfy."
},
"seed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Change to get a different plan with the same constraints."
},
"meals": {
"type": "array",
"items": {
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
],
"type": "string"
},
"default": [
"breakfast",
"lunch",
"dinner"
],
"minItems": 1,
"description": "Which meals to plan each day."
},
"people": {
"type": "integer",
"default": 1,
"maximum": 12,
"minimum": 1,
"description": "How many people you're cooking for (scales the grocery list)."
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"default": [],
"maxItems": 30,
"description": "Foods to leave out, in plain words: \"pork\", \"shellfish\", \"dairy\", \"gluten\", \"peanuts\", \"mushrooms\", \"cilantro\". Matches allergen tags and ingredient names."
},
"cuisines": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"description": "Preferred cuisines, e.g. [\"Mexican\", \"Italian\"]. Soft preference."
},
"daily_calories": {
"type": "integer",
"maximum": 5000,
"minimum": 1000,
"description": "Calorie goal per person per day, e.g. 2000. Portions are scaled to hit it."
},
"max_cook_minutes": {
"type": "integer",
"maximum": 240,
"minimum": 5,
"description": "Max total prep + cook time per meal, e.g. 30 for quick weeknight meals."
}
}
}