Search teas.co.uk
find_productsUse this when someone wants to find, browse or choose tea, hot chocolate or other drinks to buy from teas.co.uk, a UK online tea shop. Not for general tea knowledge. query is the customer's own words; leave it out to browse by filters alone. Every filter given applies at once. max_price is per pack in pounds and max_price_per_cup_pence is per cup in pence. Results come best match first unless sort says otherwise. Out of stock products stay hidden unless include_out_of_stock is true. There is no paging: limit caps the list and total says how many matched, so narrow the filters to see others. If nothing matches, time_of_day, strength, format and with_milk are dropped in that order and note says which; kind, caffeine, labels, iced and price limits are never dropped. Prices are live and include VAT. Next: get_product for one product, compare_products to compare, add_to_basket to buy.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iced | No | Suits iced tea or cold brew. | |
| kind | No | Type of drink. | |
| sort | No | Order of results: best_match (the default), cheapest_per_cup, price_low_to_high, price_high_to_low or strongest. | |
| limit | No | How many products to return (default 6). | |
| query | No | What the customer wants in their own words, for example "strong breakfast tea", "Yorkshire Gold" or "something for bedtime". Leave out to browse with filters only. | |
| vegan | No | Only products labelled vegan. | |
| format | No | How it comes: tea_bags, loose_leaf, instant, pods_or_capsules, sachets, powder or ready_to_drink. | |
| organic | No | Only organic products. | |
| caffeine | No | Caffeine: caffeinated, decaf (caffeine taken out), caffeine_free (none to begin with, such as rooibos and most herbal teas) or low_or_none (decaf or caffeine free). | |
| strength | No | How strong the cup is: light, medium or strong. | |
| fairtrade | No | Only Fairtrade products. | |
| max_price | No | Highest pack price in pounds. | |
| with_milk | No | Only products that suit milk. | |
| time_of_day | No | When it suits best: morning, afternoon, evening or bedtime. | |
| include_out_of_stock | No | Also include products that are out of stock (they are left out by default). | |
| max_price_per_cup_pence | No | Highest price per cup in pence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Present when filters were left out: tell the customer, in your own words. | |
| total | Yes | How many products matched before the limit. | |
| filters | No | The filters that were applied. | |
| relaxed | No | Present when no product matched every filter: the filters left out to find these. | |
| products | Yes |