Servers Playground How we check Add a server Log in

Tineo

Working Security A

ai.tineo/tineov1.1.0 Domain verified

Plan trips, search flights and hotels, and keep every booking in one shared itinerary.

Maps & Travel

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-14T04:32:50.712044Z",
      "publishedAt": "2026-11-14T04:32:50.712044Z",
      "statusChangedAt": "2026-11-14T04:32:50.712044Z"
    }
  },
  "server": {
    "name": "ai.tineo/tineo",
    "icons": [
      {
        "src": "https://tineo.ai/favicon/web-app-manifest-512x512.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Tineo",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://api.tineo.ai/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "1.1.0",
    "websiteUrl": "https://tineo.ai",
    "description": "Plan trips, search flights and hotels, and keep every booking in one shared itinerary."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.tineo.ai/mcp

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.

affiliate_program_catalog Read-only

Return Tineo's travel-affiliate catalog with truthful implementation status. Use only for questions about supported affiliate programs, never for a link to a specific or previously searched travel result. With generic search intent, validated generic adapters may include safe Tineo-owned CTA links. A card with bookingLink=null is metadata only, not a booking handoff or live inventory.

limitinteger

Optional result cap. Defaults to 54.

localestring

Optional locale. Defaults to en.

endDatestring

Optional local end/check-out date in YYYY-MM-DD format.

trip_idstring

Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.

currencystring

Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.

locationstring

Optional city or destination used to build the provider search.

verticalstring

Optional category filter, such as Hotels, Tours, Flights, Trains, or Transfers.

startDatestring

Optional local start/check-in date in YYYY-MM-DD format.

travelersinteger

Optional traveler count. Defaults to 1.

searchTermstring

Concrete search intent. Required to generate booking CTA buttons.

includeResearchboolean

Include catalogued/research programs. Defaults to true.

Tineo MCP server | mcptry

Tineo

Working Security A

ai.tineo/tineov1.1.0 Domain verified

Plan trips, search flights and hotels, and keep every booking in one shared itinerary.

Maps & Travel

Watch Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-14T04:32:50.712044Z",
      "publishedAt": "2026-11-14T04:32:50.712044Z",
      "statusChangedAt": "2026-11-14T04:32:50.712044Z"
    }
  },
  "server": {
    "name": "ai.tineo/tineo",
    "icons": [
      {
        "src": "https://tineo.ai/favicon/web-app-manifest-512x512.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Tineo",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://api.tineo.ai/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "1.1.0",
    "websiteUrl": "https://tineo.ai",
    "description": "Plan trips, search flights and hotels, and keep every booking in one shared itinerary."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.tineo.ai/mcp

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.

affiliate_program_catalog Read-only

limitinteger

Optional result cap. Defaults to 54.

localestring

Optional locale. Defaults to en.

endDatestring

Optional local end/check-out date in YYYY-MM-DD format.

trip_idstring

currencystring

Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.

locationstring

Optional city or destination used to build the provider search.

verticalstring

Optional category filter, such as Hotels, Tours, Flights, Trains, or Transfers.

startDatestring

Optional local start/check-in date in YYYY-MM-DD format.

travelersinteger

Optional traveler count. Defaults to 1.

searchTermstring

Concrete search intent. Required to generate booking CTA buttons.

includeResearchboolean

Include catalogued/research programs. Defaults to true.

Tools (109)

affiliate_program_catalog

read-only

Argument	Type	Description
limit	integer	Optional result cap. Defaults to 54.
locale	string	Optional locale. Defaults to en.
endDate	string	Optional local end/check-out date in YYYY-MM-DD format.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.
location	string	Optional city or destination used to build the provider search.
vertical	string	Optional category filter, such as Hotels, Tours, Flights, Trains, or Transfers.
startDate	string	Optional local start/check-in date in YYYY-MM-DD format.
travelers	integer	Optional traveler count. Defaults to 1.
searchTerm	string	Concrete search intent. Required to generate booking CTA buttons.
includeResearch	boolean	Include catalogued/research programs. Defaults to true.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 54,
      "minimum": 1,
      "description": "Optional result cap. Defaults to 54."
    },
    "locale": {
      "type": "string",
      "description": "Optional locale. Defaults to en."
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "Optional local end/check-out date in YYYY-MM-DD format."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user."
    },
    "currency": {
      "type": "string",
      "description": "Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD."
    },
    "location": {
      "type": "string",
      "description": "Optional city or destination used to build the provider search."
    },
    "vertical": {
      "type": "string",
      "description": "Optional category filter, such as Hotels, Tours, Flights, Trains, or Transfers."
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "description": "Optional local start/check-in date in YYYY-MM-DD format."
    },
    "travelers": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Optional traveler count. Defaults to 1."
    },
    "searchTerm": {
      "type": "string",
      "description": "Concrete search intent. Required to generate booking CTA buttons."
    },
    "includeResearch": {
      "type": "boolean",
      "description": "Include catalogued/research programs. Defaults to true."
    }
  }
}

assistant_airbnb_search_trip

Search Airbnb listings for an existing Tineo trip. Derives location and dates from the trip; the model may override. location must be a city or area, not a whole country (ask the user which city). Each card has distance_km from the requested place and in_requested_area; listings outside the area come last. If none are in the area, say so with their distances and do NOT re-search the same place with a reworded location string. Amenity filtering only via the amenities enum; there is NO keyword/free-text filter, so tell the user anything else can't be filtered. If structuredContent.status is 'unavailable', do NOT retry the same search: share structuredContent.fallback_search_url (a prefilled airbnb.com search), offer a hotel search, or a support ticket.

read-only

Argument	Type	Description
adults	integer
infants	integer	Infants under 2. Airbnb does not count them as guests.
trip_id*	string	Tineo trip ID. Defaults below are derived from this trip when omitted.
check_in	string	Check-in date YYYY-MM-DD.
children	integer
currency	string	ISO 4217 currency code (default USD).
location

assistant_airbnb_search_user

Search Airbnb listings by location and dates. Use when the user is not asking about a specific trip in Tineo. Returns a slim list of cards (title, type, rating, host, URL). location must be a city or area, not a whole country (ask the user which city). Each card has distance_km from the requested place and in_requested_area; listings outside the area come last. If none are in the area, say so with their distances and do NOT re-search the same place with a reworded location string. Amenity filtering only via the amenities enum; there is NO keyword/free-text filter, so tell the user anything else can't be filtered. If structuredContent.status is 'unavailable', do NOT retry the same search: share structuredContent.fallback_search_url (a prefilled airbnb.com search), offer a hotel search, or a support ticket.

read-only

Argument	Type	Description
adults	integer
infants	integer	Infants under 2. Airbnb does not count them as guests.
check_in*	string	Check-in date YYYY-MM-DD.
children	integer
currency	string	ISO 4217 currency code (default USD).
location*	string	City, neighborhood, or landmark with its region and country (e.g., 'Lisbon, Portugal', 'Brooklyn, NY, USA', 'Orange, NSW, Australia').

audit_travel_documents

Audit expiration dates of the user's travel documents (passports, visas, insurance) and flag expired, expiring soon (<180 days), or expiring before trip end.

read-only

Argument	Type	Description
trip_id	string	Optional trip ID to check documents against that trip's dates.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional trip ID to check documents against that trip's dates."
    }
  },
  "additionalProperties": false
}

batch_segment_create

Create multiple segments in a trip in one call. To save into a trip that does not exist yet, send new_trip (title, start_date, end_date) instead of trip_id: the trip and its items are created in this one call. Put each item's values in fields, named as segment_get_schema returns them (Activity activityType is one of: tour, dining, show, spa, class, sports, sightseeing, other). Each item succeeds or fails on its own: valid items are created and failed items are returned by index with the reason, so resend only the failed items. Max 50 segments per call; split larger itineraries into several calls. Segment dates must fall within the parent trip dates. Dates up to 1 day outside the trip extend it, with a warning; further out, call trip_update first. For an Activity, Lodging, EventTicket or Parking at a real place, call places_search first and put the result's place ID in fields.placeId: Tineo links that place (map pin and coordinates) and fills a missing name, address, phone and website. Never invent a time: if the user has not given or chosen one, ask, or send the date only (YYYY-MM-DD) in startDateTime and Tineo stores it as time not set. Send a clock time only when the user stated it or a booking shows it. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification. Cruise/CruiseDay generic writes require the dedicated cruise tools; their schemas and full reads remain available.

Argument	Type	Description
trip_id	string	The trip ID to add segments to. Send this or new_trip.
new_trip	object	Use instead of trip_id to create the trip and its segments in one call. A trip of the user's with the same title and dates is reused.
segments*

car_rental_booking_links

Return DiscoverCars, Expedia and Booking.com affiliate car-rental search cards for a pickup city or airport and dates. These are provider search handoffs only, not live availability, prices, vehicles, or confirmed bookings.

read-only

Argument	Type	Description
locale	string	Optional locale. Defaults to en.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.
pickup_date*	string	Local pickup date in YYYY-MM-DD format.
dropoff_date	string	Optional local drop-off date in YYYY-MM-DD format.
pickup_location*	string	Pickup city or airport, e.g. Lisbon or LIS. Prefer the airport IATA code when picking up at an airport.

Input schema (JSON)

checklist_item_update

Change one task on a trip checklist: its text, its category (section heading), or whether it is done. Get checklist_id and item_id from trip_checklists. Send only what changes. checked true marks the task done for the current user (on a shared trip it shows complete once every traveler ticks it); checked false unticks it. category "" removes the task from its section. Never show IDs to users.

destructive

Argument	Type	Description
text	string	New task text.
checked	boolean	true marks the task done for the current user; false unticks it.
item_id*	string	The task's itemId from trip_checklists.
category	string	New section heading; "" clears it.
checklist_id*	string	The checklist note's segment ID (checklist_id from trip_checklists).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "checklist_id",
    "item_id"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "New task text."
    },
    "checked": {
      "type": "boolean",
      "description": "true marks the task done for the current user; false unticks it."
    },
    "item_id": {
      "type": "string",
      "description": "The task's itemId from trip_checklists."
    },
    "category": {
      "type": "string",
      "maxLength": 40,
      "description": "New section heading; \"\" clears it."
    },
    "checklist_id": {
      "type": "string",
      "description": "The checklist note's segment ID (checklist_id from trip_checklists)."
    }
  },
  "additionalProperties": false
}

checklist_items_add

Add one or more tasks to the end of an existing trip checklist. Get checklist_id from trip_checklists. Each item has text and an optional category (the section heading it appears under). A checklist holds at most 100 tasks; tasks are a flat list with no subtasks. Calling this twice adds the tasks twice. To create a new checklist use segment_create (type Note, isChecklist true). Never show IDs to users.

Argument	Type	Description
items*	array	Tasks to append, in order.
checklist_id*	string	The checklist note's segment ID (checklist_id from trip_checklists).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "checklist_id",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text"
        ],
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "The task text."
          },
          "category": {
            "type": "string",
            "maxLength": 40,
            "description": "Optional section heading, e.g. Clothing or Documents."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Tasks to append, in order."
    },
    "checklist_id": {
      "type": "string",
      "description": "The checklist note's segment ID (checklist_id from trip_checklists)."
    }
  },
  "additionalProperties": false
}

checklist_items_remove

Permanently remove one or more tasks from a trip checklist. Get checklist_id and the item IDs from trip_checklists. Confirm with the user before removing. To delete a whole checklist use segment_delete. Never show IDs to users.

destructive

Argument	Type	Description
item_ids*	array	IDs of the tasks to remove (itemId from trip_checklists).
checklist_id*	string	The checklist note's segment ID (checklist_id from trip_checklists).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "checklist_id",
    "item_ids"
  ],
  "properties": {
    "item_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "IDs of the tasks to remove (itemId from trip_checklists).",
      "uniqueItems": true
    },
    "checklist_id": {
      "type": "string",
      "description": "The checklist note's segment ID (checklist_id from trip_checklists)."
    }
  },
  "additionalProperties": false
}

checklist_items_reorder

Put a trip checklist's tasks in a new order. Get checklist_id and the item IDs from trip_checklists, then send order listing every task ID exactly once in the new order. The app groups tasks under their section headings in first-appearance order. Never show IDs to users.

destructive

Argument	Type	Description
order*	array	Every task ID on the checklist, in the new order.
checklist_id*	string	The checklist note's segment ID (checklist_id from trip_checklists).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "checklist_id",
    "order"
  ],
  "properties": {
    "order": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Every task ID on the checklist, in the new order.",
      "uniqueItems": true
    },
    "checklist_id": {
      "type": "string",
      "description": "The checklist note's segment ID (checklist_id from trip_checklists)."
    }
  },
  "additionalProperties": false
}

cities_search

Search the saved city catalog by city name or alias before adding a city to a trip. Matches whole names, name prefixes and word starts (not text inside a word), exact matches first. Pass country to limit results to one country. An empty result does not mean the place does not exist: trip_city_add can add a real town or island that is missing from the catalog when you pass city_name and country. Returns stored city IDs and location details. Search results do not add or select a city.

read-only

Argument	Type	Description
limit	integer	Maximum number of results, from 1 to 50. Defaults to 10.
query*	string	City name or alias to search; two to 100 characters after trimming.
country	string	Optional country name or ISO code (for example CR or Costa Rica) to limit results to that country. Pass it whenever the user named a country.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of results, from 1 to 50. Defaults to 10."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "City name or alias to search; two to 100 characters after trimming."
    },
    "country": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional country name or ISO code (for example CR or Costa Rica) to limit results to that country. Pass it whenever the user named a country."
    }
  },
  "additionalProperties": false
}

