Deals picked for this person
recommend_promotionsPersonal picks of current Singapore deals. Use for 'what deals would suit me?', 'any good deals for a student near NUS?', 'deals for my family this weekend', 'I'm visiting Singapore 3-7 Dec, staying near Bugis'. Pass what you already know from the conversation: who they are (life_stage, age_range), budget, interests, categories to skip, where they are (area or lat/lng), and/or ids of deals they liked. Each result has a short reason. Nothing is stored and no login is needed; don't ask the person questions only to fill these in.
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": "recommend_promotions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Optional: where they are (latitude), to rank nearby deals higher. | |
| lng | No | Optional: longitude, with lat. | |
| area | No | Instead of lat/lng: an MRT area, mall or campus name, e.g. 'Tampines', 'Orchard', 'Jewel', 'NUS', 'NTU', 'SMU', 'Ngee Ann Poly'. Unknown names return an error; then pass lat/lng. | |
| when | No | Only deals usable then, Singapore time, reading each deal's hours (e.g. 'Weekdays 3pm-5pm'). 'dinner tonight' = intent dinner + when tonight. | |
| limit | No | How many suggestions to return (1-30). | |
| budget | No | Optional: low = around S$10 or less, freebies and 1-for-1s first; mid = everyday; high = treats (buffets, staycations) are fine. | |
| intent | No | What the person wants: breakfast, lunch, dinner, coffee (coffee, bubble tea, desserts), drinks, shopping, fun, money (cards & banks). | |
| category | No | Kind of deal. | |
| trip_end | No | Optional YYYY-MM-DD: last day of the visit (with trip_start). | |
| active_on | No | Only deals valid on this Singapore date (YYYY-MM-DD). | |
| 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. | |
| liked_ids | No | Optional: ids of deals they liked or saved (from search results); finds similar ones. | |
| radius_km | No | Optional, with a place: only deals within this many km (island-wide 'all outlets' deals still count). | |
| 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. |