Ready-made deal lists
get_deal_listA curated list of current Singapore deals: ending-soon (last chance), starting-soon, 1-for-1, free (freebies), birthday (birthday treats), students. Use for questions like 'what deals end this week?' or 'any freebies today?'.
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": {
"list": "<list>"
},
"name": "get_deal_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | Yes | Which list, e.g. ending-soon, 1-for-1 or free. Each list is also a web page at https://spill.sg/deals/<list> (the result's url). | |
| limit | No | How many deals to return (1-50). | |
| budget | No | Optional: low = around S$10 or less, freebies and 1-for-1s first; mid = everyday; high = treats (buffets, staycations) are fine. | |
| trip_end | No | Optional YYYY-MM-DD: last day of the visit (with trip_start). | |
| age_range | No | Optional: the person's age range, if known. Used only when life_stage is not given (18_24 leans student, 55_plus leans senior); under_18 also sinks alcohol deals. Not stored. | |
| interests | No | Optional: what they like. Category keys (food, grocery, shopping, fashion, beauty, health, electronics, home, entertainment, travel, finance, insurance, telco, car, property, education) or finer words (bubble_tea, coffee, desserts, fast_food, buffet, korean, japanese, drinks, movies, kids, fitness, staycation, gadgets). Matching deals rank first. | |
| life_stage | No | Optional: who the deals are for, if you already know it from the conversation (never ask just for this). student, working, family (parents with kids), senior, tourist (visiting Singapore). Ranks fitting deals first, e.g. student = cheap food, bubble tea, student discounts first; hotels, cards and insurance later. tourist = deals a visitor can use (no Singapore bank card, residency or local scheme needed) first, attractions and Changi Airport deals up, and each deal gets tourist_fit {usable: yes|maybe|no, needs}. Not stored. | |
| trip_start | No | Optional YYYY-MM-DD (Singapore): first day of a visit or of the dates they care about. With trip_end, only deals valid on at least one of those days are returned. | |
| exclude_categories | No | Optional: categories to leave out entirely, e.g. ['travel', 'property'] for someone who said hotels don't interest them. |