cruise_create

Preview and commit cruise create operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "CreateCruise"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "groupId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "shipName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinDeck": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinType": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "eventName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "occupancy": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "cruiseLine": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "voyageNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "leadPassenger": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "contactAddress": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkPortName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkTerminal": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "onboardCredits": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "bookingReference": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "itineraryEndDate": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "disembarkPortName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "reservationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cancellationPolicy": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "itineraryStartDate": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "clientId",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "AddDay"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "dock": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "port": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "dayType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Use Embarkation, SeaDay, Port, ScenicCruising or Disembarkation for these known meanings. Preserve unfamiliar stored or source labels verbatim; do not coerce them to Port or SeaDay."
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "dayNumber": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "timeBasis": {
                        "enum": [
                          "Unknown",
                          "PortLocal",
                          "ShipTime",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "portCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isTenderPort": {
                        "type": [
                          "boolean",
                          "null"
                        ],
                        "description": "true means tender; false means docked; null means unknown."
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "dayNumberBasis": {
                        "enum": [
                          "LegacyCalendarDate",
                          "OfficialSequence",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "excursionNotes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portTimezoneId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "arrivalTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "allAboardTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "departureTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "isOvernightPortCall": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "additionalProperties": false
                  },
                  "clientId": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_day_create

Preview and commit cruise day create operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "clientId",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "AddDay"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "dock": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "port": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "dayType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Use Embarkation, SeaDay, Port, ScenicCruising or Disembarkation for these known meanings. Preserve unfamiliar stored or source labels verbatim; do not coerce them to Port or SeaDay."
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "dayNumber": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "timeBasis": {
                        "enum": [
                          "Unknown",
                          "PortLocal",
                          "ShipTime",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "portCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isTenderPort": {
                        "type": [
                          "boolean",
                          "null"
                        ],
                        "description": "true means tender; false means docked; null means unknown."
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "dayNumberBasis": {
                        "enum": [
                          "LegacyCalendarDate",
                          "OfficialSequence",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "excursionNotes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portTimezoneId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "arrivalTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "allAboardTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "departureTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "isOvernightPortCall": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "additionalProperties": false
                  },
                  "clientId": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_day_delete

Preview and commit cruise day delete operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "DeleteDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_day_restore

Preview and commit cruise day restore operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "RestoreDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_day_update

Preview and commit cruise day update operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "UpdateDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "dock": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "port": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "dayType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Use Embarkation, SeaDay, Port, ScenicCruising or Disembarkation for these known meanings. Preserve unfamiliar stored or source labels verbatim; do not coerce them to Port or SeaDay."
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "dayNumber": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "timeBasis": {
                        "enum": [
                          "Unknown",
                          "PortLocal",
                          "ShipTime",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "portCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isTenderPort": {
                        "type": [
                          "boolean",
                          "null"
                        ],
                        "description": "true means tender; false means docked; null means unknown."
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "dayNumberBasis": {
                        "enum": [
                          "LegacyCalendarDate",
                          "OfficialSequence",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "excursionNotes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portTimezoneId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "arrivalTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "allAboardTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "departureTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "isOvernightPortCall": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_delete

Preview and commit cruise delete operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "DeleteCruise"
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_get

Read the complete commercial Cruise and linked CruiseDay fields, including soft-deleted items and version. Omit cruiseId to read the trip version before creation. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

read-only

Argument	Type	Description
tripId*	string
cruiseId	string \| null

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tripId"
  ],
  "properties": {
    "tripId": {
      "type": "string",
      "format": "uuid"
    },
    "cruiseId": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

cruise_reorder

Preview and commit cruise reorder operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayIds"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "ReorderDays"
                  },
                  "dayIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "Every live cruise day ID exactly once in the desired order. Reordering preserves dates and day numbers.",
                    "uniqueItems": true
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_restore

Preview and commit cruise restore operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "RestoreCruise"
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

cruise_update

Preview and commit cruise update operations atomically. First call cruise_get for expectedVersion. Omit confirmationToken to preview, show the changes to the user, then repeat the unchanged request with its token only after the user approves. Reuse idempotencyKey for retries. Omitting a field preserves it; null clears nullable fields. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification.

destructive

Argument	Type	Description
request*	object
confirmationToken	string	Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "tripId",
        "idempotencyKey",
        "expectedVersion",
        "operations",
        "cruiseId"
      ],
      "properties": {
        "tripId": {
          "type": "string",
          "format": "uuid"
        },
        "cruiseId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "operations": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "UpdateCruise"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "groupId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "shipName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinDeck": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinType": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "eventName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "occupancy": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "cruiseLine": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cabinNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "voyageNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "leadPassenger": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "contactAddress": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkPortName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkTerminal": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "onboardCredits": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "embarkTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "bookingReference": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "itineraryEndDate": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "disembarkPortName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "reservationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cancellationPolicy": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "disembarkTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "itineraryStartDate": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "clientId",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "AddDay"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "dock": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "port": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "dayType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Use Embarkation, SeaDay, Port, ScenicCruising or Disembarkation for these known meanings. Preserve unfamiliar stored or source labels verbatim; do not coerce them to Port or SeaDay."
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "dayNumber": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "timeBasis": {
                        "enum": [
                          "Unknown",
                          "PortLocal",
                          "ShipTime",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "portCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isTenderPort": {
                        "type": [
                          "boolean",
                          "null"
                        ],
                        "description": "true means tender; false means docked; null means unknown."
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "dayNumberBasis": {
                        "enum": [
                          "LegacyCalendarDate",
                          "OfficialSequence",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "excursionNotes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portTimezoneId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "arrivalTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "allAboardTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "departureTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "isOvernightPortCall": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "additionalProperties": false
                  },
                  "clientId": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId",
                  "fields"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "UpdateDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "fields": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "cost": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "dock": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "port": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "enum": [
                          "Tentative",
                          "Confirmed",
                          "Cancelled",
                          "Completed",
                          "PendingCompletion"
                        ],
                        "type": "string"
                      },
                      "dayType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Use Embarkation, SeaDay, Port, ScenicCruising or Disembarkation for these known meanings. Preserve unfamiliar stored or source labels verbatim; do not coerce them to Port or SeaDay."
                      },
                      "website": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portCity": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portName": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "dayNumber": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "sortOrder": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "timeBasis": {
                        "enum": [
                          "Unknown",
                          "PortLocal",
                          "ShipTime",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "endDateTime": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "portCountry": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactEmail": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "contactPhone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isTenderPort": {
                        "type": [
                          "boolean",
                          "null"
                        ],
                        "description": "true means tender; false means docked; null means unknown."
                      },
                      "startDateTime": {
                        "type": "string",
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "dayNumberBasis": {
                        "enum": [
                          "LegacyCalendarDate",
                          "OfficialSequence",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "excursionNotes": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "portTimezoneId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "arrivalTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "allAboardTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "confirmationNumber": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "departureTimeLocal": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Independent local date or date and time, YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss, without UTC offsets or conversion. Never invent missing times."
                      },
                      "isOvernightPortCall": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "DeleteDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayId"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "RestoreDay"
                  },
                  "dayId": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "dayIds"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "ReorderDays"
                  },
                  "dayIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "Every live cruise day ID exactly once in the desired order. Reordering preserves dates and day numbers.",
                    "uniqueItems": true
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          "maxItems": 250,
          "minItems": 1
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid"
        },
        "expectedVersion": {
          "type": "string",
          "minLength": 1,
          "description": "Exact version returned by cruise_get, including the trip-only read before creating a cruise."
        }
      },
      "additionalProperties": false
    },
    "confirmationToken": {
      "type": "string",
      "minLength": 1,
      "description": "Omit to preview. After the user reviews and approves the exact preview, repeat the unchanged request with its token to commit. Never manufacture approval."
    }
  },
  "additionalProperties": false
}

diagnose_failed_import

Triage a failed, held, or partially processed email import on the user's account. Returns the failure step, error message, likely reason, and actionable next steps.

read-only

Argument	Type	Description
trip_id	string	Optional trip ID to look up the most recent non-clean import for that trip.
import_id	string	Specific EmailImport ID to diagnose.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional trip ID to look up the most recent non-clean import for that trip."
    },
    "import_id": {
      "type": "string",
      "format": "uuid",
      "description": "Specific EmailImport ID to diagnose."
    }
  },
  "additionalProperties": false
}

discover

Search for hotels, restaurants, attractions, or activities to recommend to the traveler, returned as rich visual cards (image, rating, price level, link). Use this when the user wants suggestions or things to do/eat/stay near a place.

read-only

Argument	Type	Description
query	string	Optional refinement, such as "luxury", "family friendly", "tapas", or "museums".
category*	string	What to discover: hotels, restaurants, attractions, or activities.
latitude	number	Optional latitude to bias the search.
location	string	City or area to search in, such as "Madrid" or "Lisbon, Portugal". Provide this when latitude/longitude are unknown.
longitude	number	Optional longitude to bias the search.
max_results	integer	Max cards to return, 1-10. Defaults to 8.
check_in_date	string	Optional YYYY-MM-DD check-in date (hotels).
check_out_date	string	Optional YYYY-MM-DD check-out date (hotels).

duplicate_checklist

Duplicate a checklist into one or more new checklists on the same trip. Each copy keeps item text and sections; every item starts unchecked. Provide source_note_id (a checklist segment ID from trip_details) and one title per copy (max 10).

Argument	Type	Description
titles*	array	One title per copy (1 to 10, each up to 200 characters).
source_note_id*	string	ID of the checklist to copy (from trip_details).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source_note_id",
    "titles"
  ],
  "properties": {
    "titles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "One title per copy (1 to 10, each up to 200 characters)."
    },
    "source_note_id": {
      "type": "string",
      "description": "ID of the checklist to copy (from trip_details)."
    }
  }
}

estimate_transfer_drive_time

Estimate the drive time of a Transfer or Transport segment (taxi, car service, airport transfer, ground transport) from its pickup and drop-off at its pickup time, using Apple Maps traffic prediction. apply=false (default) only reports the estimate; apply=true saves it as the estimated drop-off time so the Tineo calendar and iCal feed show the real ride length instead of a flat hour. A drop-off time already on the booking or set by the user is never changed, and a failed lookup changes nothing. Present the result as an estimate.

Argument	Type	Description
apply	boolean	Save the estimate as the drop-off time. Default false.
segment_id*	string	ID of the Transfer or Transport segment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id"
  ],
  "properties": {
    "apply": {
      "type": "boolean",
      "description": "Save the estimate as the drop-off time. Default false."
    },
    "segment_id": {
      "type": "string",
      "description": "ID of the Transfer or Transport segment."
    }
  }
}

fetch

Use this when the user wants the full text for a specific Tineo search result. Pass an ID returned by search, such as trip:{id}, segment:{id}, travel-document:{id}, or document:{id}.

read-only

Argument	Type	Description
id*	string	ID returned by the search tool

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "ID returned by the search tool"
    }
  }
}

flight_booking_link

Return a Tineo redirect card for comparable flight search for a trip flight when affiliate flight deep links are enabled.

read-only

Argument	Type	Description
trip_id*	string	The trip ID that owns the flight.
segment_id	string	Optional flight segment ID to target.
flight_number	string	Optional flight number to target when segment_id is not known.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "The trip ID that owns the flight."
    },
    "segment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional flight segment ID to target."
    },
    "flight_number": {
      "type": "string",
      "description": "Optional flight number to target when segment_id is not known."
    }
  }
}

flight_quickadd

Look up a real flight by number and date, then create it as a segment in the trip. Combines flight_quickadd_lookup + segment_create in one call. May take 2-5 seconds due to external flight data lookup. Segment dates must fall within the parent trip dates; use trip_update first to extend the trip.

Argument	Type	Description
airline	string	Full airline name as fallback (e.g., 'American Airlines'). Used only if airline_code is not provided.
trip_id*	string	The trip ID to add the flight to
airline_code	string	IATA or ICAO airline code (AA, UA, DL, AAL). Optional if embedded in flight_number.
flight_number*	string	Flight number, e.g. 'AA3242', 'UA100', or just '3242' if airline_code is provided
departure_date*	string	Departure date in YYYY-MM-DD format

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "flight_number",
    "departure_date"
  ],
  "properties": {
    "airline": {
      "type": "string",
      "description": "Full airline name as fallback (e.g., 'American Airlines'). Used only if airline_code is not provided."
    },
    "trip_id": {
      "type": "string",
      "description": "The trip ID to add the flight to"
    },
    "airline_code": {
      "type": "string",
      "description": "IATA or ICAO airline code (AA, UA, DL, AAL). Optional if embedded in flight_number."
    },
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'AA3242', 'UA100', or just '3242' if airline_code is provided"
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date in YYYY-MM-DD format"
    }
  }
}

flight_quickadd_lookup

Look up flight details by airline, flight number, and departure date before creating or editing a flight segment. Use this when the user gives a flight number and wants to add, preview, or verify a flight.

read-only

Argument	Type	Description
airline	string	Optional airline name or callsign, such as American Airlines
airline_code	string	Optional IATA or ICAO airline code, such as AA, UA, DL, or AAL
flight_number*	string	Flight number, with or without the airline prefix, such as AA3242 or 3242
departure_date*	string	Local scheduled departure date in YYYY-MM-DD format

Input schema (JSON)

