Find cheaper swaps
find_swapsRead-onlyIdempotent
For the items of a shopping list, finds products that do the same job for less: a bigger pack that costs less per kilogram, litre or piece, or another brand of the same kind of product. Each swap says how much cheaper it is per unit and what it saves on the item's quantity.
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": {
"country": "<country>",
"items": "<items>"
},
"name": "find_swaps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of texts and amounts in the answer, as a BCP 47 tag (en, ru, uz, uz-Cyrl, kk, es, …). Default: the assistant's locale, else the country's main language. | |
| items | Yes | The shopping list (1 to 60 items). | |
| country | Yes | The country whose stores to read: UZ (Uzbekistan), KZ (Kazakhstan), RU (Russia), US (United States), GB or UK (United Kingdom). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| swaps | Yes | ||
| country | Yes | ||
| currency | Yes |