ATA Travel: agent-first direct booking for accommodations, hotels, and vacation rentals.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Traveler’s full name, as supplied by the traveler.
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.
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.
Optional traveler comments, questions, or requests for the host. Especially useful for host-approval enquiries.
Rate plan ID. If omitted, the system auto-selects the default active rate plan per night, then the cheapest active auto-selectable fallback.
Approved ATA traveler handoff ID from start_traveler_handoff/get_traveler_handoff_status. Required for third-party agents before inventory-holding booking actions.
Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative.
Internal Little John booking attribution; requires the internal agent credential.
For direct-booking room-count configurations, the number of rooms the traveler selected. Use defaultSelectedRoomCount from availability results.
Signed traveler email verification assertion from ATA.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 25, 2026.
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.
| Argument | Type | Description |
|---|---|---|
| notes | string | Optional traveler comments, questions, or requests for the host. Especially useful for host-approval enquiries. |
| adults* | number | |
| roomId* | string | |
| checkIn* | string | |
| checkOut* | string | |
| children | number | |
| guestName* | string | Traveler’s full name, as supplied by the traveler. |
| guestEmail* | string | |
| guestPhone | string | |
| ratePlanId | string | Rate plan ID. If omitted, the system auto-selects the default active rate plan per night, then the cheapest active auto-selectable fallback. |
| guestCountry* | string | 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 | string | |
| propertyToken* | string | |
| agentHandoffId | string | Approved ATA traveler handoff ID from start_traveler_handoff/get_traveler_handoff_status. Required for third-party agents before inventory-holding booking actions. |
| displayCurrency | string | Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative. |
| internalAgentKey | string | |
| bookingAssistance | string | Internal Little John booking attribution; requires the internal agent credential. |
| selectedRoomCount | number | For direct-booking room-count configurations, the number of rooms the traveler selected. Use defaultSelectedRoomCount from availability results. |
| travelerAssertion | string | Signed traveler email verification assertion from ATA. |
| policyAcknowledged* | boolean | 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. |
{
"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-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"
},
"bookingAssistance": {
"enum": [
"AI_ASSIST"
],
"type": "string",
"description": "Internal Little John booking attribution; requires the internal agent credential."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| adults* | number | |
| roomId* | string | |
| checkIn* | string | |
| checkOut* | string | |
| children | number | |
| guestName* | string | |
| guestEmail* | string | |
| guestPhone | string | |
| ratePlanId | string | Rate plan ID. Optional. |
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.
| Argument | Type | Description |
|---|---|---|
| propertyToken | string | Known property public token; required to match a property-scoped connection. |
| agentHandoffId | string | Approved BOOKING_READ handoff for this confirmation code. No write scope is accepted. |
| confirmationCode* | string | ATA confirmation code from the booking email. |
| travelerAssertion | string | Current signed ATA traveler verification assertion; never a typed email or model claim. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"confirmationCode"
],
"properties": {
"propertyToken": {
"type": "string",
"description": "Known property public token; required to match a property-scoped connection."
},
"agentHandoffId": {
"type": "string",
"description": "Approved BOOKING_READ handoff for this confirmation code. No write scope is accepted."
},
"confirmationCode": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "ATA confirmation code from the booking email."
},
"travelerAssertion": {
"type": "string",
"description": "Current signed ATA traveler verification assertion; never a typed email or model claim."
}
}
}Get a published ATA building/complex profile with assigned stays and map coordinates. Use slug from search_buildings or property search results.
| Argument | Type | Description |
|---|---|---|
| slug* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}Read ATA's published company mission and company description. Use for questions about ATA's purpose or services.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Return 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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get 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.
| Argument | Type | Description |
|---|---|---|
| roomQuery | string | Optional traveler-provided room or unit name, such as '5B Casita Vista'. No stay dates are required. |
| propertyToken* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"propertyToken"
],
"properties": {
"roomQuery": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Optional traveler-provided room or unit name, such as '5B Casita Vista'. No stay dates are required."
},
"propertyToken": {
"type": "string"
}
}
}Read a previously created quote using its actual quoteId, quoteHash or quoteUrl. Requires a current signed traveler assertion, verified legacy session, or the still-valid USED QUOTE handoff that created this exact quote. A quote is not a booking or inventory hold. Returns stored prices and payment terms; never substitute another room's payment schedule.
| Argument | Type | Description |
|---|---|---|
| quoteId | string | |
| quoteUrl | string | Existing ATA /stays/quote/ link supplied by the traveler or returned by create_quote. |
| quoteHash | string | |
| propertyToken | string | |
| agentHandoffId | string | Still-valid USED QUOTE handoff that created this quote. Read-only access grants no additional writes; expired handoffs require fresh traveler verification. |
| travelerAssertion | string | Current signed ATA traveler assertion for the quote owner. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"quoteId": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"quoteUrl": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Existing ATA /stays/quote/ link supplied by the traveler or returned by create_quote."
},
"quoteHash": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"propertyToken": {
"type": "string"
},
"agentHandoffId": {
"type": "string",
"description": "Still-valid USED QUOTE handoff that created this quote. Read-only access grants no additional writes; expired handoffs require fresh traveler verification."
},
"travelerAssertion": {
"type": "string",
"description": "Current signed ATA traveler assertion for the quote owner."
}
}
}Return the current status and exact stay, price, payment schedule, and cancellation terms for a reservation previously created through ATA. Requires the hold ID plus the same verified traveler context/assertion or the secure booking handoff that created it. This tool is read-only and cannot change, pay, cancel, check in, or check out a reservation.
| Argument | Type | Description |
|---|---|---|
| holdId* | string | Hold ID returned by create_provisional_booking. |
| guestEmail | string | Traveler email. Required when using travelerAssertion; populated automatically for a verified MCP session. |
| propertyToken | string | Known public property token for this reservation; must match the hold property when supplied. |
| agentHandoffId | string | Secure BOOKING_HOLD handoff ID that created this reservation. |
| displayCurrency | string | Optional 3-letter currency for approximate display conversion. Native property currency remains authoritative. |
| travelerAssertion | string | Current signed ATA traveler verification assertion for the reservation guest. |
Return ATA stays assigned to a published building, optionally filtered by live dates and guest counts.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| adults | number | |
| checkIn | string | |
| checkOut | string | |
| children | number | |
| priceAudience | string | |
| displayCurrency | string | Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative. |
| internalAgentKey | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"adults": {
"type": "number",
"default": 1
},
"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
},
"priceAudience": {
"enum": [
"PUBLIC",
"VERIFIED_TRAVELER"
],
"type": "string"
},
"displayCurrency": {
"type": "string",
"description": "Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative."
},
"internalAgentKey": {
"type": "string"
}
}
}Get 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.
| Argument | Type | Description |
|---|---|---|
| propertyToken | string | Property public token, when the traveler needs help from that property. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"propertyToken": {
"type": "string",
"description": "Property public token, when the traveler needs help from that property."
}
}
}Check 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.
| Argument | Type | Description |
|---|---|---|
| handoffId* | string | ID returned by start_traveler_handoff. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"handoffId"
],
"properties": {
"handoffId": {
"type": "string",
"description": "ID returned by start_traveler_handoff."
}
}
}Returns active structured memories for a verified traveler. Use this when you need durable personalization beyond the context already provided.
| Argument | Type | Description |
|---|---|---|
| travelerId* | string | Verified traveler ID from the private traveler context. |
| travelerAssertion | string | Current signed ATA traveler assertion matching travelerId; required on shared transports. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"travelerId"
],
"properties": {
"travelerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Verified traveler ID from the private traveler context."
},
"travelerAssertion": {
"type": "string",
"description": "Current signed ATA traveler assertion matching travelerId; required on shared transports."
}
}
}Check whether a code or email-link challenge started in this MCP session has completed. A completed link binds the traveler privately to this MCP session.
| Argument | Type | Description |
|---|---|---|
| challengeRef* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"challengeRef"
],
"properties": {
"challengeRef": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}List date-free published events, services, activities, day passes, experiences, dining, wellness, packages, transfers, and other extras for a known property. Returns read-only offer details and ATA purchase links when the property is published on ATA; it does not create an order.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional exact offer category filter, such as DAY_PASS, EXPERIENCE, WELLNESS, TRANSPORT, or PACKAGE. |
| propertyToken* | string | |
| standaloneOnly | boolean | When true, exclude offers that require a stay. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"propertyToken"
],
"properties": {
"category": {
"type": "string",
"description": "Optional exact offer category filter, such as DAY_PASS, EXPERIENCE, WELLNESS, TRANSPORT, or PACKAGE."
},
"propertyToken": {
"type": "string"
},
"standaloneOnly": {
"type": "boolean",
"default": false,
"description": "When true, exclude offers that require a stay."
}
}
}Check whether the ATA MCP server responds. Returns 'pong'; does not search properties or change quotes or bookings.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Find 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.
| Argument | Type | Description |
|---|---|---|
| city | string | |
| tags | array | |
| query | string | Building name, neighborhood, city, or text query. |
| amenities | array | |
| maxResults | number | |
| neighborhood | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"query": {
"type": "string",
"description": "Building name, neighborhood, city, or text query."
},
"amenities": {
"type": "array",
"items": {
"type": "string"
}
},
"maxResults": {
"type": "number",
"default": 10
},
"neighborhood": {
"type": "string"
}
}
}Search 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.
| Argument | Type | Description |
|---|---|---|
| views | array | Optional soft view preferences for flexible discovery. |
| adults | integer | Adult guests. Defaults to 2. |
| nights | integer | Length of stay. Defaults to 3 nights. |
| children | integer | Child guests. Defaults to 0. |
| location | string | Optional city, state, country, neighborhood, or building. Omit when the traveler is open to ATA's current destinations. |
| maxPrice | number | Maximum total stay price. |
| amenities | array | Optional soft amenity preferences for flexible discovery. |
| maxResults | integer | Maximum priced stays to return. Defaults to 4. |
Find 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.
| Argument | Type | Description |
|---|---|---|
| views | array | Filter by room views. e.g. ['Ocean', 'Mountain', 'Garden', 'City'] |
| adults | number | Number of adults |
| budget | object | Optional additional budget constraint. Clarify missing currency or basis before calling. Do not combine with legacy maxPrice/maxPriceCurrency. |
| checkIn* | string | Check-in date (YYYY-MM-DD) |
| keyword | string | Text matched against property name/description. Use for a required text match; use preferences for optional style preferences. |
| checkOut* | string | Check-out date (YYYY-MM-DD) |
| children | number | Number of children |
| location | string | Optional city, state, or country. Omit when the traveler knows dates but is open to ATA's current destinations. |
Search specific dates and occupancy for a known property using its propertyToken.
| Argument | Type | Description |
|---|---|---|
| adults | number | |
| budget | object | Optional additional budget constraint. Clarify missing currency or basis before calling. Do not combine with legacy maxPrice/maxPriceCurrency. |
| checkIn* | string | Check-in date (YYYY-MM-DD) |
| checkOut* | string | Check-out date (YYYY-MM-DD) |
| children | number | |
| priceAudience | string | |
| propertyToken* | string | Exact public propertyToken returned by discovery or property context. Never add a prefix or invent a token. |
| displayCurrency | string | Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative. |
Browse participating ATA properties without stay dates. Filter by location, property type, amenities, views, or keyword. Does not check date-specific availability or prices.
| Argument | Type | Description |
|---|---|---|
| views | array | e.g. ['Ocean', 'Mountain', 'Garden'] |
| adults | integer | Optional adults for occupancy-safe catalog suggestions. |
| keyword | string | Text matched against property name/description. Use for a required text match; use preferences for optional style preferences. |
| children | integer | Optional children for occupancy-safe catalog suggestions. |
| location | string | City, state, or country to filter by. Omit to search all participating ATA destinations. |
| amenities | array | e.g. ['Pool', 'Spa', 'Pet Friendly', 'Gym'] |
| maxResults | number | Max number of properties to return (default 10) |
| preferences | array | Open-ended soft ranking signals inferred from traveler language or current network facets. |
Internal approval step for quote or booking tools. Before calling, read guestEmail back to the traveler and confirm it is correct; then set emailConfirmedByTraveler=true. If an email is sent, tell the traveler only to check their inbox and click the secure ATA link. Do not mention handoffs/tool details to the traveler.
| Argument | Type | Description |
|---|---|---|
| action* | string | Use BOOKING_HOLD before creating a reservation; BOOKING_READ grants only read access to an existing booking for questions. |
| adults | number | |
| roomId | string | |
| checkIn | string | |
| quoteId | string | |
| checkOut | string | |
| children | number | |
| agentName | string | Agent/application display name when known. |
| guestName* | string | Traveler name collected by the agent. |
| quoteHash |
Start general traveler verification for this MCP session after the traveler confirms their email address. Uses the property’s configured verification method. This does not create a quote, enquiry, hold, or booking.
| Argument | Type | Description |
|---|---|---|
| method | string | |
| agentName | string | |
| guestName* | string | |
| guestEmail* | string | |
| guestPhone | string | |
| agentProvider | string | |
| propertyToken | string | |
| emailConfirmedByTraveler* | boolean | True only after the traveler confirms the exact email address. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"guestName",
"guestEmail",
"emailConfirmedByTraveler"
],
"properties": {
"method": {
"enum": [
"EMAIL_CODE",
"EMAIL_LINK",
"SMS_CODE",
"WHATSAPP_CODE"
],
"type": "string"
},
"agentName": {
"type": "string"
},
"guestName": {
"type": "string",
"minLength": 1
},
"guestEmail": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"guestPhone": {
"type": "string"
},
"agentProvider": {
"type": "string"
},
"propertyToken": {
"type": "string"
},
"emailConfirmedByTraveler": {
"type": "boolean",
"description": "True only after the traveler confirms the exact email address."
}
}
}Save or update one durable traveler memory for personalization. Use only for stable, travel-relevant preferences or constraints explicitly stated by the traveler.
| Argument | Type | Description |
|---|---|---|
| key* | string | Stable normalized memory key. Choose the closest allowed key. |
| type* | string | Memory category. |
| value* | any | Small JSON value, e.g. {"hasServiceDog":true} or {"typicalAdults":2,"typicalChildren":1}. |
| source | string | |
| summary* | string | Short practical note, without speculation or sensitive details. |
| confidence | number | Confidence in this memory. Use 1 for explicit user statements, lower for inferred patterns. |
| travelerId* | string | Verified traveler ID from the private traveler context. |
| visibility | string | |
| travelerAssertion | string |
Consume the six-digit code for a challenge started in this MCP session. On success, ATA privately binds the verified traveler to this MCP session; no reusable bearer credential is returned.
| Argument | Type | Description |
|---|---|---|
| code* | string | |
| challengeRef* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"challengeRef",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\d{6}$"
},
"challengeRef": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}| guestCountry |
| string |
| Optional for a quote. If omitted, the traveler supplies it when completing the booking. |
| priceAudience | string |
| propertyToken* | string |
| agentHandoffId | string | 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 | string | Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative. |
| internalAgentKey | string |
| selectedRoomCount | number | For direct-booking room-count configurations, the number of rooms the traveler selected. Use defaultSelectedRoomCount from availability results. |
| travelerAssertion | string | Signed traveler email verification assertion from ATA. |
{
"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-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."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"holdId"
],
"properties": {
"holdId": {
"type": "string",
"minLength": 1,
"description": "Hold ID returned by create_provisional_booking."
},
"guestEmail": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Traveler email. Required when using travelerAssertion; populated automatically for a verified MCP session."
},
"propertyToken": {
"type": "string",
"description": "Known public property token for this reservation; must match the hold property when supplied."
},
"agentHandoffId": {
"type": "string",
"description": "Secure BOOKING_HOLD handoff ID that created this reservation."
},
"displayCurrency": {
"type": "string",
"description": "Optional 3-letter currency for approximate display conversion. Native property currency remains authoritative."
},
"travelerAssertion": {
"type": "string",
"description": "Current signed ATA traveler verification assertion for the reservation guest."
}
}
}| preferences | array | Open-ended soft preferences inferred from the traveler's own words or live network facets. |
| propertyType | string | Optional soft property-type preference; it ranks results and is reported as a difference when unavailable. |
| latestCheckIn | string | Latest acceptable check-in date. Defaults to 56 days from today. |
| priceAudience | string |
| displayCurrency | string | Optional traveler-facing display currency. |
| earliestCheckIn | string | Earliest acceptable check-in date. Defaults to 28 days from today. |
| internalAgentKey | string |
| maxPriceCurrency | string | Currency for maxPrice when filtering mixed native currencies. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"views": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional soft view preferences for flexible discovery."
},
"adults": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Adult guests. Defaults to 2."
},
"nights": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Length of stay. Defaults to 3 nights."
},
"children": {
"type": "integer",
"maximum": 40,
"minimum": 0,
"description": "Child guests. Defaults to 0."
},
"location": {
"type": "string",
"description": "Optional city, state, country, neighborhood, or building. Omit when the traveler is open to ATA's current destinations."
},
"maxPrice": {
"type": "number",
"minimum": 0.01,
"description": "Maximum total stay price."
},
"amenities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional soft amenity preferences for flexible discovery."
},
"maxResults": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Maximum priced stays to return. Defaults to 4."
},
"preferences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 6,
"description": "Open-ended soft preferences inferred from the traveler's own words or live network facets."
},
"propertyType": {
"type": "string",
"description": "Optional soft property-type preference; it ranks results and is reported as a difference when unavailable."
},
"latestCheckIn": {
"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])))$",
"description": "Latest acceptable check-in date. Defaults to 56 days from today."
},
"priceAudience": {
"enum": [
"PUBLIC",
"VERIFIED_TRAVELER"
],
"type": "string"
},
"displayCurrency": {
"type": "string",
"description": "Optional traveler-facing display currency."
},
"earliestCheckIn": {
"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])))$",
"description": "Earliest acceptable check-in date. Defaults to 28 days from today."
},
"internalAgentKey": {
"type": "string"
},
"maxPriceCurrency": {
"type": "string",
"description": "Currency for maxPrice when filtering mixed native currencies."
}
}
}| maxPrice | number | Maximum total price filter |
| amenities | array | Filter by amenities on property or rooms. e.g. ['Pool', 'Gym', 'Pet Friendly', 'Spa'] |
| preferences | array | Open-ended soft ranking signals. These do not exclude otherwise valid stays. |
| propertyType | string | e.g. 'Hotel', 'Apartment', 'Villa' |
| priceAudience | string |
| displayCurrency | string | Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative. |
| internalAgentKey | string |
| maxPriceCurrency | string | Currency for maxPrice when filtering across mixed property currencies. If omitted, maxPrice is compared to each property's native currency. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"checkIn",
"checkOut"
],
"properties": {
"views": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by room views. e.g. ['Ocean', 'Mountain', 'Garden', 'City']"
},
"adults": {
"type": "number",
"default": 1,
"description": "Number of adults"
},
"budget": {
"type": "object",
"required": [
"amount",
"currency",
"basis"
],
"properties": {
"basis": {
"enum": [
"TOTAL_STAY",
"PER_NIGHT",
"PER_PERSON_STAY",
"PER_PERSON_PER_NIGHT"
],
"type": "string",
"description": "Required explicit basis. Per-night means a stay-average allowance, not a ceiling on each night. Per-person means every adult and child equally; clarify other interpretations."
},
"scope": {
"enum": [
"PRICED_STAY",
"ALL_IN"
],
"type": "string",
"default": "PRICED_STAY",
"description": "PRICED_STAY compares the accommodation total including configured taxes/fees. ALL_IN requires complete mandatory charges; currently ATA cannot verify completeness and will return labeled alternatives only."
},
"amount": {
"type": "number",
"description": "Maximum amount in the explicitly supplied currency and basis.",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Required 3-letter budget currency. Never infer from location or displayCurrency."
}
},
"description": "Optional additional budget constraint. Clarify missing currency or basis before calling. Do not combine with legacy maxPrice/maxPriceCurrency.",
"additionalProperties": false
},
"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])))$",
"description": "Check-in date (YYYY-MM-DD)"
},
"keyword": {
"type": "string",
"description": "Text matched against property name/description. Use for a required text match; use preferences for optional style preferences."
},
"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])))$",
"description": "Check-out date (YYYY-MM-DD)"
},
"children": {
"type": "number",
"default": 0,
"description": "Number of children"
},
"location": {
"type": "string",
"description": "Optional city, state, or country. Omit when the traveler knows dates but is open to ATA's current destinations."
},
"maxPrice": {
"type": "number",
"description": "Maximum total price filter"
},
"amenities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by amenities on property or rooms. e.g. ['Pool', 'Gym', 'Pet Friendly', 'Spa']"
},
"preferences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 6,
"description": "Open-ended soft ranking signals. These do not exclude otherwise valid stays."
},
"propertyType": {
"type": "string",
"description": "e.g. 'Hotel', 'Apartment', 'Villa'"
},
"priceAudience": {
"enum": [
"PUBLIC",
"VERIFIED_TRAVELER"
],
"type": "string"
},
"displayCurrency": {
"type": "string",
"description": "Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative."
},
"internalAgentKey": {
"type": "string"
},
"maxPriceCurrency": {
"type": "string",
"description": "Currency for maxPrice when filtering across mixed property currencies. If omitted, maxPrice is compared to each property's native currency."
}
}
}| internalAgentKey |
| string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"propertyToken",
"checkIn",
"checkOut"
],
"properties": {
"adults": {
"type": "number",
"default": 1
},
"budget": {
"type": "object",
"required": [
"amount",
"currency",
"basis"
],
"properties": {
"basis": {
"enum": [
"TOTAL_STAY",
"PER_NIGHT",
"PER_PERSON_STAY",
"PER_PERSON_PER_NIGHT"
],
"type": "string",
"description": "Required explicit basis. Per-night means a stay-average allowance, not a ceiling on each night. Per-person means every adult and child equally; clarify other interpretations."
},
"scope": {
"enum": [
"PRICED_STAY",
"ALL_IN"
],
"type": "string",
"default": "PRICED_STAY",
"description": "PRICED_STAY compares the accommodation total including configured taxes/fees. ALL_IN requires complete mandatory charges; currently ATA cannot verify completeness and will return labeled alternatives only."
},
"amount": {
"type": "number",
"description": "Maximum amount in the explicitly supplied currency and basis.",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Required 3-letter budget currency. Never infer from location or displayCurrency."
}
},
"description": "Optional additional budget constraint. Clarify missing currency or basis before calling. Do not combine with legacy maxPrice/maxPriceCurrency.",
"additionalProperties": false
},
"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])))$",
"description": "Check-in date (YYYY-MM-DD)"
},
"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])))$",
"description": "Check-out date (YYYY-MM-DD)"
},
"children": {
"type": "number",
"default": 0
},
"priceAudience": {
"enum": [
"PUBLIC",
"VERIFIED_TRAVELER"
],
"type": "string"
},
"propertyToken": {
"type": "string",
"description": "Exact public propertyToken returned by discovery or property context. Never add a prefix or invent a token."
},
"displayCurrency": {
"type": "string",
"description": "Optional 3-letter currency for approximate traveler-facing display conversion. Native property currency remains authoritative."
},
"internalAgentKey": {
"type": "string"
}
}
}| propertyType | string | e.g. 'Hotel', 'Villa', 'Apartment' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"views": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. ['Ocean', 'Mountain', 'Garden']"
},
"adults": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Optional adults for occupancy-safe catalog suggestions."
},
"keyword": {
"type": "string",
"description": "Text matched against property name/description. Use for a required text match; use preferences for optional style preferences."
},
"children": {
"type": "integer",
"maximum": 40,
"minimum": 0,
"description": "Optional children for occupancy-safe catalog suggestions."
},
"location": {
"type": "string",
"description": "City, state, or country to filter by. Omit to search all participating ATA destinations."
},
"amenities": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. ['Pool', 'Spa', 'Pet Friendly', 'Gym']"
},
"maxResults": {
"type": "number",
"default": 10,
"description": "Max number of properties to return (default 10)"
},
"preferences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 6,
"description": "Open-ended soft ranking signals inferred from traveler language or current network facets."
},
"propertyType": {
"type": "string",
"description": "e.g. 'Hotel', 'Villa', 'Apartment'"
}
}
}| string |
| guestEmail* | string | Traveler-provided email address for the action-specific ATA verification link. |
| guestPhone | string |
| ratePlanId | string |
| mcpSessionId | string | Optional client-side MCP/session correlation ID. |
| agentProvider | string | Agent platform or provider name when known. |
| intentSummary | string | Short traveler-facing summary of what ATA is verifying, without mentioning internal handoff/tool details. |
| propertyToken | string |
| confirmationCode | string | Required for BOOKING_READ: the ATA confirmation code printed on the booking confirmation. |
| selectedRoomCount | number |
| emailConfirmedByTraveler | boolean | Set true only after reading guestEmail back to the traveler and they confirm it is correct. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action",
"guestName",
"guestEmail"
],
"properties": {
"action": {
"enum": [
"QUOTE",
"BOOKING_HOLD",
"BOOKING_READ"
],
"type": "string",
"description": "Use BOOKING_HOLD before creating a reservation; BOOKING_READ grants only read access to an existing booking for questions."
},
"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])))$"
},
"quoteId": {
"type": "string"
},
"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
},
"agentName": {
"type": "string",
"description": "Agent/application display name when known."
},
"guestName": {
"type": "string",
"description": "Traveler name collected by the agent."
},
"quoteHash": {
"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-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Traveler-provided email address for the action-specific ATA verification link."
},
"guestPhone": {
"type": "string"
},
"ratePlanId": {
"type": "string"
},
"mcpSessionId": {
"type": "string",
"description": "Optional client-side MCP/session correlation ID."
},
"agentProvider": {
"type": "string",
"description": "Agent platform or provider name when known."
},
"intentSummary": {
"type": "string",
"description": "Short traveler-facing summary of what ATA is verifying, without mentioning internal handoff/tool details."
},
"propertyToken": {
"type": "string"
},
"confirmationCode": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Required for BOOKING_READ: the ATA confirmation code printed on the booking confirmation."
},
"selectedRoomCount": {
"type": "number"
},
"emailConfirmedByTraveler": {
"type": "boolean",
"description": "Set true only after reading guestEmail back to the traveler and they confirm it is correct."
}
}
}| Current signed ATA traveler assertion matching travelerId; required on shared transports. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"travelerId",
"type",
"key",
"value",
"summary"
],
"properties": {
"key": {
"enum": [
"accessibility",
"budget",
"children",
"diet",
"guest_count",
"language",
"occasion",
"pace",
"pets",
"room_features",
"service_animal",
"stay_length",
"travel_party",
"travel_purpose",
"view"
],
"type": "string",
"description": "Stable normalized memory key. Choose the closest allowed key."
},
"type": {
"enum": [
"PREFERENCE",
"PROFILE_FACT",
"TRAVEL_STYLE",
"SERVICE_NOTE"
],
"type": "string",
"description": "Memory category."
},
"value": {
"description": "Small JSON value, e.g. {\"hasServiceDog\":true} or {\"typicalAdults\":2,\"typicalChildren\":1}."
},
"source": {
"enum": [
"USER_STATED",
"INFERRED",
"BOOKING_HISTORY",
"AGENT_NOTE"
],
"type": "string",
"default": "USER_STATED"
},
"summary": {
"type": "string",
"maxLength": 240,
"minLength": 8,
"description": "Short practical note, without speculation or sensitive details."
},
"confidence": {
"type": "number",
"default": 0.8,
"maximum": 1,
"minimum": 0,
"description": "Confidence in this memory. Use 1 for explicit user statements, lower for inferred patterns."
},
"travelerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Verified traveler ID from the private traveler context."
},
"visibility": {
"enum": [
"AGENT_ONLY",
"STAFF_VISIBLE",
"USER_VISIBLE"
],
"type": "string",
"default": "AGENT_ONLY"
},
"travelerAssertion": {
"type": "string",
"description": "Current signed ATA traveler assertion matching travelerId; required on shared transports."
}
}
}