> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Nutrition Catalog

> Reference for searching foods, supplements, ingredients, and recipes.

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.

| Key | Value |
| :- | :- |
| **Module Key** | `nutrition_catalog` |
| **Sensitivity** | `operational` |
| **Consent Required** | None |

***

## 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`)

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "nut-cat-1",
  "method": "tools/call",
  "params": {
    "name": "search_food_products",
    "arguments": {
      "query": "Avocado"
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.