Skip to main content
The nutrition_catalog module provides tools to query public and company-defined food databases, retrieve macronutrients, search supplements and recipes, and manage company recipes and supplements. Nutrition catalog tools return a stable response shape across accounts, including item references, localized titles, nutrition values, allergens, and recipe metadata where available.

​
Available Tools

​
search_food_products

Search foods and groceries exclusively through Atlas Search. Results follow Search relevance; there is no regex or normal database-search fallback. A missing or unavailable Search index returns an error instead of an expensive scan.
  • Type: Read-only
  • Important Input Fields:
    • query (string, optional): Text query matching product names or ingredients, or a numeric barcode. Use at least 3 characters, except food terms such as ei or ui. Omit to browse through Atlas Search.
    • page (integer, optional): Page number.
    • limit (integer, optional): Items per page.

​
get_food_product

Retrieve detailed nutritional properties (calories, macros, micronutrients) for a specific food product.
  • Type: Read-only
  • Important Input Fields:
    • productId (string, required): Unique identifier of the product.

​
search_recipes

Search available recipes.
  • Type: Read-only
  • Important Input Fields:
    • query (string, required): Text search query.
    • page (integer, optional): Page number.
    • limit (integer, optional): Items per page.

​
get_recipe

Retrieve ingredients, preparation instructions, and macro profiles for a recipe.
  • Type: Read-only
  • Important Input Fields:
    • recipeId (string, required): Unique identifier of the recipe.

​
search_supplements

Search available supplements by name, brand, barcode, dose label, or active ingredient.
  • Type: Read-only
  • Important Input Fields:
    • query (string, optional): Text search query.
    • excludedAllergenKeys (array of strings, optional): Allergen keys to exclude.
    • page (integer, optional): Page number.
    • limit (integer, optional): Items per page.

​
get_supplement

Retrieve dose, active ingredient, usage, and macro details for a supplement.
  • Type: Read-only
  • Important Input Fields:
    • supplementId (string, required): Unique identifier from search_supplements.

​
create_supplement Write

Create a company-scoped supplement in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • name (string or localized object, required): Supplement name.
    • form (string, optional): Capsule, tablet, powder, liquid, or another supported form.
    • defaultDose (object, optional): Amount, unit, dose label, and timing hints.
    • activeIngredients (array, optional): Active ingredient names, amounts, and units.
    • nutritionPerDose (object, optional): Macro values per default dose.

​
update_supplement Write

Update a company-owned supplement in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • supplementId (string, required): Unique identifier of the supplement.
    • supplement fields (optional): Provide only the fields that should change.

​
archive_supplement Write

Archive a company-owned supplement in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • supplementId (string, required): Unique identifier of the supplement.

​
create_recipe Write

Create a new recipe in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • recipe fields (required): Name, ingredients, instructions, and nutrition fields.

​
update_recipe Write

Update an existing recipe in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • recipeId (string, required): Unique identifier of the recipe.
    • recipe fields (optional): Provide only the fields that should change.

​
archive_recipe Write

Archive or soft-delete an existing recipe in the nutrition catalog.
  • Type: Write
  • Important Input Fields:
    • recipeId (string, required): Unique identifier of the recipe.

​
Natural Language Examples

  • “Search the food catalog for whole milk.”
  • “Find vitamin D supplements available to this company.”
  • “Create a magnesium supplement with a default evening dose.”
  • “Find recipes containing quinoa.”
  • “Create a high-protein breakfast recipe for this company.”

​
JSON-RPC Call Example (search_food_products)