Add a shopping item
shopping_addAdd an item to a flat’s shared shopping list with an optional quantity and notify other members, keeping household purchases coordinated.
Instructions
Add one item to the flat's shared shopping list, optionally with a quantity. Use it when something needs to be bought; to tick off an existing item use shopping_set_bought, and to track household stock use inventory_add. Every other member gets a notification (a system notice and a push; the caller is excluded). Fails with 409 shopping_item_duplicate when an open item with the same name already exists, so read shopping_list first instead of retrying. Rate limited per member (too_many_requests with retry_after_s). 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": "shopping_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Item name as shown on the list, for example "Oat milk". Compared to open items to detect duplicates. | |
| bought | No | Set true to record an item that was already bought, so it lands directly in the bought history. Leave false for something still to buy. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| quantity | No | Free-text amount shown next to the name, for example "2" or "1 kg". Omit when no amount is needed. |