{
  "type": "object",
  "required": [
    "flight_number",
    "departure_date"
  ],
  "properties": {
    "airline": {
      "type": "string",
      "description": "Optional airline name or callsign, such as American Airlines"
    },
    "airline_code": {
      "type": "string",
      "description": "Optional IATA or ICAO airline code, such as AA, UA, DL, or AAL"
    },
    "flight_number": {
      "type": "string",
      "description": "Flight number, with or without the airline prefix, such as AA3242 or 3242"
    },
    "departure_date": {
      "type": "string",
      "description": "Local scheduled departure date in YYYY-MM-DD format"
    }
  }
}

flight_route_lookup

Find scheduled flights by route and date when the flight number is NOT known: origin airport, destination airport, local departure date, and optionally an airline. Returns matching flights with their flight numbers so the exact flight can then be added via flight_quickadd. Use flight_quickadd_lookup instead when the user already has the full flight number.

read-only

Argument	Type	Description
date*	string	Local departure date in YYYY-MM-DD format.
origin*	string	Departure airport IATA code, such as BUD.
destination*	string	Arrival airport IATA code, such as SKG.
airline_code	string	Optional IATA airline code filter, such as W6 for Wizz Air.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Local departure date in YYYY-MM-DD format."
    },
    "origin": {
      "type": "string",
      "description": "Departure airport IATA code, such as BUD."
    },
    "destination": {
      "type": "string",
      "description": "Arrival airport IATA code, such as SKG."
    },
    "airline_code": {
      "type": "string",
      "description": "Optional IATA airline code filter, such as W6 for Wizz Air."
    }
  }
}

flight_status_for_segment

Get current flight status for an existing flight segment in a user's trip. Use this when the user asks if a flight in their itinerary is delayed, canceled, on time, boarding, or has gate/terminal updates. Status is cached for a few minutes, so call it once per flight per answer; calling again for the same flight soon after returns the same result. The text says when the provider last updated the data.

read-only

Argument	Type	Description
id	string	Alias for segment_id
segment_id*	string	The flight segment ID from a trip itinerary or segment details result

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Alias for segment_id"
    },
    "segment_id": {
      "type": "string",
      "description": "The flight segment ID from a trip itinerary or segment details result"
    }
  }
}

forwarding_address_create

Create the authenticated user's personal Tineo forwarding address when they explicitly ask for one. Tineo reads email sent to that address and adds the travel bookings it finds to the user's trips, so the user can forward confirmations from any inbox or give it to a travel agent or booking site. Never replaces or changes an existing address: if one already exists it is returned unchanged. Use forwarding_address_get to read addresses without creating one.

Argument	Type	Description
confirmed*	boolean	Must be true, set only after the user explicitly asks to create a forwarding address.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "confirmed"
  ],
  "properties": {
    "confirmed": {
      "type": "boolean",
      "description": "Must be true, set only after the user explicitly asks to create a forwarding address."
    }
  },
  "additionalProperties": false
}

forwarding_address_get

Read the authenticated user's Tineo email forwarding addresses without changing anything. Returns the personal forwarding address when one exists, any other active personal addresses, and the universal [email protected] address, which works for mail forwarded from the user's primary or registered email. A personal address can also receive mail sent by an assistant or travel provider. If the user has no personal address and wants one, use forwarding_address_create after they ask for it.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

friend_request_accept

Accept an INCOMING pending friend request by request_id (from friend_requests_pending). This connects you and notifies the sender, so confirm with the user before calling.

destructive

Argument	Type	Description
request_id*	string	The incoming request id from friend_requests_pending.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "description": "The incoming request id from friend_requests_pending."
    }
  }
}

friend_request_decline

Decline an INCOMING pending friend request by request_id (from friend_requests_pending). Confirm with the user before calling.

destructive

Argument	Type	Description
request_id*	string	The incoming request id from friend_requests_pending.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "description": "The incoming request id from friend_requests_pending."
    }
  }
}

friend_request_resend

Resend the notification email for one of YOUR OUTGOING pending friend requests by request_id (from friend_requests_pending). This re-emails the recipient, so confirm with the user first and pass confirmed=true. Throttled on an escalating cadence (60s after the original send, 24h after the first resend) and capped at 2 total resends per request.

destructive

Argument	Type	Description
confirmed*	boolean	Must be true. Set only after the user confirms they want to resend.
request_id*	string	The outgoing request id from friend_requests_pending.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id",
    "confirmed"
  ],
  "properties": {
    "confirmed": {
      "type": "boolean",
      "description": "Must be true. Set only after the user confirms they want to resend."
    },
    "request_id": {
      "type": "string",
      "description": "The outgoing request id from friend_requests_pending."
    }
  }
}

friend_request_send

Send a friend request to another user by user_id, or by email. This emails a real person, so ALWAYS confirm the recipient with the user before calling, and pass confirmed=true only once they agree. Provide exactly one of user_id or email. If the email belongs to someone not on Tineo, an invitation to join is sent instead. For privacy, the email path always reports the same neutral result whether or not the address is registered.

destructive

Argument	Type	Description
email	string	Target email address. Provide this OR user_id, not both.
message	string	Optional personal note (max 280 chars).
user_id	string	Target user id (e.g. from friends_list or a suggestion). Provide this OR email, not both.
confirmed*	boolean	Must be true. Set only after the user has confirmed they want to send this request/invite.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "confirmed"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Target email address. Provide this OR user_id, not both."
    },
    "message": {
      "type": "string",
      "description": "Optional personal note (max 280 chars)."
    },
    "user_id": {
      "type": "string",
      "description": "Target user id (e.g. from friends_list or a suggestion). Provide this OR email, not both."
    },
    "confirmed": {
      "type": "boolean",
      "description": "Must be true. Set only after the user has confirmed they want to send this request/invite."
    }
  }
}

friend_requests_pending

List the authenticated user's pending friend requests, split into incoming (awaiting your response) and outgoing (awaiting the other person). Returns the counterpart's name only, never their email. Use the returned request_id with friend_request_accept / friend_request_decline / friend_request_resend.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

friends_list

List the authenticated user's accepted friends (paged). Returns each friend's name, home location, your label for them (Friend/Family) and your two-way trip-sharing state. Never returns other users' email addresses.

read-only

Argument	Type	Description
page	integer	1-based page number. Default 1.
search	string	Optional case-insensitive name filter.
page_size	integer	Friends per page (max 50). Default 20.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based page number. Default 1."
    },
    "search": {
      "type": "string",
      "description": "Optional case-insensitive name filter."
    },
    "page_size": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Friends per page (max 50). Default 20."
    }
  }
}

generate_packing_list

Create a weather- and activity-aware packing checklist for a trip, grouped into sections and saved as a pinned checklist note. Never changes an existing list: if one already exists it is returned unchanged; use packing_list_regenerate to replace it. Requires the trip to have a destination or at least one itinerary item. Provide the trip_id from trips_list. For one list per person, pass people (max 6). Tineo builds the list on its servers with its AI model provider, sending the trip's title, dates, destinations, itinerary items, weather forecast, any context_notes, and each person's age band and notes (never their name).

Argument	Type	Description
people	array	Optional. One personalized list per person (max 6), titled with the person's name.
trip_id*	string	Tineo trip ID (from trips_list).
context_notes	string	Optional packing-relevant details the user asked to include, such as planned activities or special gear. Pass only what the user wants reflected in the list. Never include health conditions, medical details or other sensitive personal information.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "age_band"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Person's name or a label such as \"Kid 1\". Used only as the list's title; never sent to the AI model provider."
          },
          "notes": {
            "type": "string",
            "maxLength": 1000,
            "description": "Optional packing-relevant details for this person that the user asked to include. Never include health conditions, medical details or other sensitive personal information."
          },
          "age_band": {
            "enum": [
              "adult",
              "teen",
              "child",
              "toddler",
              "infant"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 6,
      "description": "Optional. One personalized list per person (max 6), titled with the person's name."
    },
    "trip_id": {
      "type": "string",
      "description": "Tineo trip ID (from trips_list)."
    },
    "context_notes": {
      "type": "string",
      "maxLength": 1000,
      "description": "Optional packing-relevant details the user asked to include, such as planned activities or special gear. Pass only what the user wants reflected in the list. Never include health conditions, medical details or other sensitive personal information."
    }
  },
  "additionalProperties": false
}

get_day_of_travel_brief

Get airport day-of-travel intelligence combining cached airport conditions and ground-transportation guides (trains, shuttles, taxis) for an airport code or flight segment.

read-only

Argument	Type	Description
iata_code	string	3-letter IATA airport code, such as ATL.
flight_segment_id	string	Optional flight segment ID (from trip_details) to check departure and arrival airports.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "iata_code": {
      "type": "string",
      "description": "3-letter IATA airport code, such as ATL."
    },
    "flight_segment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional flight segment ID (from trip_details) to check departure and arrival airports."
    }
  },
  "additionalProperties": false
}

get_flight_airport_conditions

Get cached airport conditions, delay indices, weather, and flight rules for an IATA airport code (e.g. "ORD") or a flight segment's departure and arrival airports. Cache-only: reads existing airport intelligence and never triggers an external fetch.

read-only

Argument	Type	Description
route_to	string	Optional destination IATA airport code when checking a specific route.
iata_code	string	3-letter IATA airport code, such as ORD or LHR.
flight_segment_id	string	Optional flight segment ID (from trip_details) to look up both departure and arrival conditions.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "route_to": {
      "type": "string",
      "description": "Optional destination IATA airport code when checking a specific route."
    },
    "iata_code": {
      "type": "string",
      "description": "3-letter IATA airport code, such as ORD or LHR."
    },
    "flight_segment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional flight segment ID (from trip_details) to look up both departure and arrival conditions."
    }
  },
  "additionalProperties": false
}

get_flight_change_history

Get recorded historical timeline of flight schedule changes, gate changes, and delays for flights monitored on the user's trips.

read-only

Argument	Type	Description
trip_id	string	Optional trip ID to filter changes for flights on that trip.
since_days	integer	Lookback window in days. Default 30.
flight_date	string	Optional flight departure date in YYYY-MM-DD format.
airline_code	string	Optional 2-letter airline code, such as UA.
flight_number	string	Optional flight number, such as 1234.
flight_segment_id	string	Optional flight segment ID.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional trip ID to filter changes for flights on that trip."
    },
    "since_days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Lookback window in days. Default 30."
    },
    "flight_date": {
      "type": "string",
      "format": "date",
      "description": "Optional flight departure date in YYYY-MM-DD format."
    },
    "airline_code": {
      "type": "string",
      "description": "Optional 2-letter airline code, such as UA."
    },
    "flight_number": {
      "type": "string",
      "description": "Optional flight number, such as 1234."
    },
    "flight_segment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional flight segment ID."
    }
  },
  "additionalProperties": false
}

get_routes

Compare available driving, transit, walking, and bicycling route summaries between two places using Google Maps. Returns duration and distance estimates for supported modes, plus Uber, Lyft, Waymo, and Google Maps handoff buttons for the destination. Set origin to 'home' for the user's saved home address. Ground time excludes airport check-in and security. Fares, detailed legs, flights, and ferries are unavailable.

read-only

Argument	Type	Description
time	string	ISO 8601 date-time with an explicit UTC offset. Required for leave_by or arrive_by; omit for leave_now.
modes	array	Modes to compare. Defaults to all four.
origin*	string	Starting place or address (1 to 300 characters), or 'home' for the user's private saved home address.
time_mode	string	When to travel. Default leave_now.
destination*	string	Ending place or address (1 to 300 characters).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination"
  ],
  "properties": {
    "time": {
      "type": "string",
      "description": "ISO 8601 date-time with an explicit UTC offset. Required for leave_by or arrive_by; omit for leave_now."
    },
    "modes": {
      "type": "array",
      "items": {
        "enum": [
          "driving",
          "transit",
          "walking",
          "bicycling"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "Modes to compare. Defaults to all four.",
      "uniqueItems": true
    },
    "origin": {
      "type": "string",
      "description": "Starting place or address (1 to 300 characters), or 'home' for the user's private saved home address."
    },
    "time_mode": {
      "enum": [
        "leave_now",
        "leave_by",
        "arrive_by"
      ],
      "type": "string",
      "description": "When to travel. Default leave_now."
    },
    "destination": {
      "type": "string",
      "description": "Ending place or address (1 to 300 characters)."
    }
  }
}

get_travel_stats

Get lifetime travel summary statistics across all owned and shared trips: total trips, completed trips, total segments, and segment counts by type.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_trip_expense_summary

Get trip spend totals, per-currency breakdowns, traveler balances, and calculated who-pays-whom settlement suggestions for a trip.

read-only

Argument	Type	Description
trip_id*	string	Tineo trip ID (from trips_list).
include_settlements	boolean	Whether to include optimal who-pays-whom settlement suggestions. Default true.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Tineo trip ID (from trips_list)."
    },
    "include_settlements": {
      "type": "boolean",
      "description": "Whether to include optimal who-pays-whom settlement suggestions. Default true."
    }
  },
  "additionalProperties": false
}

get_trip_weather

Get trip weather. Daily detail returns a city-grouped forecast bounded to trip dates with confidence tiers; current or hourly detail returns observed or near-term conditions for one trip city. Provide trip_id from trips_list. The Tineo itinerary already shows each day's weather and refreshes it automatically as the trip gets closer.

read-only

