Start a full trip plan for a chosen cruise
start_cruise_planFor a traveler who has chosen a specific cruise (ship + departure date) and wants the whole trip planned around it: flights, hotels before and after the cruise, and every port day. Checks whether Cruise Planner(크루즈 플래너) knows this sailing and returns a link to the planner where the traveler continues. Ship names are matched exactly; one that does not match returns catalog_ships (exact English names by cruise line) with reason ship_not_in_catalog. Returns found / ambiguous / not_found. When found, sailing shows only nights and embarkation port (UN/LOCODE) to confirm the match. When ambiguous, each candidate shows only departure date, nights and that port; nights and embark_port narrow the match. Does not search, compare or price cruises; returns no itinerary, prices, cabins, ship details or sailing identifiers. planner.ui_language reports the UI language ("en" or "ko") of the returned link. planner.url carries the selection token and query parameters that keep the cruise selected.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ship_name": "<ship_name>",
"departure_date": "<departure_date>"
},
"name": "start_cruise_plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nights | No | Number of nights. Optional; helps when several sailings share the ship and date. | |
| ship_name | Yes | The exact English ship name, e.g. "MSC Bellissima" or "Norwegian Epic". Required. Matched exactly (case, spacing and punctuation ignored), not by similarity. A name that does not match returns the catalog ships (catalog_ships: English names by cruise line). | |
| embark_port | No | Embarkation port name or UN/LOCODE. Optional; helps when several sailings share the ship and date. | |
| sailing_ref | No | A cruise search provider's sailing reference for the chosen cruise, passed through as given. Optional. | |
| user_language | No | The traveler's language as a BCP 47 tag (e.g. "en", "ja", "ko", "zh-TW"). Korean (ko or ko-*) or a missing value opens Korean UI; English (en or en-*) and any other language or invalid tag opens English UI. Valid tags are used for anonymous usage statistics and preserved as a language hint in a chosen-cruise start link. It does not translate narrative answers or saved plan content. The returned ui_language reports the language actually used. | |
| departure_date | Yes | Embarkation date, YYYY-MM-DD, local date at the embarkation port. Required. |