Singapore deals for AI agents
Let your assistant answer “any 1-for-1 near Orchard tonight?” with live data. Everything is free, read-only and needs no login or key. Please show people the deal's url so they can check the terms.
Connect the MCP server
Server URL (Streamable HTTP): https://spill.sg/mcp
- Claude (claude.ai or desktop): Settings → Connectors → Add custom connector → paste the URL.
- ChatGPT: Settings → Apps → Advanced → Developer mode → Create app → paste the URL, no authentication.
- Claude Code:
claude mcp add --transport http sg-deals https://spill.sg/mcp - Cursor, VS Code and others:
{
"mcpServers": {
"sg-deals": {
"url": "https://spill.sg/mcp"
}
}
}Tools
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.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 that area's coordinates). Only deals with a mapped outlet are returned.recommend_promotionsGiven promotion ids someone liked or saved, return other current deals they may like (same brand, same kind of food or shop, nearby, similar offer), each with a short reason.get_promotionFull details of one promotion by its id (from a search result): dates, conditions, outlets, source link, and links to add it to a calendar or save it with a start reminder. Pass lat/lng to sort outlets nearest first and get nearest_outlet.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?'.list_brandsList brands that have at least one current promotion in Singapore, with how many each has.
Every deal comes with links: the page, Markdown and JSON copies, a calendar file, and save_and_remind, a link that saves the deal in our app and reminds the person when it starts.
Other ways in
- JSON API: /api/v1/promotions (filters: q, category, brand, deal_type, status, near=lat,lng, intent, when, sort…) · OpenAPI spec
- Each deal:
/p/<id>(HTML),/p/<id>.md,/p/<id>.json, or/p/<id>withAccept: text/markdown/application/json - llms.txt (index) · llms-full.txt (every current deal in one file) · RSS · MCP server card
- Pages carry schema.org Offer and ItemList data and work without JavaScript.
Fair use
Up to 120 requests a minute per caller (HTTP 429 with Retry-After beyond that). Dates are Singapore time (UTC+8); data is refreshed every day and each deal has updated_at, promo_url and confidence. We log which tools are called and which deals are returned, never your conversation.