reduce_pantry_amount
Adjust pantry item stock by a specified amount. Automatically add to shopping list when stock falls below the minimum threshold.
Instructions
Change the stock of an existing pantry item by a delta. Mutates state and returns the updated ArticleDto. If autoRestock is true and the new amount lands at or below the item's minimumAmount, the item is also added to the shopping list in the same call. Use add_pantry_item to create a new pantry entry; use update_pantry_item for metadata (name / unit / category) — this tool only touches stock.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| itemId | Yes | Item uuid (from `list_pantry_items[].uuid`). Item must already exist in the pantry — this tool does not create. | |
| amountChange | Yes | Delta added to the current `amount` — negative consumes stock, positive restocks. Despite the tool name, positive values work for restocking too. | |
| autoRestock | No | If true and the resulting amount drops to or below the item's `minimumAmount` (with `manageMinimumAmount` enabled), the item is also added to the shopping list in the same call. Defaults to false so reads stay quiet. | |
| listId | No | List UUID — call `list_lists` to discover one. Optional only in stdio mode (falls back to the PANTRIST_LIST_ID env var); required explicitly in HTTP mode. |