MCP docs · ATAbooking

Search stays

01 / 05 · search_stays

Find hotels with a room free for the dates and guests. Returns each stay's cheapest fitting room with a quote (price, ATA fee 5%, typical 15-20% OTA cut). Demo hotels are marked demo: true.

Input	Type	Notes
placeRequired string	string	City, area, country or hotel name, e.g. 'Bangkok' or 'Gamla Stan'. up to 120 characters
check_inRequired date	date	Arrival date, YYYY-MM-DD
check_outRequired date	date	Departure date, YYYY-MM-DD
guestsRequired integer	integer	Number of guests in one room. 1–10
max_price_per_night number	number	Budget per night in the hotel's currency (EUR in the demo)
wants list of string	list of string	Nice-to-haves, e.g. ['pool','beach','quiet']; ranks matches first

search_staysExample

search_stays({
  place: "Bangkok",
  check_in: "2026-12-12",
  check_out: "2026-12-15",
  guests: 2
})

Get stay details

02 / 05 · get_stay

Rooms, prices, what's included, check-in/out times and cancellation terms for one stay. Demo hotels are marked demo: true.

Input	Type	Notes
stay_idRequired string	string	stay_id from search_stays. up to 100 characters
check_in date	date	Optional: with check_out, adds availability and a quote per room. YYYY-MM-DD
check_out date	date	Optional: with check_out, adds availability and a quote per room. YYYY-MM-DD
guests integer	integer	1–10

get_stayExample

get_stay({
  stay_id: "<stay_id from search_stays>"
})

Check availability

03 / 05 · check_availability

Re-check one room for exact dates and guests right before booking. Returns available yes/no and the live quote. Demo hotels are marked demo: true.

Input	Type	Notes
stay_idRequired string	string	up to 100 characters
room_idRequired string	string	up to 100 characters
check_inRequired date	date	YYYY-MM-DD
check_outRequired date	date	YYYY-MM-DD
guestsRequired integer	integer	1–10

check_availabilityExample

check_availability({
  stay_id: "<stay_id from search_stays>",
  room_id: "<room_id from get_stay>",
  check_in: "2026-12-12",
  check_out: "2026-12-15",
  guests: 2
})

Book direct with the hotel

04 / 05 · book_direct

Places a 15-minute HOLD on the room and emails the guest a 6-digit code. Nothing is booked and nothing reaches the hotel until the guest confirms. After calling, tell the guest: check your email (the result shows the masked address), then either read the code back to you (call confirm_booking) or click Confirm in the email. Send an idempotency_key and reuse it if you retry. Confirm name, email, dates and price with the guest before calling. Demo hotels (demo: true) confirm at once and send no email.

Input	Type	Notes
stay_idRequired string	string	up to 100 characters
room_idRequired string	string	up to 100 characters
check_inRequired date	date	YYYY-MM-DD
check_outRequired date	date	YYYY-MM-DD
guestsRequired integer	integer	1–10
guest_nameRequired string	string	up to 120 characters
guest_emailRequired email	email	up to 254 characters
guest_phone string	string	up to 40 characters
notes string	string	Requests for the hotel, e.g. late arrival. up to 1000 characters
agent string	string	Name of the AI agent/app placing the request. up to 120 characters
idempotency_key string	string	One per booking attempt (8-128 of A-Z a-z 0-9 _ -). Reuse it on retries to get the same hold back.. up to 128 characters

book_directExample

book_direct({
  stay_id: "<stay_id from search_stays>",
  room_id: "<room_id from get_stay>",
  check_in: "2026-12-12",
  check_out: "2026-12-15",
  guests: 2,
  guest_name: "Example Guest",
  guest_email: "guest@example.com"
})

Confirm a held booking

05 / 05 · confirm_booking

Confirm a held booking with the 6-digit code the guest received by email. Only use a code the guest gave you. Five wrong codes cancel the hold. Confirming twice returns the same booking.

Input	Type	Notes
hold_idRequired string	string	hold_id from book_direct. up to 40 characters
codeRequired string	string	The 6-digit code from the guest's email. up to 20 characters

confirm_bookingExample

confirm_booking({
  hold_id: "<hold_id from book_direct>",
  code: "<6-digit code from the guest>"
})

Address	https://atabooking.com/mcp
Transport	streamable-http
Sign-in	None needed
Tools	5