Serveur MCP

ATA Travel

            cloud.atatravel/travel-agency
        

Commerce et retail Voyage et hôtellerie Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Searches accommodations and properties, provides availability and quotes, and supports verified traveler bookings, reservation status, extras, and travel support.

create_provisional_booking

Secure a reservation or create a host-approval enquiry on behalf of a traveler. policyAcknowledged is required as an explicit boolean and must be true for financially binding flows after the exact total, payment schedule, and cancellation terms are shown; identity verification is not consent. A host-approval enquiry may pass false because payment is not due unless accepted. Also requires the traveler’s full name, email, and country (guestCountry, required for bookings; optional for quotes) plus travelerAssertion or approved internal BOOKING_HOLD agentHandoffId. If verification is needed, keep internal tool details private; tell the traveler to confirm their email and follow the code or link instructions returned by verification. If instant book is enabled and payment is ready, creates an inventory-holding provisional booking and returns payment/manual-payment next steps. If instant book is disabled or Stripe checkout is not ready, creates an enquiry hold for host approval/payment follow-up.

Accès externe

Schéma d’entrée

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['propertyToken', 'roomId', 'checkIn', 'checkOut', 'guestName', 'guestEmail', 'guestCountry', 'adults', 'policyAcknowledged'], 'properties': {'notes': {'type': 'string', 'description': 'Optional traveler comments, questions, or requests for the host. Especially useful for host-approval enquiries.'}, 'adults': {'type': 'number'}, 'roomId': {'type': 'string'}, 'checkIn': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$'}, 'checkOut': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$'}, 'children': {'type': 'number', 'default': 0}, 'guestName': {'type': 'string', 'minLength': 1, 'description': 'Traveler’s full name, as supplied by the traveler.'}, 'guestEmail': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'guestPhone': {'type': 'string'}, 'ratePlanId': {'type': 'string', 'description': 'Rate plan ID. If omitted, the system auto-selects the default active rate plan per night, then the cheapest active auto-selectable fallback.'}, 'guestCountry': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Required traveler country, as supplied by the traveler. Ask only if missing. Do not infer it from the property location, language, currency, or phone number. Quotes do not require country.'}, 'priceAudience': {'enum': ['PUBLIC', 'VERIFIED_TRAVELER'], 'type': 'string'}, 'propertyToken': {'type': 'string'}, 'agentHandoffId': {'type': 'string', 'description': 'Approved ATA traveler handoff ID from start_traveler_handoff/get_traveler_handoff_status. Required for third-party agents before inventory-holding booking actions.'}, 'displayCurrency': {'type': 'string', 'description': 'Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative.'}, 'internalAgentKey': {'type': 'string'}, 'selectedRoomCount': {'type': 'number', 'description': 'For direct-booking room-count configurations, the number of rooms the traveler selected. Use defaultSelectedRoomCount from availability results.'}, 'travelerAssertion': {'type': 'string', 'description': 'Signed traveler email verification assertion from ATA.'}, 'policyAcknowledged': {'type': 'boolean', 'description': 'Explicit policy-consent state. Set true only after the traveler agrees to the exact price, payment schedule, and cancellation terms. Required before creating either an instant-book hold or a host-approval enquiry.'}}}

create_quote

Generate a non-binding reference quote for a traveler. Requires guest name/email plus a current travelerAssertion or fresh approved internal QUOTE agentHandoffId. If verification is needed, keep internal tool details private; tell the traveler to confirm their email and follow the code or link instructions returned by verification. Quotes do not hold inventory or guarantee future availability.

Accès externe

Schéma d’entrée

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['propertyToken', 'roomId', 'checkIn', 'checkOut', 'guestName', 'guestEmail', 'adults'], 'properties': {'adults': {'type': 'number'}, 'roomId': {'type': 'string'}, 'checkIn': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$'}, 'checkOut': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$'}, 'children': {'type': 'number', 'default': 0}, 'guestName': {'type': 'string'}, 'guestEmail': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'guestPhone': {'type': 'string'}, 'ratePlanId': {'type': 'string', 'description': 'Rate plan ID. Optional.'}, 'guestCountry': {'type': 'string', 'maxLength': 80, 'description': 'Optional for a quote. If omitted, the traveler supplies it when completing the booking.'}, 'priceAudience': {'enum': ['PUBLIC', 'VERIFIED_TRAVELER'], 'type': 'string'}, 'propertyToken': {'type': 'string'}, 'agentHandoffId': {'type': 'string', 'description': 'Fresh approved ATA traveler handoff ID from start_traveler_handoff/get_traveler_handoff_status. Required for third-party quote creation without a current traveler assertion.'}, 'displayCurrency': {'type': 'string', 'description': 'Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative.'}, 'internalAgentKey': {'type': 'string'}, 'selectedRoomCount': {'type': 'number', 'description': 'For direct-booking room-count configurations, the number of rooms the traveler selected. Use defaultSelectedRoomCount from availability results.'}, 'travelerAssertion': {'type': 'string', 'description': 'Signed traveler email verification assertion from ATA.'}}}

get_booking_details

Read an existing booking by its ATA confirmation code returned by a successful booking or supplied by the traveler. Never invent a code. Requires a current signed ATA traveler assertion, a verified legacy MCP session, or an approved BOOKING_READ handoff with matching booking email and code. For stateless third-party clients, use start_traveler_handoff with action BOOKING_READ and confirmationCode, then poll get_traveler_handoff_status. Returns booked stay, prices, payments and cancellation terms. Cannot modify, cancel, pay, or create inventory holds. Never use a confirmation code as holdId in get_reservation_status.