LockTrip - Hotels

Search Locations

Searches LockTrip destinations (cities, regions, landmarks, or specific hotels) by free-text `query`. Returns `locations[]`, each with `id`, `name`, `country`, `type` (CITY/REGION/HOTEL/AIRPORT/POI), and `fullName`. Pass a chosen location's `id` to `hotel_search` as its `regionId` to search hotels in that area. No authentication required. This is the first step of the booking flow.

Search Hotels

Starts an asynchronous hotel-availability search and returns a `searchKey` (plus `sessionId`, `status`, `totalHotels`). Required: `startDate` and `endDate` (both YYYY-MM-DD), `rooms[]` (each `{adults, childrenAges?[]}`, 1-4 adults per room), `nationality` (2-letter ISO country code), and EITHER `regionId` (from `search_location`) OR `latitude`+`longitude`; `currency` (3-letter) is strongly recommended. Before calling, collect the missing trip details from the user (exact check-in date, number of

Get Hotel Search Results

Returns the hotel results for a running search identified by `searchKey` (from `hotel_search`). Results stream in asynchronously, so POLL this tool until the returned `searchStatus` equals `COMPLETED` (it is `IN_PROGRESS` while results are still loading). Supports `page` (0-indexed on BOTH the request and the response echo — page 0 is the first page and comes back as page 0), `size` (use a large value like 5000 to get all), `filters` (minPrice/maxPrice/starRatings/amenities/mealTypes/hotelName),

Get Hotel Rooms

Lists the bookable room packages for one hotel. Required: `hotelId` (from `get_search_results`), the SAME `searchKey` from `hotel_search`, plus `startDate`, `endDate`, `rooms[]`, `nationality`, and `regionId` (re-supply the same values used in `hotel_search`); `currency` is recommended. Returns `packages[]`, each with a `quoteId` (the priced, bookable offer — format `packageId_hotelId`), a `packageId` (the same string as the `quoteId`; truncate it at the underscore before sending it to `check_ca

Check Cancellation Policy

Returns detailed cancellation terms for one or more room packages before booking. Required: `searchKey`, `hotelId`, and `packageIds[]` — pass the package UUID WITHOUT the `_hotelId` suffix, i.e. `quoteId.split('_')[0]`. Passing the full `quoteId` here fails with a misleading SESSION_EXPIRED even on a live session, because the policy lookup matches the bare UUID. Returns `policies[]`, each with `packageId`, `isRefundable`, `freeCancellationUntil`, and `fees[]` (`fromDate`, `amount`, `currency`).

Prepare Hotel Booking

Prepares a booking for a chosen room offer and returns the final price plus a `preparedBookingId` (also returned as the alias `bookingInternalId`). A prepared booking has NO fixed expiry — what expires is the search session behind its `quoteId`, which surfaces as "This booking is unavailable"; re-run `hotel_search` and re-quote if you see that. Required: `quoteId` (from `get_hotel_rooms`), `searchKey` (the SAME one from `hotel_search` — omitting it is a 400), `rooms[]` (each `{roomIndex (0-based

Confirm Hotel Booking

Confirms and finalizes a booking using a B2B credit line — PARTNER ACCOUNTS ONLY. Guests cannot use this; ordinary consumers must instead pay via `create_checkout` (recommended) or `get_payment_url`. Required: `bookingInternalId` and `quoteId` (both from `prepare_booking`); `paymentMethod` defaults to `CREDIT_LINE`. REQUIRES AUTHENTICATION via a partner account: if the connection is not already authorized via OAuth, first call `login` (email + password) — a `guest_login` session has no credit li

List My Bookings

Lists the authenticated user's existing bookings, filtered by `type`: `UPCOMING` (default), `COMPLETED`, `CANCELLED`, or `PENDING`. REQUIRES AUTHENTICATION with a registered account: if the connection is not already authorized via OAuth, first call `login` (email + password) — guest sessions from `guest_login` cannot list bookings — then pass the returned token as the `sessionToken` argument. Returns `bookings[]` (each with `bookingId`, `bookingReferenceId`, `hotelName`, `checkIn`, `checkOut`, `

Get Booking Details

Returns the full details of one existing booking: hotel, dates, rooms, guests, contact person, total price, payment status, and the cancellation policy (including any cancellation fees and the free-cancellation deadline). Required: `bookingId` (from `list_bookings`). REQUIRES AUTHENTICATION with a registered account: if the connection is not already authorized via OAuth, first call `login` (email + password) — guest sessions cannot view booking details — then pass the returned token as the `sess

Cancel Booking

Cancels an existing booking. Required: `bookingId` (from `list_bookings`) and the boolean `confirmed`; optional `reason`. This is a two-step safety flow: calling with `confirmed:false` does NOT cancel and returns only a 'not confirmed' acknowledgement (it does NOT return fees or refund amounts — read those first from `get_booking_details`); call again with `confirmed:true` to actually submit the cancellation. REQUIRES AUTHENTICATION with a registered account: if the connection is not already aut

Get Hotel Details

Fetches full descriptive details for one hotel: name, address, coordinates (lat/lng), star rating, description, phone, amenities, photos, and reviews. Required: the NUMERIC `hotelId` (the same hotel identifier returned in search results, passed as a number); optional `language`, `includeImages` (set true to fetch extra photos), and `imageLimit` (default 20, max 100). Returns a `hotel` object and optional `additionalImages`. No authentication required. Informational only — use it to enrich what y

Get Payment URL

Creates a hosted Stripe (credit-card) checkout link for a prepared booking — an alternative consumer payment rail to `create_checkout` (Revolut). Required: `bookingId` (the `preparedBookingId` from `prepare_booking`), `currency` (3-letter), and `backUrl`; optional `successUrl`. REQUIRES AUTHENTICATION WITH A REGISTERED ACCOUNT: call `login` (email + password) — a `guest_login` session is REJECTED here (the Stripe rail is not open to guests; use `create_checkout` for a guest instead) — then pass

Create Checkout

Creates a hosted Revolut payment link for a prepared booking — the RECOMMENDED way for ordinary consumers (no credit line) to pay. Required: `bookingId` (the `preparedBookingId` from `prepare_booking`) and `currency` (3-letter); optional `backUrl` and `successUrl`. REQUIRES AUTHENTICATION: if the connection is not already authorized via OAuth, first call `guest_login` (email only) or `login` (email + password), then pass the returned token as the `sessionToken` argument. Returns a `checkoutUrl`

Log In

Authenticates a registered LockTrip user (typically a B2B/partner account) with `email` and `password`, and returns a session `token` plus `userId`. Pass the returned `token` as the `sessionToken` argument on subsequent authenticated tools, OR rely on it being set as the connection's Bearer token. Use `login` when you need partner-only capabilities: B2B credit-line confirmation via `confirm_booking`, and listing/viewing/cancelling existing bookings (`list_bookings`, `get_booking_details`, `cance

Continue as Guest

Creates an anonymous guest session from an `email` ONLY (no password, no other user input) and returns a session `token` plus `userId`, `email`, and `isNewUser`; new emails also receive a verification email. Collect the customer's email from the user, then call this automatically whenever a booking tool needs authentication and you don't already have a token — NEVER ask the user to supply a token. Pass the returned `token` as the `sessionToken` argument to `prepare_booking`, `create_checkout`, a