Plateful

Checks a running recipe import started by import_recipe_from_url or import_recipe_from_text. Returns status 'importing' while it runs, 'ready' with the finished recipe summaries (including each recipe's url and image_url), or 'failed' with the reason. While the user waits, poll every few seconds; stop as soon as the status is 'ready' or 'failed'. A 'failed' import cannot be retried through this tool — tell the user what went wrong; they can retry from the Plateful app's Home screen.

get_import_status

Creates a new recipe collection (folder) in the household. Names are unique per household, ignoring case. Name it in the household's language (see get_context). Leave color_key out unless the user asks for a colour; the household's least-used palette colour is chosen.

create_collection

Saves a new recipe to the household's Plateful library. It becomes visible to every household member immediately. Write the recipe in the household's language (see get_context) and prefer metric units. A cover image is generated automatically in the background, and when you omit `nutrition` the per-serving values are estimated there too — both appear in the app shortly after saving, so tell the user they are on the way rather than that they are missing. Returns the saved recipe as stored, including how each ingredient line was parsed — check it rather than assuming. Hosts that support UI components render the result as a Plateful card with an "Open in Plateful" button, so do not also paste `url` as a link in your reply — a chat link opens an in-app browser with no Plateful session.

create_recipe

Starts creating a Plateful recipe from free text: a pasted recipe, rough notes, or a described idea ('a quick weeknight dal for four'). Plateful's AI structures it into ingredients and steps, estimates nutrition and generates a cover image. Runs in the background: this returns an import_id immediately; poll get_import_status with it, or let the user watch it finish on Plateful's Home screen. Prefer create_recipe when you already have exact, structured ingredients and steps to save verbatim — this tool is for unstructured text that needs interpreting. By default the recipe is written in the household's language (see get_context); pass language to override.

import_recipe_from_text

Permanently deletes a recipe from the household's Plateful library. THIS CANNOT BE UNDONE. There is no trash and no restore: the recipe, its ingredients, its steps, its ratings and any meal-plan entries pointing at it are all removed, for every household member. Confirm with the user before calling this, and make sure you have the right recipe — check it with get_recipe first if there is any doubt.

delete_recipe

Returns who the signed-in Plateful user is, which household their recipes belong to, and how much is in it. Call this once before other tools when you need to know the household's language (recipes should be written in it) or whether the library is empty. Plateful is a shared meal-planning app: every recipe and collection belongs to a household, so anything created or edited here is visible to all its members.

get_context

Returns one complete Plateful recipe: ingredients, numbered steps, per-serving nutrition, collections and ratings. Hosts that support UI components render this as a Plateful card with the photo and an "Open in Plateful" button, so do not also paste `url` as a link in your reply — a chat link opens an in-app browser with no Plateful session. When `servings` is set, the ingredient quantities are for that many servings — scale them proportionally if the user wants a different amount. A null `servings` means the recipe never recorded one, so take the quantities as written. Get recipe ids from search_recipes.

get_recipe

Starts importing a recipe into Plateful from a web page, Instagram, TikTok or YouTube link. Plateful fetches the page, extracts the recipe (splitting into several recipes if the source contains more than one) and files it in the household library. Runs in the background: this returns an import_id immediately, and the import typically finishes in well under a minute. Poll get_import_status with the import_id to get the finished recipes; the user also sees the import running on Plateful's Home screen and gets a push notification when it is done, so polling is optional if the user does not want to wait. By default the recipe is written in the household's language (see get_context); pass language to override.

import_recipe_from_url

Lists the household's recipe collections (folders) with how many recipes each holds. Use the ids with search_recipes to browse one collection, or with set_recipe_collections to file a recipe.

list_collections

Records the signed-in user's rating of a recipe, from 1 to 5 stars, with an optional note. Each person has one rating per recipe — calling this again replaces their previous one rather than adding a second. Ratings and notes are visible to the whole household.

rate_recipe