Argument	Type	Description
hours	integer	Hourly forecast horizon, default 12 hours. Used only when detail is hourly.
detail	string	Weather detail. Default daily.
city_id	string	Trip city ID, used for current or hourly weather. If omitted on a multi-city trip, the result lists available city IDs.
trip_id*	string	Tineo trip ID (from trips_list).
max_days	integer	Optional forecast horizon cap in days. Default 16.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "hours": {
      "type": "integer",
      "maximum": 48,
      "minimum": 1,
      "description": "Hourly forecast horizon, default 12 hours. Used only when detail is hourly."
    },
    "detail": {
      "enum": [
        "daily",
        "current",
        "hourly"
      ],
      "type": "string",
      "description": "Weather detail. Default daily."
    },
    "city_id": {
      "type": "string",
      "description": "Trip city ID, used for current or hourly weather. If omitted on a multi-city trip, the result lists available city IDs."
    },
    "trip_id": {
      "type": "string",
      "description": "Tineo trip ID (from trips_list)."
    },
    "max_days": {
      "type": "integer",
      "maximum": 35,
      "minimum": 1,
      "description": "Optional forecast horizon cap in days. Default 16."
    }
  }
}

ground_transfer_booking_links

Return Welcome Pickups and GetTransfer affiliate cards for a dated pickup and drop-off route. These are provider search or quote handoffs only, not live availability, prices, or confirmed bookings.

read-only

Argument	Type	Description
locale	string	Optional locale. Defaults to en.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.
passengers	integer	Optional passenger count. Defaults to 1.
pickup_date*	string	Local pickup date in YYYY-MM-DD format.
pickup_location*	string	Pickup airport, hotel, port, station, address, or place name.
dropoff_location*	string

import_parse_text_preview

Parse pasted travel confirmation text into proposed itinerary segments without saving anything. Use this before creating segments from copied email, PDF, or booking text.

read-only

Argument	Type	Description
text*	string	Travel confirmation, booking, or itinerary text to parse: one booking confirmation per call, or a few days of an itinerary. A whole trip page listing many bookings can exceed the 90-second parse limit, so split it. Raw text is used only for parsing and is not echoed back.
trip_id	string	Optional trip ID used only to verify access and give the parser trip context
user_hint	string	Optional user-provided context, such as provider name or expected segment type
max_segments	integer	Maximum number of segment previews to return, from 1 to 20. Defaults to 10.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Travel confirmation, booking, or itinerary text to parse: one booking confirmation per call, or a few days of an itinerary. A whole trip page listing many bookings can exceed the 90-second parse limit, so split it. Raw text is used only for parsing and is not echoed back."
    },
    "trip_id": {
      "type": "string",
      "description": "Optional trip ID used only to verify access and give the parser trip context"
    },
    "user_hint": {
      "type": "string",
      "description": "Optional user-provided context, such as provider name or expected segment type"
    },
    "max_segments": {
      "type": "integer",
      "description": "Maximum number of segment previews to return, from 1 to 20. Defaults to 10."
    }
  }
}

known_participants

Search people the authenticated user previously added to trips. Use before traveler_add, then obtain explicit invitation consent and confirm the email address.

read-only

Argument	Type	Description
names*	array	Names to match against prior trip participants.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "names"
  ],
  "properties": {
    "names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Names to match against prior trip participants."
    }
  }
}

library_list_clear_completed

Permanently delete every completed item from an owned Library List. Tell the user how many items will be removed; call with confirmed=true only after they confirm. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
listId*	string	Library List ID from library_lists_search or library_list_get.
confirmed*	boolean	True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "confirmed"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review."
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_delete

Delete an entire owned Library List and all of its items. Name the list to the user first; call with confirmed=true only after they confirm. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
listId*	string	Library List ID from library_lists_search or library_list_get.
confirmed*	boolean	True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "confirmed"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review."
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_get

Read one owned Tineo Library List, including every stable item UUID and its version. Read before editing; preserve fields the user did not ask to change. Never use trip segment IDs or guess list/item IDs.

read-only

Argument	Type	Description
listId*	string
itemType	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid"
    },
    "itemType": {
      "enum": [
        "list"
      ],
      "type": "string",
      "default": "list"
    }
  },
  "additionalProperties": false
}

library_list_item_add

Add one item to an owned Library List. Generate one new itemId UUID for the item and reuse it on retries, so a retried call never adds a duplicate. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

Argument	Type	Description
text*	string	The item's text.
itemId*	string	New caller-generated UUID for the item; reuse the same value when retrying.
listId*	string	Library List ID from library_lists_search or library_list_get.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "itemId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The item's text."
    },
    "itemId": {
      "type": "string",
      "format": "uuid",
      "description": "New caller-generated UUID for the item; reuse the same value when retrying."
    },
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_item_delete

Permanently delete one item from an owned Library List. Show the user the exact item first; call with confirmed=true only after they confirm. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
itemId*	string	Existing item ID from library_list_get.
listId*	string	Library List ID from library_lists_search or library_list_get.
confirmed*	boolean	True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "itemId",
    "confirmed"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "format": "uuid",
      "description": "Existing item ID from library_list_get."
    },
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review."
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_item_update

Change one existing item in an owned Library List (text, completed, color, notes, priority, dueDate), for example to check it off. Changes only the fields named in updateFields. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
itemId*	string	Existing item ID from library_list_get.
listId*	string	Library List ID from library_lists_search or library_list_get.
updates*	object	New values for the fields named in updateFields.
updateFields*	array	The fields the user asked to change. Only these keys of updates are applied. To clear a nullable field, name it here and set it to an empty string, only when the user asks to clear it.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "itemId",
    "updateFields",
    "updates"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "format": "uuid",
      "description": "Existing item ID from library_list_get."
    },
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "updates": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 2000,
          "minLength": 1
        },
        "color": {
          "type": "string",
          "maxLength": 64
        },
        "notes": {
          "type": "string",
          "maxLength": 4000
        },
        "dueDate": {
          "type": "string",
          "maxLength": 32
        },
        "priority": {
          "type": "string",
          "pattern": "^(low|medium|high)?$"
        },
        "completed": {
          "type": "boolean"
        }
      },
      "description": "New values for the fields named in updateFields.",
      "minProperties": 1,
      "additionalProperties": false
    },
    "updateFields": {
      "type": "array",
      "items": {
        "enum": [
          "text",
          "completed",
          "color",
          "notes",
          "priority",
          "dueDate"
        ],
        "type": "string"
      },
      "maxItems": 6,
      "minItems": 1,
      "description": "The fields the user asked to change. Only these keys of updates are applied. To clear a nullable field, name it here and set it to an empty string, only when the user asks to clear it.",
      "uniqueItems": true
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_items_add

Add several items to an owned Library List in one call, in order (for example a whole packing or to-do list). Give each item its own new itemId UUID and reuse the same values on retries, so a retried call never adds duplicates. Up to 100 items per call; split longer lists. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

Argument	Type	Description
items*	array	The new items in order.
listId*	string	Library List ID from library_lists_search or library_list_get.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "itemId",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 2000,
            "minLength": 1,
            "description": "The item's text."
          },
          "itemId": {
            "type": "string",
            "format": "uuid",
            "description": "New caller-generated UUID for this item; reuse the same value when retrying."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "The new items in order."
    },
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_items_reorder

Reorder the items of an owned Library List. orderedItemIds must contain every current item ID exactly once, in the new order. Show the user the proposed order first; call with confirmed=true only after they confirm. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
listId*	string	Library List ID from library_lists_search or library_list_get.
confirmed*	boolean	True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review.
orderedItemIds*	array	Every current item ID exactly once, in the new order.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "orderedItemIds",
    "confirmed"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms this exact change. Without it the tool changes nothing and returns the change for review."
    },
    "orderedItemIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 10000,
      "minItems": 1,
      "description": "Every current item ID exactly once, in the new order.",
      "uniqueItems": true
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_list_update

Change one owned Library List's own details (title, emoji, color, description). Changes only the fields named in updateFields; never touches the list's items. Use the listId and expectedVersion from the latest library_list_get. On library_version_mismatch, read the list again and reconsider the change; never retry blindly. Library Lists only, not trip checklists.

destructive

Argument	Type	Description
listId*	string	Library List ID from library_lists_search or library_list_get.
updates*	object	New values for the fields named in updateFields.
updateFields*	array	The fields the user asked to change. Only these keys of updates are applied. To clear a nullable field, name it here and set it to an empty string, only when the user asks to clear it.
expectedVersion*	string	Opaque version from the latest library_list_get or Library List tool result.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listId",
    "expectedVersion",
    "updateFields",
    "updates"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid",
      "description": "Library List ID from library_lists_search or library_list_get."
    },
    "updates": {
      "type": "object",
      "properties": {
        "color": {
          "type": "string",
          "maxLength": 64
        },
        "emoji": {
          "type": "string",
          "maxLength": 16,
          "minLength": 1
        },
        "title": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "description": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "description": "New values for the fields named in updateFields.",
      "minProperties": 1,
      "additionalProperties": false
    },
    "updateFields": {
      "type": "array",
      "items": {
        "enum": [
          "title",
          "emoji",
          "color",
          "description"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "The fields the user asked to change. Only these keys of updates are applied. To clear a nullable field, name it here and set it to an empty string, only when the user asks to clear it.",
      "uniqueItems": true
    },
    "expectedVersion": {
      "type": "string",
      "maxLength": 64,
      "minLength": 64,
      "description": "Opaque version from the latest library_list_get or Library List tool result."
    }
  },
  "additionalProperties": false
}

library_lists_search

Find the signed-in user's Tineo Library Lists by title or description. Return candidate IDs; when several titles match, ask the user to select one. These are freestanding Library Lists, separate from trip packing/checklists. Only lists are supported; do not invent journal, place or file edits.

read-only

Argument	Type	Description
limit	integer	Maximum candidates, 1..50. Omitted or zero uses 20.
query	string
offset	integer
itemType	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 0,
      "description": "Maximum candidates, 1..50. Omitted or zero uses 20."
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "itemType": {
      "enum": [
        "list"
      ],
      "type": "string",
      "default": "list"
    }
  },
  "additionalProperties": false
}

mentions_search

Typeahead search over the user's Tineo trips for composer @-mentions. Returns resource links to trips.

read-only

Argument	Type	Description
query*	string	Search text; may be empty.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Search text; may be empty."
    }
  },
  "additionalProperties": false
}

packing_list_regenerate

Regenerate a trip's existing packing checklist: replaces the generated items the user has not touched, and keeps every item the user checked, added or edited. Use only after the user asks to redo or refresh the list. With people, only those people's lists are regenerated (a person without a list gets a new one); a trip with no list yet gets a new one. Provide the trip_id from trips_list. Tineo builds the list on its servers with its AI model provider, sending the trip's title, dates, destinations, itinerary items, weather forecast, any context_notes, and each person's age band and notes (never their name).

destructive

Argument	Type	Description
people	array	Optional. One personalized list per person (max 6), titled with the person's name.
trip_id*	string	Tineo trip ID (from trips_list).
context_notes	string	Optional packing-relevant details the user asked to include, such as planned activities or special gear. Pass only what the user wants reflected in the list. Never include health conditions, medical details or other sensitive personal information.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "age_band"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Person's name or a label such as \"Kid 1\". Used only as the list's title; never sent to the AI model provider."
          },
          "notes": {
            "type": "string",
            "maxLength": 1000,
            "description": "Optional packing-relevant details for this person that the user asked to include. Never include health conditions, medical details or other sensitive personal information."
          },
          "age_band": {
            "enum": [
              "adult",
              "teen",
              "child",
              "toddler",
              "infant"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 6,
      "description": "Optional. One personalized list per person (max 6), titled with the person's name."
    },
    "trip_id": {
      "type": "string",
      "description": "Tineo trip ID (from trips_list)."
    },
    "context_notes": {
      "type": "string",
      "maxLength": 1000,
      "description": "Optional packing-relevant details the user asked to include, such as planned activities or special gear. Pass only what the user wants reflected in the list. Never include health conditions, medical details or other sensitive personal information."
    }
  },
  "additionalProperties": false
}

place_details

Look up a selected place ID for its name, address, map URL, coordinates, photos, and timezone when missing from places_search. Google rich business details are disabled: do not use this tool to answer opening-hours, open-now, price, website, phone, or rating questions. Missing fields mean unavailable, not closed or absent. Previously cached optional details may be stale.

read-only

Argument	Type	Description
language	string	Optional BCP 47 language code for place data
place_id*	string	The provider place ID returned by places_search

Input schema (JSON)

{
  "type": "object",
  "required": [
    "place_id"
  ],
  "properties": {
    "language": {
      "type": "string",
      "description": "Optional BCP 47 language code for place data"
    },
    "place_id": {
      "type": "string",
      "description": "The provider place ID returned by places_search"
    }
  }
}

places_search

Search for real-world places by text. Use this when the user needs to find a hotel, restaurant, venue, airport, station, port, parking location, or other place before adding or editing a trip segment.

read-only

Argument	Type	Description
query*	string	The place search text, such as a hotel name, restaurant, airport, venue, station, or full address
language	string	Optional BCP 47 language code for place data
max_results	integer	Maximum results to return, from 1 to 20. Defaults to 10.
included_type	string	Optional place type bias, such as lodging, restaurant, airport, train_station, parking, tourist_attraction, or point_of_interest
location_bias	object	Optional latitude/longitude used to bias search results
radius_meters	number	Optional radius in meters around location_bias

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The place search text, such as a hotel name, restaurant, airport, venue, station, or full address"
    },
    "language": {
      "type": "string",
      "description": "Optional BCP 47 language code for place data"
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum results to return, from 1 to 20. Defaults to 10."
    },
    "included_type": {
      "type": "string",
      "description": "Optional place type bias, such as lodging, restaurant, airport, train_station, parking, tourist_attraction, or point_of_interest"
    },
    "location_bias": {
      "type": "object",
      "required": [
        "latitude",
        "longitude"
      ],
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      },
      "description": "Optional latitude/longitude used to bias search results"
    },
    "radius_meters": {
      "type": "number",
      "description": "Optional radius in meters around location_bias"
    }
  }
}

