Add a supply item
inventory_addCreate a new supply item for a shared flat when a product is not tracked yet; starting stock at or below its threshold automatically adds it to the shopping list.
Instructions
Creates a new supply item in the flat. Use it only for a product that is not tracked yet; to change stock of an existing item use inventory_consume or inventory_update. Item names are unique per flat, ignoring case and surrounding spaces; a taken name fails with 409 inventory_item_duplicate. If the starting quantity is already <= threshold (which the defaults give), the item is put on the shopping list automatically. Returns the created item.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "inventory_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Display name of the product, for example "Toilet paper". Must be new in the flat. | |
| unit | No | Unit of measure for quantity and threshold. Defaults to piece. | piece |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| category | No | Category used to group the item. Defaults to other. | other |
| quantity | No | Current stock in the chosen unit. Defaults to 0. | |
| threshold | No | Low-stock limit in the chosen unit: at or below this quantity the item counts as low and goes on the shopping list. Defaults to 1. |