Connection check
verified live · 20h ago
getmyhotels
Search hotels, get live prices, and check out in chat. Guest search needs no sign-in.
Tools
18
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
18 toolsRead from the running server on 20h ago.
add_trip_item
day*type*title*sortOrderdescriptionitineraryPublicId*
Add an item (hotel, flight, activity, etc.) to a saved trip on a given day. Add an item (hotel, flight, activity, etc.) to a saved trip on a given day.
cancel_booking
can modify data
reasonpublicId*verificationCode*
Cancel one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. This may be irreversible and can trigger a refund per polic… Cancel one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. This may be irreversible and can trigger a refund per policy.
create_checkout
can modify data
refprice*roomsadultscheckIn*checkOut*
+8
Create a secure checkout for a chosen hotel room and return a getmyhotels.com URL where the guest completes payment. This does NOT charge the card — the guest pays on the hosted pa… Create a secure checkout for a chosen hotel room and return a getmyhotels.com URL where the guest completes payment. This does NOT charge the card — the guest pays on the hosted page. Confirm the hotel, room, dates, and price with the user before calling. Call `get_checkout_quote` first to confirm the live price.
create_one_click_checkout
can modify data
refprice*roomsadultscheckIn*checkOut*
+8
Create a checkout for the signed-in user with a saved card pre-selected, and return a getmyhotels.com URL where they confirm + pay in one click. Does NOT charge the card — the user… Create a checkout for the signed-in user with a saved card pre-selected, and return a getmyhotels.com URL where they confirm + pay in one click. Does NOT charge the card — the user confirms on the hosted page. Get the `savedPaymentMethodPublicId` from `list_payment_methods`. Confirm the hotel, room, dates, and price with the user first.
fetch
read-only
id*
Fetch the full record for a result id returned by `search` (a hotel) or for a booking reference (prefixed 'bk_'). Returns a document with id, title, text, url, and metadata. Fetch the full record for a result id returned by `search` (a hotel) or for a booking reference (prefixed 'bk_'). Returns a document with id, title, text, url, and metadata.
get_booking
read-only
bookingToken*
Look up a hotel booking by its management token (sent in the confirmation email). Returns the booking status, hotel, dates, and guest details. Look up a hotel booking by its management token (sent in the confirmation email). Returns the booking status, hotel, dates, and guest details.
get_checkout_quote
read-only
refroomsadultscheckIn*checkOut*children
+7
Re-price a specific room live against the supplier before checkout (no booking, no charge). Use the `supplierRoomId` and price/currency from `search_hotels`. Returns the authoritat… Re-price a specific room live against the supplier before checkout (no booking, no charge). Use the `supplierRoomId` and price/currency from `search_hotels`. Returns the authoritative grand total, a `rateValidUntil` timestamp, and any taxes/fees.
get_hotel_details
read-only
refsupplierCodesupplierHotelId
Get full property details (description, amenities, photos, policies, location) for a hotel, identified by its `ref` from `search_hotels` (or its supplierCode + supplierHotelId). Get full property details (description, amenities, photos, policies, location) for a hotel, identified by its `ref` from `search_hotels` (or its supplierCode + supplierHotelId).
get_my_booking
read-only
publicId*
Get full details of one of the signed-in user's bookings by its public id. Get full details of one of the signed-in user's bookings by its public id.
get_rooms
read-only
refroomsadultscheckIn*checkOut*children
+2
List the bookable rooms for ONE hotel and date range. Each room's `supplierRoomId` is what you pass to `get_checkout_quote` / `create_checkout`. Use the hotel `ref` from `search_ho… List the bookable rooms for ONE hotel and date range. Each room's `supplierRoomId` is what you pass to `get_checkout_quote` / `create_checkout`. Use the hotel `ref` from `search_hotels` or `search`. Call this to see all of a chosen hotel's rooms, or to refresh availability before checkout.
list_my_bookings
read-only
pagelimit
List the signed-in user's hotel bookings. List the signed-in user's hotel bookings.
list_payment_methods
read-only
List the signed-in user's saved payment cards (brand, last 4, expiry, default). Use the returned `publicId` with `create_one_click_checkout` to pre-select a card. List the signed-in user's saved payment cards (brand, last 4, expiry, default). Use the returned `publicId` with `create_one_click_checkout` to pre-select a card.
list_trips
read-only
List the signed-in user's saved trips (itineraries). List the signed-in user's saved trips (itineraries).
modify_booking
can modify data
checkIncheckOutpublicId*specialRequestsverificationCode*
Change one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. Special-request edits always apply. A DATE change is pushed… Change one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. Special-request edits always apply. A DATE change is pushed to the hotel supplier as a cancel-and-rebook at current availability, so it only works for suppliers that support amendment — for others (and when no room is available for the new dates) it returns an error asking you to cancel and rebook instead. A date change can shift the price and issue a new confirmation; the result's `supplierModifyStatus` says whether the supplier reservation was actually changed (`modified`), simulated (`simulated`), or the edit stayed local (`local_only`, e.g. special requests only). Never promise a date change went through unless `supplierModifyStatus` is `modified` or `simulated`.
request_booking_action_code
action*publicId*
Email a 6-digit verification code to the booking owner, required before cancelling or modifying a booking. Step 1 of 2 — then call `cancel_booking`/`modify_booking` with the code. Email a 6-digit verification code to the booking owner, required before cancelling or modifying a booking. Step 1 of 2 — then call `cancel_booking`/`modify_booking` with the code.
save_trip
title*budgetendDate*startDate*descriptionbudgetCurrency
Create a new saved trip (itinerary) for the signed-in user. Create a new saved trip (itinerary) for the signed-in user.
search
read-only
query*roomsadultscheckIncheckOutchildren
+4
Search GetMyHotels for hotels matching a query. Returns a list of results with ids that can be passed to `fetch` for full details. Provide the destination and travel dates in the q… Search GetMyHotels for hotels matching a query. Returns a list of results with ids that can be passed to `fetch` for full details. Provide the destination and travel dates in the query.
search_hotels
read-only
roomsadultscheckIn*checkOut*childrenkeywords
+3