Use this when the user wants to search their trips, itinerary segments, or travel documents by keyword. Returns citation-ready IDs, titles, and canonical URLs.

read-only

Argument	Type	Description
query*	string	Search query

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

search_airport_lounges

Requires Tineo Ultra access. Search Tineo's populated first-party airport-lounge catalog by IATA and optional terminal/gate. Returns terminal, concourse, stored gate reference, location, access, amenity, rating, and day-pass fields with categorical gate relevance (not walking distance).

read-only

Argument	Type	Description
gate	string	Optional gate, such as A17.
terminal	string	Optional terminal or concourse, such as Terminal 5 or Concourse A.
iata_code*	string	Required 3-letter IATA airport code, such as ATL.
max_results	integer	Maximum lounges returned. Default 10.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "iata_code"
  ],
  "properties": {
    "gate": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional gate, such as A17."
    },
    "terminal": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional terminal or concourse, such as Terminal 5 or Concourse A."
    },
    "iata_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Required 3-letter IATA airport code, such as ATL."
    },
    "max_results": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum lounges returned. Default 10."
    }
  },
  "additionalProperties": false
}

search_attractions

Search for popular tourist attractions, sights, landmarks, and things to do in a destination using TripAdvisor and Google Places. Returns attraction cards with ratings, descriptions, addresses, and ticket/experience links. Use when the user asks about top sights, landmarks, or attractions in a city.

read-only

Argument	Type	Description
limit	integer	Maximum number of attractions to return (max 10).
query*	string	Destination name, landmark, or attraction search term (e.g. 'Rome', 'Eiffel Tower', 'museums in London').
location	string	Optional city/area location filter.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of attractions to return (max 10)."
    },
    "query": {
      "type": "string",
      "description": "Destination name, landmark, or attraction search term (e.g. 'Rome', 'Eiffel Tower', 'museums in London')."
    },
    "location": {
      "type": "string",
      "description": "Optional city/area location filter."
    }
  }
}

search_flight_prices

Never send more than 3 search_flight_prices calls in one turn: calls beyond 3 are rejected without searching. Search for flight itineraries with prices between two airports on a date using Google Flights. Returns available itineraries with prices, durations, airlines, layovers, and ranked route-search actions. Ages 12-17 are mapped as adults where a provider requires it; ages 0-1 are infants whose lap-versus-seat placement and provider policy must be confirmed before booking. Each account runs one search at a time; the second and third wait their turn and still return results. When the user names several airports, destinations, dates or trip lengths, search the 1 to 3 most likely combinations first (or one outbound_end_date range of up to 7 days), show the results, then ask before searching more. A queued or slow search returns lookupStatus pending with retry_after_seconds; it keeps its place and finishes on its own, so repeat the identical call after that wait to get its result. When the user rules out airlines or connection airports/countries, pass include_airlines/exclude_airlines/avoid_connection_airports/avoid_connection_countries so excluded routes are removed. Fares carry no baggage allowance: never claim a fare includes bags.

read-only

Argument	Type	Description
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter currency code. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.
max_stops	integer	Optional maximum number of stops (0 = nonstop only, 1 = up to 1 stop).

search_hotels

Search for hotels and accommodations. Ordinary searches use the text query. Dated radius searches use a geographic bounding box and exact distance filter; SearchAPI does not apply the text query or style preferences within the radius. Provider coverage may be incomplete and prices may change. A hotel_place_id without radius_meters searches by the resolved hotel name; with radius_meters it searches nearby. Only a unique identity match retains its offer links.

read-only

Argument	Type	Description
limit	integer	Maximum number of hotel results to return (max 10).
query	string	Search query or destination city (e.g. 'hotels in Tokyo'). Required for ordinary hotel search. Google Hotels can mix in properties from nearby towns or districts; cards outside the searched place carry outsideRequestedArea and distanceFromAreaKm, and areaNote says how many. When the user wants a specific neighbourhood, get its coordinates or center_place_id from places_search and use a radius search. Radius search ignores this text in provider selection and filters by geography only. For hotel_place_id without radius_meters, the resolved property name is used for provider search and identity matching.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
check_in	string	Check-in date in YYYY-MM-DD format (alias: checkIn).
currency

search_tours

Search for bookable tours, activities, excursions, and experiences at a destination using GetYourGuide with Viator and Tiqets travelpayouts fallbacks. Returns tour options with titles, prices, ratings, durations, and booking links. Use when the user asks about things to do, tours, activities, excursions, or experiences in a city or destination. Search one destination per call.

read-only

Argument	Type	Description
date	string	Optional date in YYYY-MM-DD format to filter tours available on that day.
limit	integer	Maximum number of tour results to return (default 10, max 30).
query*	string	Search query for ONE destination, optionally with an activity type (e.g. 'walking tour Rome', 'snorkeling Cancun'). Never list several cities in one query: for a multi-city trip, call this tool once per city.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter currency code. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD.
provider	string

segment_associate_place

Attach a Google Place to an ALREADY-EXISTING segment retroactively — writes a place association and syncs the segment's address/city/country/coordinates from the place. Use when a segment has a venue/name but no address (e.g. imported from a ticket confirmation with venue-only data). Requires a place_id from places_search/place_details. For CarRental/Transfer segments pass role "origin" or "destination"; omit for single-location segments (Activity, Lodging, EventTicket, Parking), which default to "primary".

destructive

Argument	Type	Description
role	string	Which location this place represents. Default "primary".
place_id*	string	Google Place ID from a prior places_search/place_details call.
segment_id*	string	Segment ID (from segment_details/trip_details) to attach the place to.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id",
    "place_id"
  ],
  "properties": {
    "role": {
      "enum": [
        "primary",
        "origin",
        "destination"
      ],
      "type": "string",
      "description": "Which location this place represents. Default \"primary\"."
    },
    "place_id": {
      "type": "string",
      "maxLength": 450,
      "description": "Google Place ID from a prior places_search/place_details call."
    },
    "segment_id": {
      "type": "string",
      "description": "Segment ID (from segment_details/trip_details) to attach the place to."
    }
  },
  "additionalProperties": false
}

segment_booking_links

Return useful booking, reservation, ticket, check-in, itinerary, voucher, receipt, and travel-document links for one trip segment as booking_link_cards.

read-only

Argument	Type	Description
segment_id*	string	The segment ID to search for booking links.
classifications	array	Optional link classification filter, such as DirectReservation, CheckIn, ViewTickets, ManageBooking, ViewItinerary, or TravelDocuments.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id"
  ],
  "properties": {
    "segment_id": {
      "type": "string",
      "format": "uuid",
      "description": "The segment ID to search for booking links."
    },
    "classifications": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional link classification filter, such as DirectReservation, CheckIn, ViewTickets, ManageBooking, ViewItinerary, or TravelDocuments."
    }
  }
}

segment_create

Create a new segment in a trip. FIRST call segment_get_schema to get the required fields for the segment type. Required in fields, besides trip_id: Flight airline (or a flightNumber starting with the airline code, e.g. UA 123), departureAirportCode, arrivalAirportCode, startDateTime; Lodging propertyName, startDateTime; Activity title, startDateTime; EventTicket eventName, startDateTime; CarRental rentalCompany, startDateTime; Train and Ferry operator, departureCity, arrivalCity, startDateTime; Transfer provider, pickupLocation, dropoffLocation, startDateTime; Parking facilityName, startDateTime; Note title; Poll title, options. Then provide the trip_id, segment_type, and fields matching the schema. Segment dates must fall within the parent trip dates. Dates up to 1 day outside the trip extend it, with a warning; further out, call trip_update first. For an Activity, Lodging, EventTicket or Parking at a real place, call places_search first and put the result's place ID in fields.placeId: Tineo links that place (map pin and coordinates) and fills a missing name, address, phone and website. Never invent a time: if the user has not given or chosen one, ask, or send the date only (YYYY-MM-DD) in startDateTime and Tineo stores it as time not set. Send a clock time only when the user stated it or a booking shows it. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification. Cruise/CruiseDay generic writes require the dedicated cruise tools; their schemas and full reads remain available.

Argument	Type	Description
fields	object	Field values matching the schema for the segment type. Get schema first with segment_get_schema. Activity activityType is one of: tour, dining, show, spa, class, sports, sightseeing, other (other words are mapped or saved as other). title is optional for Flight, Lodging, Transfer, CarRental and Parking: Tineo derives one (e.g. "AA72 SYD → LAX", the property name, "Transfer to <dropoff>").

segment_delete

Delete a segment from a trip. This action cannot be undone. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification. Cruise/CruiseDay generic writes require the dedicated cruise tools; their schemas and full reads remain available.

destructive

Argument	Type	Description
segment_id*	string	The ID of the segment to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id"
  ],
  "properties": {
    "segment_id": {
      "type": "string",
      "description": "The ID of the segment to delete"
    }
  }
}

segment_details

Get full details for a specific trip segment. Returns complete information based on segment type: flight details (airline, flight number, airports, terminals, seats, baggage), hotel details (property, address, check-in/out times, room type, amenities), activity details (venue, tickets, timing), event ticket details (event name, venue, timing, vendor, order, confirmation), car rental details (company, vehicle, pickup/dropoff locations), or transfer details (provider, transfer type, pickup/dropoff locations, addresses, and local times). bookingContext describes whether Tineo can prepare an in-app reviewed change or needs the full editor; it is not a save confirmation or additional write authority.

read-only

Argument	Type	Description
segment_id*	string	The unique identifier of the segment to fetch details for

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id"
  ],
  "properties": {
    "segment_id": {
      "type": "string",
      "description": "The unique identifier of the segment to fetch details for"
    }
  }
}

segment_get_schema

Get the schema for a segment type. CALL THIS FIRST before creating/updating segments. Returns required fields and their types for the specified segment type. Supported types: Flight, Lodging, CarRental, Train, Transfer, Ferry, EventTicket, Parking, Activity, Note, Poll. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification. Cruise/CruiseDay generic writes require the dedicated cruise tools; their schemas and full reads remain available. Additional supported schemas: Cruise, CruiseDay, CruiseActivity.

read-only

Argument	Type	Description
segment_type*	string	The segment type to get schema for (Flight, Lodging, CarRental, Train, Transfer, Ferry, EventTicket, Parking, Activity, Note, Poll); also Cruise, CruiseDay and CruiseActivity

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_type"
  ],
  "properties": {
    "segment_type": {
      "type": "string",
      "description": "The segment type to get schema for (Flight, Lodging, CarRental, Train, Transfer, Ferry, EventTicket, Parking, Activity, Note, Poll); also Cruise, CruiseDay and CruiseActivity"
    }
  }
}

segment_link_add

Add a separate labeled, clickable URL (for example a restaurant Menu, online check-in, or directions link) to an ALREADY-EXISTING itinerary segment. Additive only: imported and existing links are never changed or removed, and an identical URL already on the segment is reported instead of duplicated. Find the segment first: call trips_list, then trip_details with sections ["segments"] on each candidate trip and match the segment by title or venue (keyword search can miss names), then confirm with the user. Returns the saved link and every link now on the segment.

Argument	Type	Description
url*	string	Absolute http(s) URL to add, such as a restaurant menu page.
label	string	Short button label shown for the link, such as "Menu", "Online Check-in", or "Directions".
link_type	string	Optional link category. Defaults to Other (use Other for menus and general websites).
segment_id*	string	Segment ID (from trip_details/segment_details) to add the link to.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "segment_id",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Absolute http(s) URL to add, such as a restaurant menu page."
    },
    "label": {
      "type": "string",
      "maxLength": 200,
      "description": "Short button label shown for the link, such as \"Menu\", \"Online Check-in\", or \"Directions\"."
    },
    "link_type": {
      "enum": [
        "CheckIn",
        "ManageBooking",
        "ViewTickets",
        "SelectSeats",
        "GetDirections",
        "CancelReservation",
        "ViewItinerary",
        "Other"
      ],
      "type": "string",
      "description": "Optional link category. Defaults to Other (use Other for menus and general websites)."
    },
    "segment_id": {
      "type": "string",
      "description": "Segment ID (from trip_details/segment_details) to add the link to."
    }
  },
  "additionalProperties": false
}

segment_update

Update an existing segment. Only provide the fields you want to change. Get field names from segment_get_schema if unsure. Segment dates must fall within the parent trip dates; use trip_update first to extend the trip. To change a checklist's tasks use checklist_items_add, checklist_item_update, checklist_items_remove or checklist_items_reorder (IDs from trip_checklists). The result lists the saved value of every field you sent, read back from Tineo, so do not call segment_details to confirm the change. On an Activity, Lodging, EventTicket or Parking, fields.placeId (a place_id from places_search) attaches that place the same way segment_associate_place does, replacing the stored address with the place's. Never invent a time: if the user has not given or chosen one, ask, or send the date only (YYYY-MM-DD) in startDateTime and Tineo stores it as time not set. Send a clock time only when the user stated it or a booking shows it. For commercial cruise reservations and sea/port days use cruise_* tools. Never substitute Activity, CruiseActivity or another segment type for a cruise day. Ordinary shore excursions remain valid Activity/CruiseActivity. If cruise tools are unavailable explain the limitation and ask for clarification. Cruise/CruiseDay generic writes require the dedicated cruise tools; their schemas and full reads remain available.

