add_pantry_item
Add an item to your pantry by name. Reuses existing articles when possible or creates a new one automatically.
Instructions
Add a new item to the pantry by name. The API matches name against the user's article catalog: an existing article is reused (its category, unit, price history preserved); a new article is created on first use. Returns the resulting ArticleDto. Use reduce_pantry_amount to change stock on an item already in the pantry; use update_pantry_item to rename or change unit / category; use add_shopping_item to put it on the shopping list instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Item name, e.g. "Milk". Matched case-insensitively against the article catalog; matches reuse the existing article. | |
| amount | No | Initial stock amount. Defaults to 1 if omitted (server-applied). | |
| unitId | No | Unit id, e.g. "pieces", "g", "ml", "l". Defaults to "pieces" if omitted (server-applied). Discover supported ids by inspecting any existing pantry item's `unitId`. | |
| 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. |