# LUXSKI Agent Quickstart

> Connect an AI agent to **175+ curated luxury ski hotels** with live RateHawk pricing and checkout handoff.

## 1. Connect (30 seconds)

- **MCP HTTP endpoint:** `https://www.lux.ski/api/mcp`
- **Transport:** Streamable HTTP (MCP 2025-03-26)
- **Authentication:** None (public tier: 60 req/min per IP)
- **Partner keys:** `Authorization: Bearer lux_mcp_…` or `x-luxski-api-key` — contact hello@luxski.com

**npm CLI (stdio):** `npx luxski-mcp` — proxies to the hosted endpoint for Claude Desktop / Cursor.

## 2. Discover resources

| Resource | URL |
|----------|-----|
| MCP manifest | https://www.lux.ski/.well-known/mcp.json |
| ARD catalog | https://www.lux.ski/.well-known/ai-catalog.json |
| OpenAPI | https://www.lux.ski/openapi.json |
| agents.json | https://www.lux.ski/agents.json |
| llms.txt | https://www.lux.ski/llms.txt |
| Plan-ski-trip skill | https://www.lux.ski/.well-known/skills/plan-ski-trip |
| A2A agent card | https://www.lux.ski/.well-known/agents/ski-concierge |

## 3. Book in three tool calls

1. **Quote** — `get_rates` with `hotelName`, `checkIn`, `checkOut`, `adults`
   - Returns `rateId` (book_hash) per room option
2. **Hold** — `create_booking_session` with `rateId`, hotel, dates
   - Returns `checkoutUrl` (30-minute TTL)
3. **Confirm** — send the traveler the `checkoutUrl`; poll `get_booking_status`

**REST equivalent:** `POST https://www.lux.ski/api/book/sessions`

## Key tools

| Tool | Purpose |
|------|---------|
| `search_hotels` / `ai_hotel_search` | Find properties by resort, stars, style |
| `get_rates` | Live SERP totals + rateId |
| `get_last_minute_deals` | Short lead-in deals (optional `resort` / `regionSlug`) |
| `create_booking_session` | Prebook + checkout link |
| `get_booking_status` | Session / completed booking lookup |
| `get_snow_report` | SnowSure™ scores (secondary trip context) |
| `request_concierge` | Human advisor for complex itineraries |

## Pricing disclaimer

Live totals are **indicative RateHawk SERP prices**, not a hold. Travelers confirm on lux.ski checkout or via concierge@lux.ski.

## Human fallback

Free concierge: https://www.lux.ski/plan-your-trip · concierge@lux.ski

## Support

Developers: https://www.lux.ski/developers · Partners: https://www.lux.ski/for-partners