destructive

Argument	Type	Description
id	string	Alias for segment_id (widget compatibility)
fields	object	Field values to update. Only include fields that should be changed. Send null to clear an optional field; an empty string is ignored and the stored value is kept.
segment_id	string	The ID of the segment to update

Input schema (JSON)

settings_read

Reads the user's Tineo display and notification settings: units, date and time formats, flight monitoring, and trip reminder emails.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "additionalProperties": false
}

settings_update

Changes the user's Tineo display and notification settings. Only include settings the user asked to change.

destructive

Argument	Type	Description
set*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "set"
  ],
  "properties": {
    "set": {
      "type": "object",
      "properties": {
        "dateFormat": {
          "enum": [
            "Automatic",
            "Year-Month-Day",
            "Day/Month/Year",
            "Month/Day/Year"
          ],
          "type": "string"
        },
        "timeFormat": {
          "enum": [
            "Automatic",
            "12-hour",
            "24-hour"
          ],
          "type": "string"
        },
        "distanceUnit": {
          "enum": [
            "Automatic",
            "Kilometers",
            "Miles"
          ],
          "type": "string"
        },
        "temperatureUnit": {
          "enum": [
            "Automatic",
            "Celsius",
            "Fahrenheit"
          ],
          "type": "string"
        },
        "flightMonitoring": {
          "type": "boolean"
        },
        "tripReminderEmails": {
          "type": "boolean"
        }
      },
      "minProperties": 1,
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

support_ticket_create

Create a Tineo support ticket after the user explicitly asks or confirms and notify Tineo support by email. Use when the assistant cannot complete a request, a tool fails, or the requested capability is unsupported. Tineo attaches the user's app version, platform, device model and OS version automatically, so do not ask for them or list them as unknown.

destructive

Argument	Type	Description
source	string	Why the support ticket is being created.
summary*	string	Short support-ticket summary.
trip_id	string	Related trip ID, if known.
confirmed*	boolean	Must be true only after the user directly asks to create a ticket or confirms the assistant's offer.
segment_id	string	Related segment ID, if known.
attachments	array	Optional image attachments as base64 data URIs.
description*	string	User-facing explanation of what failed or could not be completed.
failure_context

tineo_ping

Check that Tineo is connected and the user is signed in. Returns the signed-in account's name and email; it does not list trips.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

train_booking_link

Return a train or bus search handoff between two cities, routed by region. Asian routes open 12Go with the route and date prefilled. European routes open the Omio route page (Madrid-Barcelona opens a prefilled search; Tokyo-Kyoto also gets the Omio page). Routes in other regions, such as the Americas, return no handoff. Confirm dates and passengers on the partner site; the card preserves the requested date for reference. No live fares, availability, or tickets are provided.

read-only

Argument	Type	Description
locale	string	Optional locale, such as en.
origin*	string	Departure city or station.
trip_id	string	Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user.
currency	string	Optional ISO-style three-letter display currency, such as EUR. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then EUR.
passengers	integer	Optional passenger count. Defaults to 1.
returnDate	string	Optional return date in YYYY-MM-DD format.

travel_document_assign_trip

Move or assign a travel document (insurance, visa, passport scan, voucher) to another trip the user OWNS, or back to the general library. Provide document_id from a documents listing and trip_id from trips_list. Omit trip_id (or pass null) to move the document to the library. Only trips the user owns are valid targets. The document's linked files move with it; a file also attached to another document is left in place and reported. If more than one document could match the request, confirm which one before moving. Returns the document, its previous and new trip, and how many linked files were re-pointed.

destructive

Argument	Type	Description
trip_id	any	Target trip id owned by the user; omit or null to unassign the document to the library.
document_id*	string	Id of the travel document to move.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "document_id"
  ],
  "properties": {
    "trip_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Target trip id owned by the user; omit or null to unassign the document to the library."
    },
    "document_id": {
      "type": "string",
      "description": "Id of the travel document to move."
    }
  }
}

traveler_add

Add a traveler only after known_participants and the user's explicit invitation decision. With an invitation, pass email and invite_confirmed=true; this creates and sends the trip invitation. If the user explicitly declines, omit email and pass invite_confirmed=false. If the email matches someone the user already added to a trip, that existing traveler's name is reused instead of creating a second identity for the same person.

destructive

Argument	Type	Description
name*	string	Traveler's display name
email	string	Confirmed invitation email. Required when invite_confirmed=true and forbidden when false.
trip_id*	string	The trip ID to add the traveler to
invite_confirmed*	boolean	True only after the user explicitly confirms sending an invitation. False only after they explicitly decline.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "name",
    "invite_confirmed"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Traveler's display name"
    },
    "email": {
      "type": "string",
      "description": "Confirmed invitation email. Required when invite_confirmed=true and forbidden when false."
    },
    "trip_id": {
      "type": "string",
      "description": "The trip ID to add the traveler to"
    },
    "invite_confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms sending an invitation. False only after they explicitly decline."
    }
  }
}

traveler_assign

Assign one or more travelers to one or more segments in a single call. To put the same travelers on several segments (for example every flight of a trip), pass all of them in segment_ids and all travelers in traveler_ids in one call instead of one call per segment. Up to 50 segments and 50 travelers per call, and at most 200 segment-traveler pairs. Assigning an already-assigned traveler is a no-op, and each segment succeeds or fails on its own: the result lists what was assigned and, per segment, what failed and why.

Argument	Type	Description
segment_id	string	One segment ID to assign travelers to. Use segment_ids for several.
segment_ids	array	Segment IDs to assign the same travelers to, in one call.
traveler_id	string	One trip traveler ID to assign. Use traveler_ids for several.
traveler_ids	array	Trip traveler IDs (from trip_travelers) to assign to every listed segment.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "segment_id": {
      "type": "string",
      "description": "One segment ID to assign travelers to. Use segment_ids for several."
    },
    "segment_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Segment IDs to assign the same travelers to, in one call."
    },
    "traveler_id": {
      "type": "string",
      "description": "One trip traveler ID to assign. Use traveler_ids for several."
    },
    "traveler_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Trip traveler IDs (from trip_travelers) to assign to every listed segment."
    }
  }
}

traveler_update_email

Correct one pending, unaccepted trip traveler's email after the owner supplies the exact traveler ID and new email. A changed address revokes the old link and automatically sends a renewed invitation. Report invitationSent truthfully; an unchanged address sends nothing.

destructive

Argument	Type	Description
email*	string	New email explicitly supplied by the owner
trip_id*	string	Trip ID owned by the caller
traveler_id*	string	Exact pending traveler ID from trip_travelers

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "traveler_id",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 320,
      "description": "New email explicitly supplied by the owner"
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID owned by the caller"
    },
    "traveler_id": {
      "type": "string",
      "format": "uuid",
      "description": "Exact pending traveler ID from trip_travelers"
    }
  },
  "additionalProperties": false
}

trip_booking_links

Return useful booking, reservation, ticket, check-in, itinerary, and affiliate flight-search links for a user's trip as booking_link_cards. Use this when the user asks for booking links, reservations, tickets, check-in, vouchers, receipts, or comparable flight-booking options.

read-only

Argument	Type	Description
trip_id*	string	The trip ID to search for booking links.
max_results	integer	Maximum number of booking-link cards to return. Defaults to 12 and is capped at 25.
segment_types	array	Optional segment type filter, such as Flight, Lodging, Activity, EventTicket, CarRental, Transfer, Train, Ferry, Parking, or CruiseActivity.
classifications	array	Optional link classification filter, such as DirectReservation, CheckIn, ViewTickets, ManageBooking, ViewItinerary, TravelDocuments, or FlightAffiliateSearch.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "The trip ID to search for booking links."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of booking-link cards to return. Defaults to 12 and is capped at 25."
    },
    "segment_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional segment type filter, such as Flight, Lodging, Activity, EventTicket, CarRental, Transfer, Train, Ferry, Parking, or CruiseActivity."
    },
    "classifications": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional link classification filter, such as DirectReservation, CheckIn, ViewTickets, ManageBooking, ViewItinerary, TravelDocuments, or FlightAffiliateSearch."
    }
  }
}

trip_checklists

Read every checklist on a trip with its items. Returns each checklist's title and, for every task, a stable itemId, text, category (section heading), position (0-based stored order; the app groups tasks under their section headings in first-appearance order), isChecked (complete for everyone on a shared trip) and checkedByMe (on a shared trip a task you ticked stays unchecked until every traveler ticks it). Tasks are a flat list: there are no subtasks or nested items. Pass checklist_id (the checklist's segment ID) to read just one checklist. Call this before editing items so you have the item IDs. To create a checklist use segment_create (type Note, isChecklist true, checklistItems [{text, category?}]). To change tasks use checklist_items_add (append tasks), checklist_item_update (text, category, or checked to mark done/not done), checklist_items_remove, or checklist_items_reorder, passing checklist_id and the item IDs. Delete a whole checklist with segment_delete. Never show IDs to users.

read-only

Argument	Type	Description
trip_id*	string	ID of the trip (from trips_list).
checklist_id	string	Optional. The checklist note's segment ID, to read just that one checklist.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "ID of the trip (from trips_list)."
    },
    "checklist_id": {
      "type": "string",
      "description": "Optional. The checklist note's segment ID, to read just that one checklist."
    }
  },
  "additionalProperties": false
}

trip_cities_list

List the ordered city associations for a trip. Returns trip_city_id values used by update, remove, and reorder.

read-only

Argument	Type	Description
trip_id*	string	Trip ID.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID."
    }
  }
}

trip_cities_reorder

Replace the trip city order using every current trip_city_id exactly once. The first city drives the automatic cover when an image is available.

destructive

Argument	Type	Description
trip_id*	string	Trip ID.
ordered_trip_city_ids*	array	Complete ordered list of current trip_city_id values.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "ordered_trip_city_ids"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID."
    },
    "ordered_trip_city_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Complete ordered list of current trip_city_id values."
    }
  }
}

trip_city_add

Add a city to the end of a trip's ordered city list. This is idempotent when an equivalent city is already present. Pass city_name plus country: names are matched against the catalog (including aliases), a major city that shares its name with smaller places resolves to the major one, and a real town or island missing from the catalog (for example Bijagua or Santorini) is looked up in that country and added automatically.

Argument	Type	Description
city_id	string	Exact city catalog ID. Provide this OR city_name.
country	string	Country name or ISO code (for example CR or Costa Rica). Strongly recommended with city_name: it disambiguates same-named cities and lets Tineo add a place that is missing from the catalog.
trip_id*	string	Trip ID.
city_name	string	City, town or island name. Provide this OR city_id; ambiguous names return candidates, so pass country as well.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "city_id": {
      "type": "string",
      "format": "uuid",
      "description": "Exact city catalog ID. Provide this OR city_name."
    },
    "country": {
      "type": "string",
      "description": "Country name or ISO code (for example CR or Costa Rica). Strongly recommended with city_name: it disambiguates same-named cities and lets Tineo add a place that is missing from the catalog."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID."
    },
    "city_name": {
      "type": "string",
      "description": "City, town or island name. Provide this OR city_id; ambiguous names return candidates, so pass country as well."
    }
  }
}

trip_city_remove

Remove one city association from a trip by trip_city_id. Confirm this destructive action with the user first.

destructive

Argument	Type	Description
trip_id*	string	Trip ID.
trip_city_id*	string	Trip-city association ID returned by trip_cities_list.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "trip_city_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID."
    },
    "trip_city_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip-city association ID returned by trip_cities_list."
    }
  }
}

trip_city_update

Replace one trip-city association with another city. This never edits the shared city catalog record.

destructive

Argument	Type	Description
city_id	string	Exact city catalog ID. Provide this OR city_name.
country	string	Country name or ISO code (for example CR or Costa Rica). Strongly recommended with city_name: it disambiguates same-named cities and lets Tineo add a place that is missing from the catalog.
trip_id*	string	Trip ID.
city_name	string	City, town or island name. Provide this OR city_id; ambiguous names return candidates, so pass country as well.
trip_city_id*	string	Trip-city association ID returned by trip_cities_list.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "trip_city_id"
  ],
  "properties": {
    "city_id": {
      "type": "string",
      "format": "uuid",
      "description": "Exact city catalog ID. Provide this OR city_name."
    },
    "country": {
      "type": "string",
      "description": "Country name or ISO code (for example CR or Costa Rica). Strongly recommended with city_name: it disambiguates same-named cities and lets Tineo add a place that is missing from the catalog."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip ID."
    },
    "city_name": {
      "type": "string",
      "description": "City, town or island name. Provide this OR city_id; ambiguous names return candidates, so pass country as well."
    },
    "trip_city_id": {
      "type": "string",
      "format": "uuid",
      "description": "Trip-city association ID returned by trip_cities_list."
    }
  }
}

trip_cover_update

Set a trip's cover photo from an image URL or a place_photo_reference returned by places_search/place_details. Becomes the trip's hero image immediately. Provide the trip_id from trips_list.

destructive

Argument	Type	Description
trip_id*	string	Tineo trip ID (from trips_list).
image_url	string	Direct https:// image URL to use as the cover. Provide this or place_photo_reference.
place_photo_reference	string	A photoReference from a places_search/place_details photos entry. Provide this or image_url.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "Tineo trip ID (from trips_list)."
    },
    "image_url": {
      "type": "string",
      "maxLength": 1024,
      "description": "Direct https:// image URL to use as the cover. Provide this or place_photo_reference."
    },
    "place_photo_reference": {
      "type": "string",
      "maxLength": 1000,
      "description": "A photoReference from a places_search/place_details photos entry. Provide this or image_url."
    }
  },
  "additionalProperties": false
}

