HelloFood

Find a restaurant by name

Search for a restaurant by name. Returns matching restaurants with their IDs, addresses, and whether they have a menu available. Use the returned restaurant_id with get_menu to retrieve the full menu. No account required. Tip: search by restaurant name only (e.g. 'Out of Bounds'). If multiple locations match, ask the user which location they mean before calling get_menu.

Get a restaurant menu

Get the full menu for a restaurant by ID. Returns sections with items, prices, allergen flags, substitution options, and owner context. Existing menus need no account. When a linked account requests a menu that is not available yet, this starts fetching it and returns status=acquiring plus a job_id; call get_menu_status with both IDs until ready.

Check menu fetch status

Poll a menu fetch started by get_menu. Pass the same restaurant_id and the returned job_id. If status is acquiring, poll again; ready includes the complete canonical menu. timed_out only means it is still being fetched and can be retried shortly. Requires a linked HelloFood account.

Evaluate a food item

Evaluate a specific food item's safety for the linked user's dietary profile. Returns a safety verdict (generally_safer, risky, avoid, or unable_to_evaluate), conflicts, suggested modifications, and alternatives. Covers the whole household by default when the account has synced members (the verdict is then the worst member's, with a per-member breakdown); pass household_scope only when the user explicitly named who this is for. This reads the item NAME against the profile and never reads a captu

Issue dietary claims

Derive signed coarse-grained dietary claims for the linked user. Returns claim categories (e.g. restriction:gluten, preference:plant_based) without revealing detailed dietary restrictions. Requires a linked HelloFood account with consent.

Draft dietary order instructions

Draft a restaurant order message that includes the user's dietary needs. Provide the restaurant_id, items to order, and optionally a recipient name and special instructions. The message is composed for the user to send to the restaurant. Requires a linked HelloFood account.

Recommend menu items

Get personalized menu item recommendations for a restaurant based on the user's dietary profile. Returns ranked items with safety scores and rationale. Recommends for the whole household by default when the account has synced members — items conflicting with any member's allergens are removed and listed in `excluded`, and surviving items carry per-member notes; pass household_scope only when the user explicitly named who this is for. Requires a linked HelloFood account.

Search nearby restaurants

Search for restaurants near a coarse city or neighborhood supplied by the user, or ChatGPT's optional coarse location hint. Returns restaurants ranked by dietary fit when the user has a linked HelloFood account. Pass city/neighborhood only; never pass a street address or precise GPS coordinates. Requires a linked HelloFood account.

Search for recipes

Search recipe providers for recipes that fit the linked user's dietary profile. Returns reusable recipe_ref values; pass one of those references to save_recipe when the user asks to keep a result. Searches for the whole household by default when the account has synced members (results carry a per-member match hint); pass household_scope only when the user explicitly named who this is for. Requires a linked HelloFood account.

Save a recipe

Save a recipe from search_recipes to the linked user's cookbook. First call with confirm=false to preview the recipe, then call with confirm=true only after the user explicitly asks to save it. Requires a linked HelloFood account.

List saved recipes

List recipes in the linked user's HelloFood cookbook. Use this when the user asks for saved recipes, bookmarks, or previously saved meal ideas. Requires a linked HelloFood account.

Answer a dietary question

Ask a dietary or nutrition question grounded in evidence from FDA, USDA, and clinical sources. Works without an account for general knowledge. With a linked HelloFood account, answers are personalized to the user's dietary profile. Examples: 'What are hidden sources of gluten?', 'Is tempeh high in histamine?', 'Can I eat grapefruit while on statins?'

Summarize dietary profile

Get a summary of the linked user's dietary setup: restrictions, preferences, avoid-ingredients, meal stats, rating count, and identified gaps. Covers the whole household by default when the account has synced members; pass household_scope only when the user explicitly asked about one person. Requires a linked HelloFood account.

Get meal history

Retrieve the linked user's meal history. Defaults to last 7 days. Supports windows: today, yesterday, last_7_days, last_30_days, or custom start_date/end_date (ISO format). Requires a linked HelloFood account.

Get food preferences

Get a summary of the linked user's food preferences: liked/disliked foods and frequently visited restaurants. Requires a linked HelloFood account.

Evaluate multiple menu items

Evaluate up to 15 menu items against the linked user's household dietary profiles in one call. Provide the restaurant_id (from lookup_restaurant) and a list of item names. Returns items categorized as generally_safer, risky, avoid, or unable_to_evaluate with confidence and allergen detail; each item's headline verdict is the household's worst case and member_annotations says which member drove it. Accounts with synced members are evaluated household-wide by default — pass household_scope only wh

Create a personalized recipe

Get a recipe suggestion optimized for the linked user's dietary constraints. Provide a recipe title and optionally specific ingredients or constraints. Returns ingredients, instructions, substitutions with explanations. Optimizes for the whole household by default when the account has synced members; pass household_scope only when the user explicitly named who this is for. Requires a linked HelloFood account.

Log a meal

Record what the user ate. Uses a two-phase confirmation protocol: first call with confirm=false to get a preview, then show the preview to the user and ask for confirmation. Only call with confirm=true after the user explicitly confirms. Pass household_scope with a member id to log the meal for that household member; otherwise it is recorded for the account owner. Requires a linked HelloFood account.