Stay

Stay Booking MCP

Let an agent do the searching, comparing and form filling. The traveller reviews the live total and approves payment.

Stay gives agents structured hotel tools instead of asking them to drive a booking site. An agent can find a room, recheck its live price and prepare the traveller details already saved in Stay. It then returns a secure checkout link. The traveller still reviews the total, cancellation terms and payment before the booking is placed.

Hosted Streamable HTTP

https://www.joinstay.co/api/mcp

Create a revocable key under Your profile → Connections, then send it as an Authorization: Bearer header. Each key exposes only the tools you selected and expires automatically.

Agent-safe booking flow

  1. 1. Search and compare live hotel rates.
  2. 2. Recheck the selected offer and create a short-lived quote.
  3. 3. Fill saved traveller details without returning them to the agent.
  4. 4. Open Stay's secure checkout for the traveller to review and approve.

Live API routes (MCP-ready)

  • GET /api/stay/search — Pareto-ranked search with trip anchors
  • GET /api/stay/hotel/[id] — property + loyalty-adjusted verdict
  • GET /api/stay/neighbourhood/[id] — personalized map layer
  • POST /api/stay/compare — cross-property effective value
  • GET /api/stay/loyalty — wallet programmes
  • GET /api/stay/profile / trips — account reads
  • GET /api/stay/rates — Cheapest / Recommended / Best tiers
  • POST /api/bookings/quote + stay/book — live quote then secure payment handoff
  • GET /api/stay/best-deal — cross-supplier effective value
  • POST /api/stay/plan-rooms — group room split
  • GET /api/stay/quote-cancellation — cancellation quote before book
  • POST /api/stay/rebook — atomic rate-drop rebook
  • POST /api/bookings/[id]/message — property preference requests

Stay never sends card details to an agent. Nuitée remains the merchant of record and processes the hotel payment. Apple Pay or Google Pay can shorten the approval step when available on the traveller's device.

A local stdio bridge remains available at packages/stay-mcp. Contact support if your agent host needs a different transport.