trip_create

Create a new trip with explicit start_date and end_date (YYYY-MM-DD), covering its planned segments. Returns its ID; the authenticated user becomes the owner.

Argument	Type	Description
title*	string	Trip title MUST be a human-readable destination name (e.g. 'Barcelona', 'Tokyo & Kyoto (Oct 2026)'). DO NOT use hyphenated airport corridor codes (e.g. 'DAC-IST-BCN-IST-DAC-CXB'). If unsure, provide destination city name or leave generic.
end_date*	string	Trip end date in YYYY-MM-DD format
start_date*	string	Trip start date in YYYY-MM-DD format
description	string	Optional trip description or notes, up to 1000 characters (keep it under about 900)
destination	string	Primary destination city or region

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "start_date",
    "end_date"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200,
      "description": "Trip title MUST be a human-readable destination name (e.g. 'Barcelona', 'Tokyo & Kyoto (Oct 2026)'). DO NOT use hyphenated airport corridor codes (e.g. 'DAC-IST-BCN-IST-DAC-CXB'). If unsure, provide destination city name or leave generic."
    },
    "end_date": {
      "type": "string",
      "description": "Trip end date in YYYY-MM-DD format"
    },
    "start_date": {
      "type": "string",
      "description": "Trip start date in YYYY-MM-DD format"
    },
    "description": {
      "type": "string",
      "maxLength": 1000,
      "description": "Optional trip description or notes, up to 1000 characters (keep it under about 900)"
    },
    "destination": {
      "type": "string",
      "maxLength": 200,
      "description": "Primary destination city or region"
    }
  },
  "additionalProperties": false
}

trip_delete

Delete a trip owned by the authenticated user and its itinerary segments. Requires confirmed=true after explicit user confirmation. Also removes connected calendar events when automatic sync is enabled.

destructive

Argument	Type	Description
trip_id*	string	ID of the trip to delete.
confirmed*	boolean	True only after the user explicitly confirms deleting this trip and its itinerary.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "confirmed"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "ID of the trip to delete."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms deleting this trip and its itinerary."
    }
  },
  "additionalProperties": false
}

trip_details

Get detailed information about a specific trip. The text response includes the trip summary plus a chronological list of every segment (flights, hotels, activities, etc.) with each segment_id, so you can chain directly to segment_details, segment_update, segment_delete, or flight_status_for_segment without another search. Also includes traveler count. For full per-segment details, use segment_details with the returned segment_id. Use sections and segment_types to filter the response.

read-only

Argument	Type	Description
trip_id*	string	The unique identifier of the trip to fetch details for
sections	array	Optional: filter which sections to include in the response. Values: 'segments', 'travelers'. Default: all sections.
segment_types	array	Optional: filter segments by type. Values: Flight, Lodging, CarRental, Train, Transfer, Ferry, EventTicket, Parking, Activity, Note, Poll. Default: all types.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "The unique identifier of the trip to fetch details for"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: filter which sections to include in the response. Values: 'segments', 'travelers'. Default: all sections."
    },
    "segment_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: filter segments by type. Values: Flight, Lodging, CarRental, Train, Transfer, Ferry, EventTicket, Parking, Activity, Note, Poll. Default: all types."
    }
  }
}

trip_expense_create

Add expenses to a trip's shared expense ledger, with who paid and how each is split. Uses the same rules as the Expenses screen in Tineo. For one expense, send description and amount; for several (a list of receipts, a spreadsheet, a whole trip's costs), send them all in expenses in one call, up to 50 per call, instead of one call per expense. Each item in expenses is added or rejected on its own; failed items come back by index with the reason, so resend only those. Get traveler IDs from trip_expenses_list. Defaults: payer is the user, date is today in the user's profile time zone, an equal split with everyone on the trip (all on the payer on a solo trip). Confirm the amounts, payers and splits with the user before calling; for a batch, confirm the list once.

Argument	Type	Description
date	string	Expense date, YYYY-MM-DD. Defaults to today in the user's profile time zone; send the user's local date when you know it.
notes	string
split	object	Who the cost belongs to. type payer = all of it is the payer's cost (no split). equal = divided evenly among participants (omit participants for everyone on the trip). percentage = each participant's percentage, summing to 100. exact = each participant's amount, summing to the expense amount. To make an expense 100% one person's: if they paid, use type payer with paid_by set to them; if someone else paid, use percentage with only that person at 100.
amount	number	Total amount, greater than 0.
vendor	string	Merchant or vendor.
paid_by

trip_expense_update

Change an existing trip expense: amount, description, date, category, who paid, or how it is split (for example, make an expense 100% one person's). Get the expense ID and traveler IDs from trip_expenses_list. Send only the fields that change; a split replaces the whole split. Changing the amount of an equal or percentage split keeps the same people and proportions. Only the trip owner or an editor can edit expenses.

destructive

Argument	Type	Description
date	string	Expense date, YYYY-MM-DD.
notes	string
split	object	Who the cost belongs to. type payer = all of it is the payer's cost (no split). equal = divided evenly among participants (omit participants for everyone on the trip). percentage = each participant's percentage, summing to 100. exact = each participant's amount, summing to the expense amount. To make an expense 100% one person's: if they paid, use type payer with paid_by set to them; if someone else paid, use percentage with only that person at 100.
amount	number	Total amount, greater than 0.
vendor	string	Merchant or vendor.
paid_by	string	Traveler ID from trip_expenses_list travelers, or "me".
category	string

trip_expenses_list

List a trip's individual expenses with who paid and how each is split, plus the trip's travelers (ID, name, and which one is the user). Use it to find an expense or traveler ID before trip_expense_update or trip_expense_create. For totals and who owes whom use get_trip_expense_summary.

read-only

Argument	Type	Description
query	string	Optional words to match in the description, vendor or category.
trip_id*	string	Tineo trip ID (from trips_list).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional words to match in the description, vendor or category."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Tineo trip ID (from trips_list)."
    }
  },
  "additionalProperties": false
}

trip_rename

Rename a trip owned by the authenticated user. Returns the old and new titles. May synchronize the title to the trip owner's connected calendars when automatic sync is enabled.

destructive

Argument	Type	Description
trip_id*	string	The ID of the trip to rename
new_title*	string	The new trip title

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id",
    "new_title"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "The ID of the trip to rename"
    },
    "new_title": {
      "type": "string",
      "description": "The new trip title"
    }
  }
}

trip_restore

Restore a deleted trip owned by the authenticated user, together with the itinerary items that were removed when it was deleted (items deleted separately before that stay deleted). Call without trip_id to list recently deleted trips. Call with trip_id to preview the restore; nothing changes until the user explicitly confirms and you call again with confirmed=true. May re-add the trip to the owner's connected calendars when automatic sync is enabled.

Argument	Type	Description
trip_id	string	ID of the deleted trip to restore. Omit to list recently deleted trips.
confirmed	boolean	True only after the user explicitly confirms restoring this trip. Without it the tool only returns a preview.
expected_deleted_at	string	Optional deleted_at value from the preview. The restore is refused if the trip's deletion has changed since then.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "ID of the deleted trip to restore. Omit to list recently deleted trips."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only after the user explicitly confirms restoring this trip. Without it the tool only returns a preview."
    },
    "expected_deleted_at": {
      "type": "string",
      "format": "date-time",
      "description": "Optional deleted_at value from the preview. The restore is refused if the trip's deletion has changed since then."
    }
  },
  "additionalProperties": false
}

trip_sharing_get

Read who can see the user's own trips, one trip (trip_id) or every trip they own (paged). For each trip it reports the three sharing mechanisms separately: people with per-trip access (access edit/view/invited/none, where invited means an invitation awaits acceptance and can still be revoked; invitation status pending/accepted/declined/expired, level view/edit, and traveler role), whether a public view link is active, and the trip's own friend-sharing switches (hidden from friends, plans shared with friends; per trip, not account settings). Pass friend_user_id (from friends_list) to also get that friend's exact state on each trip: per-trip access, invitation, and whether they see the trip summary or full plan through friend sharing (planVisibleVia: friend_grant = the user shares plans with this friend on every trip, trip_grant = this trip shares plans with all friends, or both). Use this before trip_sharing_set and to report sharing status. Only the trip owner can read this. Revoked invitations are deleted, so they are not listed. Never show IDs to the user.

read-only

Argument	Type	Description
page	integer	1-based page when trip_id is omitted. Default 1.
trip_id	string	Optional trip ID. Omit to page through every trip the user owns.
page_size	integer	Trips per page (max 50). Default 25.
upcoming_only	boolean	Only trips that have not ended yet. Default false.
friend_user_id	string	Optional friend user_id from friends_list. Adds that friend's access on each trip.

trip_sharing_set

Give one friend view or edit access to the user's own trips, change their level, or remove it (access=none), for specific trips (trip_ids) or every trip the user owns (all_trips=true, 25 per page). Idempotent: it checks each trip first and only changes what differs, so re-running it never sends a duplicate invitation. New access is an invitation emailed to the friend, who gets access once they accept. Without confirmed=true nothing is written or emailed: it returns the plan per trip (would_invite, would_update_access, would_revoke, already_correct, already_invited, needs_attention). Show that plan, and call again with the same arguments plus confirmed=true only once the user has explicitly asked for this change, in this conversation or in the instructions of a scheduled task they set up; after they approve the plan, apply it without previewing or asking again. Results per trip: invited, invitation_updated, access_updated, revoked, already_correct, already_invited, needs_attention (with a reason, e.g. not the owner or access via the traveler list) or failed; report them to the user, describing invited trips as pending invitations rather than access already granted. Friend summaries are separate and never changed here: they follow the user's friend settings and each trip's hide-from-friends switch. Only friends can get access; for someone who is not a friend yet, offer friend_request_send first. If their friend request is still pending, the call changes nothing and returns friendRequest and a note: tell the user they haven't accepted yet, and only if the user still wants it, call again with confirmed=true and pending_friend_confirmed=true. Get friend_user_id from friends_list; never guess it from a name. Never show IDs to the user.

destructive

Argument	Type	Description
page	integer	With all_trips, the 1-based page of 25 trips. Default 1.
access*	string	view = can see the trip; edit = can change it; none = remove their per-trip access.

trip_travelers

Get the list of travelers/participants for a specific trip. Returns names, emails, roles, and which segments each traveler is assigned to.

read-only

Argument	Type	Description
trip_id*	string	The unique identifier of the trip to get travelers for

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "The unique identifier of the trip to get travelers for"
    }
  }
}

trip_update

Update trip dates, title, destination, or description for a trip the authenticated user can edit. May synchronize changes to the trip owner's connected calendars when automatic sync is enabled.

destructive

Argument	Type	Description
name	string	Alias for title
title	string	New trip title (e.g., 'Japan October 2026')
trip_id*	string	The ID of the trip to update
end_date	string	Trip end date in YYYY-MM-DD format
start_date	string	Trip start date in YYYY-MM-DD format
description	string	Optional trip description or notes, up to 1000 characters (keep it under about 900)
destination	string	Primary destination city or region
destination_scope	string	Required as 'trip' when changing destination on a trip that already has dated itinerary items.
destination_confirmed

trips_hub

Opens the Tineo trips app: browse current, upcoming, and past trips and open a trip's day-by-day itinerary. The user launches it from the ChatGPT sidebar or a conversation panel.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

trips_list

List the user's trips. Use this when the user wants to see their trips, search for a specific trip, or asks about their travel plans.

read-only

Argument	Type	Description
limit	integer	Maximum number of trips to return. Defaults to 10, max 50.
search	string	Search query to filter trips by destination, name, or location
status	string	Filter by trip status: all, upcoming, past, or ongoing. Defaults to all.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of trips to return. Defaults to 10, max 50."
    },
    "search": {
      "type": "string",
      "description": "Search query to filter trips by destination, name, or location"
    },
    "status": {
      "type": "string",
      "description": "Filter by trip status: all, upcoming, past, or ongoing. Defaults to all."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "maximum": 16,
      "minimum": 1
    },
    "infants": {
      "type": "integer",
      "maximum": 5,
      "minimum": 0,
      "description": "Infants under 2. Airbnb does not count them as guests."
    },
    "trip_id": {
      "type": "string",
      "description": "Tineo trip ID. Defaults below are derived from this trip when omitted."
    },
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD."
    },
    "children": {
      "type": "integer",
      "maximum": 5,
      "minimum": 0
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code (default USD)."
    },
    "location": {
      "type": "string",
      "description": "Optional override for the trip's destination."
    },
    "min_beds": {
      "type": "integer",
      "minimum": 0
    },
    "amenities": {
      "type": "array",
      "items": {
        "enum": [
          "wifi",
          "air_conditioning",
          "pool",
          "kitchen",
          "free_parking",
          "gym",
          "hot_tub",
          "heating",
          "washer",
          "dryer",
          "workspace",
          "ev_charger"
        ],
        "type": "string"
      },
      "description": "Only listings with ALL of these amenities. These are the only supported amenity filters; there is no keyword/free-text filter."
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date YYYY-MM-DD."
    },
    "price_max": {
      "type": "integer",
      "minimum": 0
    },
    "price_min": {
      "type": "integer",
      "minimum": 0
    },
    "room_type": {
      "enum": [
        "entire_home",
        "private_room",
        "shared_room"
      ],
      "type": "string"
    },
    "max_results": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Default 5, max 5."
    },
    "min_bedrooms": {
      "type": "integer",
      "minimum": 0
    },
    "min_bathrooms": {
      "type": "integer",
      "minimum": 0
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "location",
    "check_in",
    "check_out"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "maximum": 16,
      "minimum": 1
    },
    "infants": {
      "type": "integer",
      "maximum": 5,
      "minimum": 0,
      "description": "Infants under 2. Airbnb does not count them as guests."
    },
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD."
    },
    "children": {
      "type": "integer",
      "maximum": 5,
      "minimum": 0
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code (default USD)."
    },
    "location": {
      "type": "string",
      "description": "City, neighborhood, or landmark with its region and country (e.g., 'Lisbon, Portugal', 'Brooklyn, NY, USA', 'Orange, NSW, Australia')."
    },
    "min_beds": {
      "type": "integer",
      "minimum": 0
    },
    "amenities": {
      "type": "array",
      "items": {
        "enum": [
          "wifi",
          "air_conditioning",
          "pool",
          "kitchen",
          "free_parking",
          "gym",
          "hot_tub",
          "heating",
          "washer",
          "dryer",
          "workspace",
          "ev_charger"
        ],
        "type": "string"
      },
      "description": "Only listings with ALL of these amenities. These are the only supported amenity filters; there is no keyword/free-text filter."
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date YYYY-MM-DD."
    },
    "price_max": {
      "type": "integer",
      "minimum": 0
    },
    "price_min": {
      "type": "integer",
      "minimum": 0
    },
    "room_type": {
      "enum": [
        "entire_home",
        "private_room",
        "shared_room"
      ],
      "type": "string"
    },
    "max_results": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Default 5, max 5."
    },
    "min_bedrooms": {
      "type": "integer",
      "minimum": 0
    },
    "min_bathrooms": {
      "type": "integer",
      "minimum": 0
    }
  }
}

