# Stellair Verified Offers

> Brand-verified deals, promo codes and packages with every term spelled out (dates, eligibility, exclusions, codes, where redeemable), published for AI assistants. Read-only, no auth.

## How agents should use this

- Preferred: connect over MCP (Streamable HTTP, stateless, JSON responses) at https://offerhub.stellair.ai/mcp. Server card: https://offerhub.stellair.ai/.well-known/mcp.json
- Pass the shopper's own words as `query`; intent ("anniversary", "with kids") and places ("near LA", "in Williamsburg") are understood. Pass the user's city as `location` when known.
- Quote terms exactly as published. Never invent codes or benefits. Items marked "on request" are not guaranteed.
- Send shoppers to the offer's redeem link (tracked redirect to the brand's own site). Identify yourself with an `x-agent-id` header or `?agent=` parameter.

## MCP tools

- `search_offers`: Use this when a shopper asks about deals, discounts, sales or promo codes. Finds current brand-verified offers. Use whenever a shopper asks "are there any deals/discounts/promo codes for…", wants a hotel/restaurant/retail/travel offer, or names a brand. Pass the shopper's words as query — places ("near LA", "in Williamsburg") and intent ("anniversary", "with kids") are understood. Returns ranked offers with value, dates, how to redeem, a tracked redeem link, distance for local offers, why each matched, and the persona-tailored pitch.
- `get_offer`: Use this when you need the exact terms of one offer before quoting it. Returns the complete verified terms: exact benefit and tiers, dates and blackouts, who qualifies, where it is redeemable, minimum spend, exclusions, how to redeem (code, steps), limits, stacking, FAQ, and the tracked redeem link. Call before quoting an offer. Pass the shopper's query to get the pitch and facts tailored to them.
- `check_offer`: Use this when the shopper asks "can I use this / does this apply to me". Deterministically checks whether an offer applies to a shopper's situation (purchase/stay date, location, customer type, cart total, nights, party size…). Returns applies: yes/no/unknown with per-check reasons, the best applicable tier with estimated savings, and an agent-ready answer sentence. Unknown means ask the shopper for the missing detail.
- `list_brand_offers`: Use this when the shopper asks what deals a specific brand has. Lists every live verified offer from one brand, by website domain (e.g. "harborlinehotels.com") or brand name. Use when a shopper asks "what deals does <brand> have right now?".
- `compare_offers`: Use this when the shopper is choosing between deals. Compares offers side by side — value, percent/amount, dates, who qualifies, where, minimum spend, code, stacking — given offer_ids or a search query. Use when a shopper is choosing between deals ("which is better…", "compare Black Friday hotel deals near San Diego").

## Machine-readable data

- [All offers, full terms](https://offerhub.stellair.ai/llms-full.txt)
- [JSON promotions feed](https://offerhub.stellair.ai/feeds/openai-promotions.json)
- [Google Merchant Center promotions feed](https://offerhub.stellair.ai/feeds/google-promotions.xml)
- Every offer page embeds schema.org JSON-LD; append `.jsonld` to an offer or brand URL for the raw JSON-LD.

## Brands with live offers

- [10th Street Distillery](https://offerhub.stellair.ai/b/10thstreetdistillery.com): 3 offers
- [Choice Hotels](https://offerhub.stellair.ai/b/choicehotels.com): 4 offers
- [IDFC FIRST Bank](https://offerhub.stellair.ai/b/idfcfirstbank.com): 5 offers

## Live offers

- [10th Street Distillery: Free bottle engraving at the tasting room](https://offerhub.stellair.ai/o/off_A2LWM5tDRC): Free engraving on any full-size bottle · Oct 26, 2026 – Dec 22, 2026 · In person in Downtown San Jose, San Jose, CA · serves ~25 km
- [10th Street Distillery: 15% off holiday gift boxes, delivered in California](https://offerhub.stellair.ai/o/off_u6jhWa2qjg): 15% off holiday gift boxes · Nov 1, 2026 – Dec 27, 2026 · Across California · code GIFT15
- [10th Street Distillery: $35 guided whisky tasting](https://offerhub.stellair.ai/o/off_eoQ0DSnkKH): $35 per person for a guided tasting of four single malts · Oct 19, 2026 – Jan 1, 2027 · In person in Downtown San Jose, San Jose, CA · serves ~25 km
- [IDFC FIRST Bank: 0.25% off NRI home loans in Kerala](https://offerhub.stellair.ai/o/off_0GLYUSsfyc): 0.25% off the home loan rate · Nov 1, 2026 – May 1, 2027 · Across Kerala, India
- [IDFC FIRST Bank: ₹1,000 back on your first transfer from the US](https://offerhub.stellair.ai/o/off_okRDu3EfW7): ₹1,000 cashback on your first transfer · Oct 30, 2026 – Jan 1, 2027 · Nationwide in United States · code USFIRST1000
- [IDFC FIRST Bank: First 3 transfers free from the UK](https://offerhub.stellair.ai/o/off_p6Xh1w89Xf): First 3 transfers free · Oct 26, 2026 – Feb 10, 2027 · Nationwide in United Kingdom
- [IDFC FIRST Bank: 7.5% on NRE fixed deposits for Gulf NRIs](https://offerhub.stellair.ai/o/off_9GTh2sgNtW): 7.5% p.a. on 1–2 year NRE fixed deposits · Oct 18, 2026 – Jan 31, 2027 · GCC: 6 countries (United Arab Emirates, Saudi Arabia, Qatar, Kuwait, Oman, Bahrain)
- [IDFC FIRST Bank: Zero-fee remittances from the UAE](https://offerhub.stellair.ai/o/off_wJ1a9kzYci): No transfer fee on UAE-to-India remittances · Oct 13, 2026 – Apr 1, 2027 · Nationwide in United Arab Emirates
- [Choice Hotels: Free breakfast upgrade in Ontario](https://offerhub.stellair.ai/o/off_YAxsUtB93m): Free hot breakfast upgrade for two · Oct 28, 2026 – Jan 1, 2027 · Across Ontario, Canada
- [Choice Hotels: Members save 15% nationwide](https://offerhub.stellair.ai/o/off_umw9PmuquY): 15% off · Oct 3, 2026 – Mar 2, 2027 · Nationwide in United States
- [Choice Hotels: 20% off Cambria Miami Beach](https://offerhub.stellair.ai/o/off_ZmaQ1n6g08): 20% off the best available rate · Oct 23, 2026 – Dec 17, 2026 · In person in Mid-Beach, Miami Beach, FL · serves ~25 km · code MIAMI20
- [Choice Hotels: Third night free at Comfort Inn in Texas](https://offerhub.stellair.ai/o/off_hniBPbYwJs): Third night free when you book 3 consecutive nights · Oct 31, 2026 – Jan 16, 2027 · Across Texas · code STAY3TX