Search Singapore deals
search_promotionsFind current promotions in Singapore (1-for-1s, discounts, freebies, cashback). Use when someone asks 'any deals on X?', 'what's on promotion this weekend?', or about a brand. Returns deals that have not ended, with dates in Singapore time, conditions and the original source link. If you already know who the person is (student, working adult, parent, senior, visitor, rough age, budget, what they like or don't), pass life_stage / age_range / budget / interests / exclude_categories so the best fits come first, each with a short reason; nothing is stored. Don't ask the person just 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": "search_promotions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Optional latitude, to rank nearby deals higher (with lng). | |
| 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. | |
| sort | No | newest (default) = latest announced first. top = best picks: fits the meal, ends soon, has a photo, nearby. for_you = top picks that also fit life_stage / age_range / budget / interests (the default when any of those is given). | |
| when | No | Only deals usable then, Singapore time, reading each deal's hours (e.g. 'Weekdays 3pm-5pm'). 'dinner tonight' = intent dinner + when tonight. | |
| brand | No | Brand name or slug, e.g. 'McDonald's'. | |
| limit | No | How many deals to return (1-50). | |
| query | No | Words to match in brand, deal title, summary or outlet, e.g. 'bubble tea' or 'Jewel'. | |
| 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). | |
| status | No | live = on now, ends_today, starting_soon = within 7 days. | |
| 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. | |
| deal_type | No | e.g. one_for_one for 1-for-1 deals. | |
| 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. | |
| eligibility | No | Only deals limited to this group, e.g. student for student-only deals. | |
| exclude_categories | No | Optional: categories to leave out entirely, e.g. ['travel', 'property'] for someone who said hotels don't interest them. | |
| exclude_eligibility | No | Leave out deals limited to these groups, e.g. ['student'] for someone who is not a student. Each deal's `eligibility` lists its groups (empty = anyone). |