> ## 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, ingredients, and recipes.

The `nutrition_catalog` module provides tools to query public and
company-defined food databases, retrieve macronutrients, search recipes, and
manage recipes.

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

***

## Available Tools

### `search_food_products`

Query the nutrition product database for foods and groceries.

* **Type:** Read-only
* **Important Input Fields:**
  * `query` (string, required): Text query matching product names or ingredients.
  * `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.

### `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 depend on the active nutrition schema.

### `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 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"
    }
  }
}
```