{
  "type": "object",
  "required": [
    "pickup_location",
    "pickup_date"
  ],
  "properties": {
    "locale": {
      "type": "string",
      "description": "Optional locale. Defaults to en."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user."
    },
    "currency": {
      "type": "string",
      "description": "Optional ISO-style three-letter display currency. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD."
    },
    "pickup_date": {
      "type": "string",
      "format": "date",
      "description": "Local pickup date in YYYY-MM-DD format."
    },
    "dropoff_date": {
      "type": "string",
      "format": "date",
      "description": "Optional local drop-off date in YYYY-MM-DD format."
    },
    "pickup_location": {
      "type": "string",
      "description": "Pickup city or airport, e.g. Lisbon or LIS. Prefer the airport IATA code when picking up at an airport."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "departure_airport",
    "arrival_airport",
    "outbound_date"
  ],
  "properties": {
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user."
    },
    "currency": {
      "type": "string",
      "description": "Optional ISO-style three-letter currency code. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD."
    },
    "max_stops": {
      "type": "integer",
      "description": "Optional maximum number of stops (0 = nonstop only, 1 = up to 1 stop)."
    },
    "child_ages": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 17,
        "minimum": 0
      },
      "description": "Age of each traveler under 18. Ages 12-17 are provider-mapped as adults where required; ages 2-11 are children and 0-1 are infants. Confirm lap-versus-seat placement with the user/provider for ages 0-1."
    },
    "adult_count": {
      "type": "integer",
      "default": 1,
      "maximum": 9,
      "minimum": 1,
      "description": "Number of adult travelers (default 1)."
    },
    "cabin_class": {
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "type": "string",
      "description": "Cabin class preference: 'economy', 'premium_economy', 'business', or 'first'. Default is 'economy'."
    },
    "return_date": {
      "type": "string",
      "description": "Optional return date in YYYY-MM-DD format for round-trip searches."
    },
    "outbound_date": {
      "type": "string",
      "description": "Outbound date in YYYY-MM-DD format. To compare several departure days, pass outbound_end_date in this one call rather than sending one call per day."
    },
    "arrival_airport": {
      "type": "string",
      "description": "Arrival airport IATA code, such as CDG."
    },
    "exclude_airlines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Remove itineraries with any flight on these airlines (IATA code, airline name, or alliance). Single-date searches only."
    },
    "include_airlines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Keep only itineraries where every flight is on one of these airlines: 2-character IATA code such as LH, airline name, or an alliance (Star Alliance, oneworld, SkyTeam). Single-date searches only."
    },
    "departure_airport": {
      "type": "string",
      "description": "Departure airport IATA code, such as JFK."
    },
    "outbound_end_date": {
      "type": "string",
      "description": "Optional inclusive end date for a cheapest-returned-fare-per-day calendar, up to 7 outbound dates beginning at outbound_date. Each day reports priced, no_results, failed, or not_searched; prices are live estimates and may change. Economy cabin only: omit cabin_class or use economy with a range."
    },
    "avoid_connection_airports": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Remove itineraries that connect at these airports (3-letter IATA codes). Single-date searches only."
    },
    "avoid_connection_countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Remove itineraries that connect in these countries (prefer ISO 3166 alpha-2 codes such as US, TR, RU; translate names to English). Single-date searches only."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of hotel results to return (max 10)."
    },
    "query": {
      "type": "string",
      "description": "Search query or destination city (e.g. 'hotels in Tokyo'). Required for ordinary hotel search. Google Hotels can mix in properties from nearby towns or districts; cards outside the searched place carry outsideRequestedArea and distanceFromAreaKm, and areaNote says how many. When the user wants a specific neighbourhood, get its coordinates or center_place_id from places_search and use a radius search. Radius search ignores this text in provider selection and filters by geography only. For hotel_place_id without radius_meters, the resolved property name is used for provider search and identity matching."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user."
    },
    "check_in": {
      "type": "string",
      "description": "Check-in date in YYYY-MM-DD format (alias: checkIn)."
    },
    "currency": {
      "type": "string",
      "description": "Optional ISO-style three-letter currency code. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Radius center latitude. Supply together with longitude instead of a place ID. Query may be omitted for a coordinate-only radius search."
    },
    "check_out": {
      "type": "string",
      "description": "Check-out date in YYYY-MM-DD format (alias: checkOut)."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Radius center longitude. Supply together with latitude instead of a place ID. Query may be omitted for a coordinate-only radius search."
    },
    "adult_count": {
      "type": "integer",
      "default": 1,
      "maximum": 9,
      "minimum": 1,
      "description": "Number of adults (alias: adults)."
    },
    "radius_meters": {
      "type": "integer",
      "maximum": 50000,
      "minimum": 100,
      "description": "Geographic search radius, default 1000 meters when center_place_id or coordinates are given. Requires stay dates and a center. Text query and style preferences are not applied to radius provider selection."
    },
    "hotel_place_id": {
      "type": "string",
      "description": "Optional specific hotel place ID. Searches priced inventory by hotel name, or nearby when radius_meters is supplied. Retains offer links only if identity is uniquely verified. Requires check_in and check_out."
    },
    "center_place_id": {
      "type": "string",
      "description": "Optional place ID for the radius center, from places_search. Requires check_in and check_out."
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {
    "id": {
      "type": "string",
      "description": "Alias for segment_id (widget compatibility)"
    },
    "fields": {
      "type": "object",
      "description": "Field values to update. Only include fields that should be changed. Send null to clear an optional field; an empty string is ignored and the stored value is kept."
    },
    "segment_id": {
      "type": "string",
      "description": "The ID of the segment to update"
    }
  },
  "additionalProperties": true
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "trip_id"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Expense date, YYYY-MM-DD. Defaults to today in the user's profile time zone; send the user's local date when you know it."
    },
    "notes": {
      "type": "string"
    },
    "split": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "enum": [
            "payer",
            "equal",
            "percentage",
            "exact"
          ],
          "type": "string"
        },
        "participants": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "traveler_id"
            ],
            "properties": {
              "amount": {
                "type": "number",
                "description": "Required for exact splits."
              },
              "percentage": {
                "type": "number",
                "description": "Required for percentage splits."
              },
              "traveler_id": {
                "type": "string",
                "description": "Traveler ID from trip_expenses_list travelers, or \"me\"."
              }
            },
            "additionalProperties": false
          }
        }
      },
      "description": "Who the cost belongs to. type payer = all of it is the payer's cost (no split). equal = divided evenly among participants (omit participants for everyone on the trip). percentage = each participant's percentage, summing to 100. exact = each participant's amount, summing to the expense amount. To make an expense 100% one person's: if they paid, use type payer with paid_by set to them; if someone else paid, use percentage with only that person at 100.",
      "additionalProperties": false
    },
    "amount": {
      "type": "number",
      "description": "Total amount, greater than 0."
    },
    "vendor": {
      "type": "string",
      "description": "Merchant or vendor."
    },
    "paid_by": {
      "type": "string",
      "description": "Traveler ID from trip_expenses_list travelers, or \"me\". Defaults to me."
    },
    "trip_id": {
      "type": "string",
      "format": "uuid",
      "description": "Tineo trip ID (from trips_list)."
    },
    "category": {
      "enum": [
        "Transportation",
        "Lodging",
        "CarRental",
        "Food",
        "Activities",
        "Shopping",
        "Insurance",
        "Communication",
        "Tips",
        "Fees",
        "Other"
      ],
      "type": "string"
    },
    "currency": {
      "type": "string",
      "description": "3-letter currency code. Defaults to the trip currency, else USD."
    },
    "expenses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "amount"
        ],
        "properties": {
          "date": {
            "type": "string",
            "description": "Expense date, YYYY-MM-DD. Defaults to today in the user's profile time zone; send the user's local date when you know it."
          },
          "notes": {
            "type": "string"
          },
          "split": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "payer",
                  "equal",
                  "percentage",
                  "exact"
                ],
                "type": "string"
              },
              "participants": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "traveler_id"
                  ],
                  "properties": {
                    "amount": {
                      "type": "number",
                      "description": "Required for exact splits."
                    },
                    "percentage": {
                      "type": "number",
                      "description": "Required for percentage splits."
                    },
                    "traveler_id": {
                      "type": "string",
                      "description": "Traveler ID from trip_expenses_list travelers, or \"me\"."
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "description": "Who the cost belongs to. type payer = all of it is the payer's cost (no split). equal = divided evenly among participants (omit participants for everyone on the trip). percentage = each participant's percentage, summing to 100. exact = each participant's amount, summing to the expense amount. To make an expense 100% one person's: if they paid, use type payer with paid_by set to them; if someone else paid, use percentage with only that person at 100.",
            "additionalProperties": false
          },
          "amount": {
            "type": "number",
            "description": "Total amount, greater than 0."
          },
          "vendor": {
            "type": "string",
            "description": "Merchant or vendor."
          },
          "paid_by": {
            "type": "string",
            "description": "Traveler ID from trip_expenses_list travelers, or \"me\". Defaults to me."
          },
          "category": {
            "enum": [
              "Transportation",
              "Lodging",
              "CarRental",
              "Food",
              "Activities",
              "Shopping",
              "Insurance",
              "Communication",
              "Tips",
              "Fees",
              "Other"
            ],
            "type": "string"
          },
          "currency": {
            "type": "string",
            "description": "3-letter currency code. Defaults to the trip currency, else USD."
          },
          "description": {
            "type": "string",
            "description": "What the expense was for, e.g. Travel insurance."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Several expenses in one call, each with the same fields as a single expense. Use instead of description and amount at the top level."
    },
    "description": {
      "type": "string",
      "description": "What the expense was for, e.g. Travel insurance."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "expense_id"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Expense date, YYYY-MM-DD."
    },
    "notes": {
      "type": "string"
    },
    "split": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "enum": [
            "payer",
            "equal",
            "percentage",
            "exact"
          ],
          "type": "string"
        },
        "participants": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "traveler_id"
            ],
            "properties": {
              "amount": {
                "type": "number",
                "description": "Required for exact splits."
              },
              "percentage": {
                "type": "number",
                "description": "Required for percentage splits."
              },
              "traveler_id": {
                "type": "string",
                "description": "Traveler ID from trip_expenses_list travelers, or \"me\"."
              }
            },
            "additionalProperties": false
          }
        }
      },
      "description": "Who the cost belongs to. type payer = all of it is the payer's cost (no split). equal = divided evenly among participants (omit participants for everyone on the trip). percentage = each participant's percentage, summing to 100. exact = each participant's amount, summing to the expense amount. To make an expense 100% one person's: if they paid, use type payer with paid_by set to them; if someone else paid, use percentage with only that person at 100.",
      "additionalProperties": false
    },
    "amount": {
      "type": "number",
      "description": "Total amount, greater than 0."
    },
    "vendor": {
      "type": "string",
      "description": "Merchant or vendor."
    },
    "paid_by": {
      "type": "string",
      "description": "Traveler ID from trip_expenses_list travelers, or \"me\"."
    },
    "category": {
      "enum": [
        "Transportation",
        "Lodging",
        "CarRental",
        "Food",
        "Activities",
        "Shopping",
        "Insurance",
        "Communication",
        "Tips",
        "Fees",
        "Other"
      ],
      "type": "string"
    },
    "currency": {
      "type": "string",
      "description": "3-letter currency code."
    },
    "expense_id": {
      "type": "string",
      "format": "uuid",
      "description": "Expense ID from trip_expenses_list."
    },
    "description": {
      "type": "string",
      "description": "What the expense was for, e.g. Travel insurance."
    }
  },
  "additionalProperties": false
}

Tineo

Registry entry

Try it

affiliate_program_catalog Read-only

Tineo

Registry entry

Try it

affiliate_program_catalog Read-only

Install

Tools (109)

Security checkA100/100