create_provisional_booking
ChatGPTCreate a provisional booking or host-approval enquiry when the traveler asks to reserve the selected stay, using a verified BOOKING_HOLD agentHandoffId. A provisional booking holds inventory and expires automatically if unpaid. This may send email that cannot be recalled. Booking requires the guest full name, email and country of origin. Reuse details already supplied, including those in the quote; ask for all missing details together. Country means the traveler country of origin, not the destination. Carry selectedRoomCount from the quote. Return the total, payment schedule, cancellation terms and payment link. Payment and terms acceptance occur on ATA's external secure page, not through identity verification. An enquiry is not confirmed and no payment is due unless accepted. Modern clients must provide a UUID idempotencyKey; exact retries replay the original result without repeating the action.
create_quote
ChatGPTCreate and email a non-binding quote for the selected stay using a verified QUOTE agentHandoffId. Collect the guest full name and email; country of origin is optional for a quote. A successful response means the quote exists and email delivery is queued, not failed. If the response is interrupted, read the existing quote or retry the identical idempotent request; never send a duplicate quote. Email cannot be recalled. This creates a traveler lead and price snapshot but does not hold inventory, confirm a reservation or guarantee future price or availability. Modern clients must provide a UUID idempotencyKey; exact retries replay the original result without repeating the action.
get_available_room_cards
ChatGPTData-only: intentionally refresh the complete already mounted carousel, including one returned by AUTO availability. Does not create a new view. Use show_available_rooms only for a requested presentation not already supplied, an explicit retry or a different requested view; do not page this tool to assemble Markdown thumbnails. Read-only room comparison presentation. First search availability, then select returned property/room/rate/count IDs and preserve the exact dates, guests, budget and display currency. Rechecks the existing property availability tool for current authoritative stay totals; never accepts prices or quote data. Up to 3 properties and 60 offers in one complete swipe carousel, without result pages. show_available_rooms renders once; get_available_room_cards is data-only to refresh the mounted carousel. Photo selection opens only the selected room gallery. No bookings, holds, quotes, emails or payments.
get_booking_details
ChatGPTRead an existing booking by its ATA confirmation code using approved BOOKING_READ agentHandoffId for the same traveler and code. Returns stay, prices, payments and cancellation terms; cannot modify, cancel or pay a booking.
get_building_details
ChatGPTGet a published ATA building/complex profile with assigned stays and map coordinates. Use slug from search_buildings or property search results. Answer destination, property-type or building questions from these results. Search availability only when the traveler requests a stay comparison or date-specific prices; do not request dates or render accommodation results solely to answer discovery-only questions.
get_company_mission
ChatGPTRead ATA's published company mission and company description. Use for questions about ATA's purpose or services.
get_network_discovery_context
ChatGPTReturn a summary of ATA's current destinations, property types, capacity, amenities, views, and published suitability information. Use to identify supported discovery options when the traveler has not specified a property or destination. Does not check availability for specific dates. Answer destination, property-type or building questions from these results. Search availability only when the traveler requests a stay comparison or date-specific prices; do not request dates or render accommodation results solely to answer discovery-only questions.
get_photo_gallery
ChatGPTData-only: read a page inside an already mounted gallery, including a gallery returned by AUTO details. Does not create a new view. Use show_property_photos only for a requested presentation not already supplied, an explicit retry or a different requested view; do not page this tool to assemble Markdown image grids. Read only: show a PROPERTY-only or ROOM-only gallery of actual published photos. Default ROOM when roomId/roomQuery is supplied, PROPERTY otherwise. A room never includes property photos. Use exact room IDs from availability or a unique room name; no substitutions. Pages contain at most12 photos. No dates required. get_photo_gallery is data-only for in-card pagination; show_property_photos intentionally renders once.
get_property_details
ChatGPTGet date-free property and room details, including traveler-facing amenities, property-authored direct-booking benefits, policies, Events & Weddings, room profiles, published image links and up to two bounded image previews (property and uniquely matched room). Missing previews retain links. When the traveler names a room or unit, pass that wording as roomQuery before treating it as another property. AUTO returns the visual view automatically with the result when available; do not call a separate show tool for the same view. Use presentation TEXT for text-only preferences or intermediate lookups. Keep explicit text-only requests in text; an intermediate lookup may be followed by one final presentation.
get_quote_details
ChatGPTRead an existing quote using the still-valid USED QUOTE handoff that created it. If that approval expires or the quote was created elsewhere, continue on the returned ATA quote page; do not create another quote just to read the original. A quote URL alone is not authorization. Returns saved terms without sending email or holding inventory.
get_reservation_status
ChatGPTRead a provisional booking or enquiry using its returned holdId and matching approved booking handoff. Cannot modify, cancel or pay the reservation. Never pass a confirmation code as holdId.
get_stays_in_building
ChatGPTReturn ATA stays assigned to a published building, optionally filtered by live dates and guest counts. Without dates, this is a listing, not a priced availability result. For a requested dated comparison with usable priced offers, show_available_rooms can present the returned selections with unchanged dates, guests and currency if that view has not already been supplied. Respect text-only preferences; do not search again solely to render.
get_support_contacts
ChatGPTGet published ATA support and optional property guest contact details. Use for human help, unanswered property questions, or booking support. Returns configured contact links only; does not send messages, create a case, or transfer the traveler to a person. Omit propertyToken for ATA support alone.
get_traveler_handoff_status
ChatGPTCheck the verification status and permitted next actions for an existing ATA traveler handoff. Use the handoffId returned by start_traveler_handoff. Does not send email or create a quote or booking.
ping
ChatGPTCheck whether the ATA MCP server responds. Returns 'pong'; does not search properties or change quotes or bookings.
search_buildings
ChatGPTFind published ATA building/complex profiles by destination, neighborhood, tag, amenity, or free-text. Use this for questions about buildings, condo towers, complexes, gated communities, marina developments, or neighborhoods.
search_flexible_network_availability
ChatGPTSearch participating ATA properties for availability and prices across a flexible date window. Defaults to a window 28–56 days from today, three nights, and two adults only when those values are missing; always return those defaults as explicit assumptions. Preferences are soft ranking signals, not a closed taxonomy. AUTO returns the visual view automatically with the result when available; do not call a separate show tool for the same view. Use presentation TEXT for text-only preferences or intermediate lookups. Keep explicit text-only requests in text; an intermediate lookup may be followed by one final presentation.
search_network_availability
ChatGPTFind accommodations across the ATA Travel Network with real-time pricing. Use when dates are known. Supports filtering by amenities, views, property type, and free-text keyword to handle vague requests. AUTO returns the visual view automatically with the result when available; do not call a separate show tool for the same view. Use presentation TEXT for text-only preferences or intermediate lookups. Keep explicit text-only requests in text; an intermediate lookup may be followed by one final presentation.
search_property_availability
ChatGPTSearch specific dates and occupancy for a known property using its propertyToken. AUTO returns the visual view automatically with the result when available; do not call a separate show tool for the same view. Use presentation TEXT for text-only preferences or intermediate lookups. Keep explicit text-only requests in text; an intermediate lookup may be followed by one final presentation.
search_property_catalog
ChatGPTBrowse participating ATA properties without stay dates. Filter by location, property type, amenities, views, or keyword. Does not check date-specific availability or prices. AUTO returns the visual view automatically with the result when available; do not call a separate show tool for the same view. Use presentation TEXT for text-only preferences or intermediate lookups. Keep explicit text-only requests in text; an intermediate lookup may be followed by one final presentation.
show_available_rooms
ChatGPTShow room comparisons for a requested presentation not already supplied by AUTO availability, an explicit retry or a different requested view. Skip unsupported UI and explicit text-only requests; answer ordinary follow-ups without repeating searches or widgets. Read-only room comparison presentation. First search availability, then select returned property/room/rate/count IDs and preserve the exact dates, guests, budget and display currency. Rechecks the existing property availability tool for current authoritative stay totals; never accepts prices or quote data. Up to 3 properties and 60 offers in one complete swipe carousel, without result pages. show_available_rooms renders once; get_available_room_cards is data-only to refresh the mounted carousel. Photo selection opens only the selected room gallery. No bookings, holds, quotes, emails or payments.
show_property_photos
ChatGPTShow published property or room photos for a requested presentation not already supplied by AUTO details, an explicit retry or a different requested view. Skip unsupported UI and explicit text-only requests; preserve returned property/room identity. Read only: show a PROPERTY-only or ROOM-only gallery of actual published photos. Default ROOM when roomId/roomQuery is supplied, PROPERTY otherwise. A room never includes property photos. Use exact room IDs from availability or a unique room name; no substitutions. Pages contain at most12 photos. No dates required. get_photo_gallery is data-only for in-card pagination; show_property_photos intentionally renders once.
start_traveler_handoff
ChatGPTStart email verification on ATA for a traveler-requested quote, provisional booking or existing-booking read. Initial verification sends one email that cannot be recalled; verification happens outside chat. Use the traveler-supplied email for that action. Include the exact property, room, rate plan, dates, guest counts and selectedRoomCount from availability for a quote or hold; omission of selectedRoomCount means one room. If the traveler requests a hold for the same quoted stay, pass previousHandoffId with action BOOKING_HOLD. An eligible continuation reuses verified identity for one matching hold without another verification email. A changed stay, traveler, cancelled grant or expired verification is outside that continuation; follow the returned verification requirements. Modern clients must provide a UUID idempotencyKey; exact retries replay the original result without repeating the action.