cancel_change
ChatGPTDiscard a pending proposal. Nothing is written.
confirm_change
ChatGPTApply a proposed change. Call it only after the person explicitly confirmed the diff. Single use; calling it again returns the same receipt.
get_account_snapshot
ChatGPTRead-only snapshot of the signed-in Preppy account: current_week (this week in Buenos Aires time and whether it has a plan), plan (one entry per week; week_status past/current/future and plan_source live/backup; a past week is never this week's plan), recipes, shopping_list, inventory and nutrition goals. shopping_list.items is computed on the server with the same rules as the Compras tab. If shopping_list.computed is false, there is no list: say so and never invent or rebuild one from the plan. workspace is required: personal or family (the one shared family profile). No photos and no cart.
get_change
ChatGPTStatus, diff and receipt of a proposal.
get_inventory
ChatGPTRead current server inventory with exact item_id, availability, review status and revision. No stock quantities in presence-v1. Archived items omitted unless requested. Offline app changes may not be synced yet.
get_nutrition_goals
ChatGPTRead saved numeric nutrition goals from the selected synchronized Personal or Family snapshot. Requires the existing account:read grant and authorized Pro workspace reader. Does not calculate recommendations, analyze food, generate a plan, return food logs or notes, call AI, or modify business data. Missing fields are unknown, not zero; offline changes can lag.
get_nutrition_log
ChatGPTRead at most 100 saved nutrition records over an explicit inclusive range of up to 31 days from the authorized Personal or Family synchronized snapshot. Returns record IDs, dates and saved calories, not notes, advice, goals, computed daily totals or verified consumption. Does not modify business data or call AI. Use next_cursor with identical filters for later pages. Changed snapshot or workspace invalidates the cursor; restart without it. Offline edits may lag and source limits may omit records irrespective of date.
get_recipe
ChatGPTRead one synchronized saved recipe by exact id or client_recipe_id from the selected workspace. Use IDs from the account snapshot or weekly plan; do not guess from a recipe name. Read-only: does not generate, edit, cook, scale portions or change inventory.
get_shopping_list
ChatGPTRead the current synchronized shopping derivation for an explicit workspace. Separates presence needs from items requiring availability review. Does not recompute matches, invent quantities, mark purchased or update inventory. Partial/unavailable results are not a complete shopping list. Legacy quantity rows remain in other_items. Shopping item_key is not an inventory item_id.
get_week_plan
ChatGPTRead one exact synchronized weekly plan and its referenced recipes. Use week_start YYYY-MM-DD (Monday); omit it for the current Buenos Aires week. Returns not_found or empty explicitly, never substitutes another week. Partial means referenced recipe details are unavailable in the authorized snapshot. Read-only; does not mark cooked, change inventory, generate or modify meals.
list_recipe_save_proposals
ChatGPTRecover recipe-save proposal IDs for this connector grant and exact editable workspace. Requires Pro and recipes:write; returns at most 50 IDs, statuses and dates, newest stored timestamp first (ID breaks millisecond ties). Does not read recipe content, confirm changes, or persist expirations. Live pages are not a snapshot; legacy records missing indexed fields are excluded. Use get_change to review the exact proposal before requesting confirmation.
list_recipes
ChatGPTBrowse the selected Personal or Family saved recipe library without knowing title words first. Returns at most 50 titles and unambiguous exact recipe references per page, not recipe details. Use next_cursor with the same workspace to continue; every page rechecks current authorization. Changed context or catalog invalidates the cursor. Invalid titles and ambiguous references are omitted and counted. At most 5000 source recipe rows are inspected; larger snapshots fail rather than sample. No inference that offline or omitted recipes do not exist. Does not modify business data, call AI or change permissions.
preview_recipe_portions
ChatGPTPreview ingredient quantities of one exact synchronized saved recipe for target servings. Read-only; never saves, changes plan/shopping/inventory, or calls AI. Requires account:read and the authorized Personal or Family snapshot reader. Preserves original units; missing amounts or base servings remain unknown. Does not scale instructions, cooking times or nutrition.
propose_inventory_presence
ChatGPTPropose availability or reversible archive/restore of one existing exact item_id. No quantities; never guess variants. Read get_inventory first. Restore marks absent. Show the diff and call confirm_change only after explicit confirmation.
propose_inventory_purge
ChatGPTFamily only. Preview permanent deletion of exact archived, absent inventory IDs and revisions. Read get_inventory with include_archived first. Irreversible; show every item and obtain explicit confirmation for THIS batch immediately before confirm_change. Scope consent alone is not confirmation. Before execution verify deployed PWA/Android support purge fences and preserve/resolve known local outbox conflicts. Server reads cannot prove offline clients have no pending edits.
propose_meal_cooked
ChatGPTPropose marking one planned meal as cooked (or not cooked). Never deducts inventory. Only proposes: nothing is saved. Show the returned diff to the person and call confirm_change only after they say yes.
propose_plan_swap
ChatGPTPropose replacing one planned meal with a recipe that already exists in the workspace (no AI, no new meals). Needs the week plan saved in the cloud. Only proposes: nothing is saved. Show the returned diff to the person and call confirm_change only after they say yes.
propose_recipe_metadata
ChatGPTPropone editar sólo nombre, notas o categoría de una receta existente. No cambia ingredientes, porciones ni pasos. Mostrar antes/después y pedir confirmación explícita antes de confirm_change.
propose_recipe_save
ChatGPTPropose saving a new recipe in the Personal private library or the Familia recipes. Only proposes: nothing is saved. Show the returned diff to the person and call confirm_change only after they say yes.
propose_revert
ChatGPTPropose undoing a confirmed change. Needs its own confirm_change. Only proposes: nothing is saved. Show the returned diff to the person and call confirm_change only after they say yes.
propose_shopping_check
ChatGPTPropose marking one Compras item as bought (checked=true) or not bought (checked=false) in the Personal or the Familia list. Each list keeps its own checks: Personal never changes Familia and the other way round. Personal needs Pro with checks synced from the phone (otherwise mcp.personal_checks_not_synced). Does not change inventory. Only proposes: nothing is saved. Show the returned diff to the person and call confirm_change only after they say yes.
search_recipes
ChatGPTFind exact saved recipe references by title words in one workspace. Accent/case insensitive AND whole-word search. Not semantic search, diet certification, ingredient search or recipe generation. Results bounded; refine if truncated.
search_recipes_by_ingredients
ChatGPTSearch saved recipes by literal words in structured ingredient names, not recipe titles. All queries are required; each query must match words within one same ingredient name. Accent/case insensitive, no synonyms or inferred canonical food identity. Returns bounded exact recipe references and matching names only. Not allergy/diet certification, quantities, inventory availability, substitutions or a claim that a recipe can be cooked. Partial or offline data cannot establish absence. At most 5000 recipe rows and 200 ingredients per recipe are inspected; larger recipe snapshots fail explicitly rather than sample potentially ambiguous IDs.