CruiseHops
Search Carnival and Royal Caribbean cruises, compare fare history and find Viator port experiences.
Should I use this
Quality & Safety
A
Findings (1)
- LOWTool 'compare_sailings' description lacks action verbin compare_sailings
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~15,180Tokens (tool definitions)
~14.9 KBTypical response size
Significant attention impact (11.86% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"cruisehops": {
"url": "https://cruisehops.com/mcp"
}
}
}Remote endpoints
https://cruisehops.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_cruises(q, terms, departureTerms, nightsMin, nightsMax, ...)
Find cruise recommendations and deals on CruiseHops across Carnival and Royal Caribbean by destination, departure port, dates, cabin and budget. Returns sailing links for further exploration on CruiseHops. Research only; no widget. Default three choices. Do not add cabin or budget constraints the user did not give. Search captured cruise sailings using typed filters. Prices are USD cents per person for two guests, not live or family quotes. Filter before grouping and choosing lowest cabin price. Use term IDs from suggest_cruise_terms for precise names.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "search"
},
"selectedDepartureTerms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"label",
"unavailable"
],
"additionalProperties": false
}
},
"dateAlternatives": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"requestedDateFrom": {
"type": "string"
},
"requestedDateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"dateTo": {
"type": "string"
},
"flexibilityDays": {
"type": "number"
}
},
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"additionalProperties": false
},
"recovery": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"count": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"null"
]
}
}
},
"required": [
"id",
"label",
"count",
"changes"
],
"additionalProperties": false
}
},
"selectedTerms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"label",
"unavailable"
],
"additionalProperties": false
}
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"totalSailings": {
"type": "number"
},
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"selectedTerms",
"view",
"items",
"totalSailings",
"total",
"page",
"pageSize",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢suggest_cruise_terms(q, terms, departureTerms, nightsMin, nightsMax, ...)
Suggest matching ship, port, destination and cruise line names, including suffix words. Returns stable term IDs for search filters.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"q"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "suggestions"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
},
"sailingCount": {
"type": "number"
},
"resultCount": {
"type": "number"
},
"countUnit": {
"type": "string",
"enum": [
"groups",
"sailings"
]
}
},
"required": [
"id",
"kind",
"label",
"unavailable",
"sailingCount",
"resultCount",
"countUnit"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"nextCursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"items",
"total",
"nextCursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_departures(q, terms, departureTerms, nightsMin, nightsMax, ...)
List bounded, paginated unique dated sailings for a public ship-itinerary group ID. Preserves cabin/date filters; older event-specific group IDs remain supported.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
},
"groupId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Public ship-itinerary group ID from search_cruises items[].groupId; this is not a sailing ID. Older event-specific group IDs remain supported."
}
},
"required": [
"groupId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "departures"
},
"dateAlternatives": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"requestedDateFrom": {
"type": "string"
},
"requestedDateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"dateTo": {
"type": "string"
},
"flexibilityDays": {
"type": "number"
}
},
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"groupId",
"items",
"total",
"page",
"pageSize",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_sailing(sailingId, cabinClass, offerId, eventSelector, includeAmenities, ...)
Explore a CruiseHops sailing page: itinerary, cabin fares, price-history context and links to the website and official provider. Research only; no widget. Read sailing itinerary, cabin-filtered offers and booking URLs. Amenities and media are omitted by default; request them explicitly only when needed. No live availability or party total is guaranteed.
Input Schema
{
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
},
"includeAmenities": {
"type": "boolean",
"description": "Default false. Set true only when the user asks about on-board facilities or opens the amenities section."
},
"includeMedia": {
"type": "boolean",
"description": "Default false. Set true only when media is requested."
}
},
"required": [
"sailingId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "sailing"
},
"selection": {
"type": "object",
"properties": {
"cabinClass": {
"type": [
"string",
"null"
]
},
"offerId": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
}
},
"required": [
"cabinClass",
"offerId",
"eventSelector"
],
"additionalProperties": false
},
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
}
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"amenityCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"amenitiesIncluded": {
"type": "boolean"
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"costTreatment": {
"type": "string"
},
"sourceUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"category",
"costTreatment",
"sourceUrl"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"amenityCount",
"amenitiesIncluded",
"amenities"
],
"additionalProperties": false
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"caption": {
"type": [
"string",
"null"
]
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"selection",
"sailing",
"itinerary",
"offers",
"ship",
"media",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_price_history(sailingId, contextKey, dateFrom, dateTo, maxPoints)
Read one exact captured offer context's price history. contextKey is required from get_sailing offers. Never blends cabins, fares, markets, guest counts or events. Dates select overlapping captured observation spans; maxPoints retains the latest points.
Input Schema
{
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"contextKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact offers[].contextKey from get_sailing, identifying cabin/fare/occupancy/market/event; never infer or combine contexts."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest observation date; includes captured spans that overlap this date."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest observation date (YYYY-MM-DD)."
},
"maxPoints": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Retain latest matching observations, default 100, maximum 200."
}
},
"required": [
"sailingId",
"contextKey"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "history"
},
"sailingId": {
"type": "string"
},
"series": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"market": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"lastCheckedAt": {
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"amountCents": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string"
}
},
"required": [
"id",
"firstSeenAt",
"lastCheckedAt",
"amountCents",
"availability"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"cabinClass",
"sourceName",
"fareCode",
"eventSelector",
"guestCount",
"market",
"isCurrent",
"lastCheckedAt",
"points"
],
"additionalProperties": false
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
},
"truncated": {
"type": "boolean"
}
},
"required": [
"kind",
"sailingId",
"series",
"priceContext",
"truncated"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢present_cruises(sailings)
Present the final shortlist of one to three selected sailings in ONE interactive widget. Call once after research, preserving exact offer IDs, cabin classes and event selectors. Research tools do not render widgets. Do not repeat all widget details in prose.
Input Schema
{
"type": "object",
"properties": {
"sailings": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"required": [
"sailingId"
],
"additionalProperties": false
}
}
},
"required": [
"sailings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "shortlist"
},
"items": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"items",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢compare_sailings(sailings)
Compare two to four distinct sailings and optional exact offer IDs. Defaults to lowest current captured two-adult offer; occupancy is explicit per offer. No live or family quote.
Input Schema
{
"type": "object",
"properties": {
"sailings": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"required": [
"sailingId"
],
"additionalProperties": false
}
}
},
"required": [
"sailings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "comparison"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"items",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢present_excursions(portId, date, q, page)
Open ONE interactive port-experience browser when the user wants excursions, tours or activities. Omit portId to let the user choose a port without calling Viator. Supply a supported local portId and optional visit date and activity keywords q to show matching experiences. This makes a fresh on-demand search; use the returned data as the current result. Preserve requested filters. Do not fetch details for every result. Users can change ports, dates, keywords and pages, inspect one selected experience and open Viator booking links. Suggestions are not verified to fit time ashore; no live availability. Use only on an experience request, never automatically for every cruise search.
Input Schema
{
"type": "object",
"properties": {
"portId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 833
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_excursion_ports
List local cruise ports and whether excursion searches are supported. No Viator product request. Use the returned port ID for find_port_excursions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_port_excursions(portId, date, q, page)
Search Viator on demand only when the user asks for activities or excursions. Use a port ID from list_excursion_ports or get_sailing itinerary.portId. Pass the port visit date, not the cruise departure date. Optional q searches activity keywords such as snorkeling or food tours within that port; preserve it across pagination. Returns suggestions near the port, NOT verified time-ashore matches or live availability. Prices are indicative, may differ for the date/party, and are not cruise fares. Preserve complete affiliate URLs. No reviews or protected unique content. No widget.
Input Schema
{
"type": "object",
"properties": {
"portId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 833
}
},
"required": [
"portId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_excursion(productCode)
Fetch details only for a Viator product the user selected from find_port_excursions. Returns allowed product content and an affiliate booking URL; no reviews, protected content or live availability. Verify meeting point, return timing and availability on Viator.
Input Schema
{
"type": "object",
"properties": {
"productCode": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,80}$"
}
},
"required": [
"productCode"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools