LUXSKI
For partners, search and assistants
This page lists stable entry points for SEO, analytics, and AI clients. Prefer linking to HTML where travelers book; use JSON and MCP when you need machine-readable context.
Primary traveler URLs
- https://www.lux.ski/hotels — collection; includes best-deals and last-minute getaways (anchor
#last-minute-getaways). - https://www.lux.ski/destinations — resort guides and SnowSure™ context.
REST API for assistants (GET, JSON)
Stable catalog and snow context — no API key required. Documented in openapi.json.
- Base — https://www.lux.ski/api/gpt (
/destinations,/destination/{slug},/hotels,/search,/recommendations). - Resolve resort names via
/search?q=…then fetch/destination/{slug}for curated hotels. Slug aliases (e.g.zermatt→matterhorn-ski-paradise) are supported on the destination endpoint.
Live pricing (GET, JSON)
- Last-minute SERP deals — https://www.lux.ski/api/last-minute-deals. Query params include
limit,nights,leadMinDays,leadMaxDays,strategy,scanSamples,regionSlug,resortSlug,sort(price | smart), optional date overrides. See route comments in the repo for full detail. Human-facing copy lives at www.lux.ski/hotels#last-minute-getaways. - Best deals (default date range) — https://www.lux.ski/api/best-deals.
Prices are live RateHawk totals, not a hold. Confirm on the hotel page or with concierge@lux.ski before quoting as final.
Official MCP (Model Context Protocol)
Streamable HTTP endpoint for assistants (Cursor, Claude Desktop, etc.):
Server clients must send Accept: application/json, text/event-stream. Stateless single-POST is supported (no session handshake). Dated REST fallback: GET /api/hotel/{slug}/price.
Tools include search_hotels, get_hotel_details, check_availability (dated rates by hotel name), get_last_minute_deals, and snow/destination lookups. Discovery: www.lux.ski/.well-known/mcp.json.
Local CLI for Cursor / Claude Desktop: npx luxski-mcp (npm).
Discovery files
- www.lux.ski/llms.txt — compact guide for LLM crawlers
- www.lux.ski/llms-full.txt — extended version with embedded live data
- www.lux.ski/openapi.json — OpenAPI 3.1 for
/api/gpt - www.lux.ski/agents.json — agent manifest (tools, resources, policies)
Integration support
Server-side partners (e.g. SnowSure concierge): prefer REST for catalog and deals; use MCP for dated per-hotel availability. Do not scrape HTML — use url and hotelUrl fields from API responses for booking links.
Questions: hello@luxski.com (technical), concierge@lux.ski (rates & bookings).
