RecipeBee

Use after prepare_meal_plan_import. Submit exactly one decision for every recipe. Use use_existing only with a recipe ID returned by preparation and only after the user chooses it; otherwise use create_new. This creates one private meal plan and its entries atomically, then renders the final RecipeBee card. Claim success only when persisted=true. The response may include an optional image batch link; never start image generation from MCP client.

commit_meal_plan_import

Use when the user wants to attach an image generated or uploaded in the current MCP client conversation to an existing private RecipeBee recipe. Prefer the Apps SDK file input when MCP client supplies file with download_url and file_id. Use image_url only for a URL selected or uploaded in the RecipeBee widget. If neither file nor image_url is available, return a pending selection and do not claim attachment. The widget picker is a fallback because native generated images may not be available in MCP client Files. Report attachment only after persisted=true and needs_image_selection=false. mode=replace changes which retained image is primary but does not delete the previous image; use it only after the user explicitly requests replacement. Do not use for a new RecipeBee-generated image.

attach_recipe_image

Check the private AI image status for an existing RecipeBee recipe after image generation was requested.

get_recipe_image

Use only when the user explicitly asks RecipeBee to generate a new AI image for an existing private recipe or explicitly accepts RecipeBee image credits. Do not use for a native MCP client image or an image already generated or uploaded in this conversation. mode=add retains the current primary image. mode=replace changes which retained image is primary but does not delete the previous image; use it only after the user explicitly requests replacement.

generate_recipe_image

Read the progress of an optional RecipeBee image-generation batch returned by a meal-plan import. This tool never starts, charges, or cancels image generation; the user must confirm the batch in RecipeBee.

get_image_generation_batch

Use only after the user explicitly asks to add a completed meal plan to RecipeBee. This stateful, data-only step checks private recipes for exact or possible matches and creates a short-lived import draft without creating recipes or a meal plan or rendering a RecipeBee card. Do not use for chat-only meal planning. Wait for explicit recipe choices when matches are returned.

prepare_meal_plan_import

Use when the user asks to review a meal plan without adding it to RecipeBee. This chat-only, data-only tool never writes recipes or meal plans and does not render a RecipeBee card.

preview_meal_plan

Use when the user asks to preview or review a complete recipe without saving it. Include realistic integer prep_time_minutes, cook_time_minutes, and total_time_minutes values in every complete recipe. Estimate them when the user does not specify times; use 0 only when that part genuinely takes no time. Validate and render the recipe without persistence. Do not call as an intermediate step when the user has already explicitly asked to save.

preview_recipe

Use when the user explicitly asks to save a complete recipe privately. Include realistic integer prep_time_minutes, cook_time_minutes, and total_time_minutes values in every complete recipe. Estimate them when the user does not specify times; use 0 only when that part genuinely takes no time. Save exactly once. If the user explicitly asks RecipeBee to create the image, use save_recipe_with_image instead. If the user wants to attach a MCP client-generated or uploaded image, save the recipe with this tool and then use attach_recipe_image. Do not publish or use browser control.

save_recipe

Use only when the user explicitly asks RecipeBee to generate its own AI food image while saving a complete recipe privately, explicitly names RecipeBee's image generator, or explicitly accepts RecipeBee image credits. Include realistic integer prep_time_minutes, cook_time_minutes, and total_time_minutes values in every complete recipe. Estimate them when the user does not specify times; use 0 only when that part genuinely takes no time. Do not use for ordinary requests to create or generate an image in MCP client. Save exactly once and queue RecipeBee's moderated image pipeline. For a MCP client-generated or uploaded image, use save_recipe followed by attach_recipe_image instead. Do not call preview_recipe or save_recipe first.

save_recipe_with_image