Deals near a place in Singapore
nearby_promotionsFind current promotions closest to a location in Singapore, nearest first, with distance in km. Use when someone asks 'deals near me', 'promotions around Tampines' (pass area: 'Tampines', or coordinates). Pass life_stage / age_range / budget / interests when you know them, e.g. a student near NUS: area 'NUS', life_stage 'student', budget 'low' -> cheap food nearby first.
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": "nearby_promotions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude, e.g. 1.3521 (or give area instead). | |
| lng | No | Longitude, e.g. 103.8198 | |
| 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. | |
| radius_km | No | Search radius in km. | |
| 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). | |
| include_all_outlets | No | Also return island-wide deals valid at all outlets (marked all_outlets_match), after the nearby ones. |