CruiseHops MCP
A read-only MCP server that allows AI assistants to search for Carnival and Royal Caribbean cruises, compare fare history, and explore itineraries without requiring authentication or API keys.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://cruisehops.com/mcpWhat you can do with it
- Suggest a Caribbean cruise for next week
- Find cruises from Miami under $800 per person
- Compare two balcony sailings and show their itineraries
Source and maintenance
Vendor evidenceRegistry 1.4.0
Protocol and capabilities
- Server
- cruisehops 1.4.0
- MCP protocol
- 2025-06-18
- Tools
- 12 advertised
- Resources
- 2 advertised
- Resource templates
- 0 advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
12 advertised
search_cruises — Find cruises
Advertised read-only
Find cruise recommendations and deals on CruiseHops by destination, departure port, dates, cabin and budget. Coverage includes captured sailings from Carnival Cruise Line, Royal Caribbean International, MSC Cruises, Norwegian Cruise Line, Celebrity Cruises, Princess Cruises, Holland America Line, Costa Cruises, Disney Cruise Line, Virgin Voyages, AIDA Cruises, TUI Cruises / Mein Schiff, P&O Cruises (UK), Cunard. This is not a whole-market or live-inventory search. 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.
search_cruises input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"page": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "One-based result page; default 1."
},
"ship": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"sort": {
"enum": [
"price",
"departure",
"duration",
"relevance"
],
"type": "string"
},
"view": {
"enum": [
"groups",
"sailings"
],
"type": "string",
"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."
},
"terms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"maxItems": 10,
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"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)."
},
"source": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source ID: carnival, royal_caribbean, msc, norwegian, celebrity, princess, holland_america, costa, disney, virgin, aida, tui_cruises, p_and_o, cunard."
},
"amenity": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"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)."
},
"pageSize": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Items per page, 1–50; default 3."
},
"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."
},
"nightsMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"nightsMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"roundtrip": {
"type": "boolean"
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"destination": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"durationMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum normalized duration in days, not advertised nights."
},
"durationMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum normalized duration in days, not advertised nights."
},
"visitedPort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"dateFlexDays": {
"type": "integer",
"maximum": 30,
"minimum": 0,
"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."
},
"departurePort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"priceMaxCents": {
"type": "integer",
"maximum": 999999999,
"minimum": 0,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"departureTerms": {
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"maxItems": 10,
"minItems": 1,
"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."
},
"includeUnavailable": {
"type": "boolean"
}
},
"additionalProperties": false
}search_cruises output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"selectedTerms",
"view",
"items",
"totalSailings",
"total",
"page",
"pageSize",
"priceContext"
],
"properties": {
"kind": {
"type": "string",
"const": "search"
},
"page": {
"type": "number"
},
"view": {
"enum": [
"groups",
"sailings"
],
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"recovery": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label",
"count",
"changes"
],
"properties": {
"id": {
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"label": {
"type": "string"
},
"changes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"null"
]
}
}
},
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"selectedTerms": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"label",
"unavailable"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"ship",
"port",
"destination",
"line"
],
"type": "string"
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"totalSailings": {
"type": "number"
},
"dateAlternatives": {
"type": "object",
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"properties": {
"page": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"dateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"flexibilityDays": {
"type": "number"
},
"requestedDateTo": {
"type": "string"
},
"requestedDateFrom": {
"type": "string"
}
},
"additionalProperties": false
},
"selectedDepartureTerms": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"label",
"unavailable"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"ship",
"port",
"destination",
"line"
],
"type": "string"
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}search_cruises annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}suggest_cruise_terms — Find ships and destinations
Advertised read-only
Suggest matching ship, port, destination and cruise line names, including suffix words. Returns stable term IDs for search filters.
suggest_cruise_terms input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"page": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "One-based result page; default 1."
},
"ship": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"sort": {
"enum": [
"price",
"departure",
"duration",
"relevance"
],
"type": "string"
},
"view": {
"enum": [
"groups",
"sailings"
],
"type": "string",
"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."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"terms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"maxItems": 10,
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"cursor": {
"type": "string",
"maxLength": 1000
},
"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)."
},
"source": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source ID: carnival, royal_caribbean, msc, norwegian, celebrity, princess, holland_america, costa, disney, virgin, aida, tui_cruises, p_and_o, cunard."
},
"amenity": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"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)."
},
"pageSize": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Items per page, 1–50; default 3."
},
"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."
},
"nightsMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"nightsMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"roundtrip": {
"type": "boolean"
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"destination": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"durationMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum normalized duration in days, not advertised nights."
},
"durationMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum normalized duration in days, not advertised nights."
},
"visitedPort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"dateFlexDays": {
"type": "integer",
"maximum": 30,
"minimum": 0,
"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."
},
"departurePort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"priceMaxCents": {
"type": "integer",
"maximum": 999999999,
"minimum": 0,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"departureTerms": {
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"maxItems": 10,
"minItems": 1,
"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."
},
"includeUnavailable": {
"type": "boolean"
}
},
"additionalProperties": false
}suggest_cruise_terms output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"items",
"total",
"nextCursor"
],
"properties": {
"kind": {
"type": "string",
"const": "suggestions"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"label",
"unavailable",
"sailingCount",
"resultCount",
"countUnit"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"ship",
"port",
"destination",
"line"
],
"type": "string"
},
"label": {
"type": "string"
},
"countUnit": {
"enum": [
"groups",
"sailings"
],
"type": "string"
},
"resultCount": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"sailingCount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"nextCursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}suggest_cruise_terms annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_departures — Explore departure dates
Advertised read-only
List bounded, paginated unique dated sailings for a public ship-itinerary group ID. Preserves cabin/date filters; older event-specific group IDs remain supported.
list_departures input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"groupId"
],
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"page": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "One-based result page; default 1."
},
"ship": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"sort": {
"enum": [
"price",
"departure",
"duration",
"relevance"
],
"type": "string"
},
"view": {
"enum": [
"groups",
"sailings"
],
"type": "string",
"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."
},
"terms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"maxItems": 10,
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"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)."
},
"source": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Source ID: carnival, royal_caribbean, msc, norwegian, celebrity, princess, holland_america, costa, disney, virgin, aida, tui_cruises, p_and_o, cunard."
},
"amenity": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"groupId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Public ship-itinerary group ID from search_cruises items[].groupId; this is not a sailing ID. Older event-specific group IDs remain supported."
},
"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)."
},
"pageSize": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Items per page, 1–50; default 3."
},
"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."
},
"nightsMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"nightsMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"roundtrip": {
"type": "boolean"
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"destination": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"durationMax": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Maximum normalized duration in days, not advertised nights."
},
"durationMin": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Minimum normalized duration in days, not advertised nights."
},
"visitedPort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"dateFlexDays": {
"type": "integer",
"maximum": 30,
"minimum": 0,
"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."
},
"departurePort": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"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."
},
"priceMaxCents": {
"type": "integer",
"maximum": 999999999,
"minimum": 0,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"departureTerms": {
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"maxItems": 10,
"minItems": 1,
"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."
},
"includeUnavailable": {
"type": "boolean"
}
},
"additionalProperties": false
}list_departures output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"groupId",
"items",
"total",
"page",
"pageSize",
"priceContext"
],
"properties": {
"kind": {
"type": "string",
"const": "departures"
},
"page": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"groupId": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"dateAlternatives": {
"type": "object",
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"properties": {
"page": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"dateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"flexibilityDays": {
"type": "number"
},
"requestedDateTo": {
"type": "string"
},
"requestedDateFrom": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}list_departures annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_sailing — Explore a sailing
Advertised read-only
Explore a CruiseHops sailing page: itinerary, cabin fares, price-history context and links to the website and fare 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.
get_sailing input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sailingId"
],
"properties": {
"offerId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"sailingId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"includeMedia": {
"type": "boolean",
"description": "Default false. Set true only when media is requested."
},
"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."
}
},
"additionalProperties": false
}get_sailing output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"selection",
"sailing",
"itinerary",
"offers",
"headlinePriceHistory",
"ship",
"media",
"priceContext"
],
"properties": {
"kind": {
"type": "string",
"const": "sailing"
},
"ship": {
"type": "object",
"required": [
"id",
"name",
"amenityCount",
"amenitiesIncluded",
"amenities"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"category",
"costTreatment",
"sourceUrl"
],
"properties": {
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"costTreatment": {
"type": "string"
}
},
"additionalProperties": false
}
},
"amenityCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"amenitiesIncluded": {
"type": "boolean"
}
},
"additionalProperties": false
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"caption": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"properties": {
"id": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"market": {
"type": [
"string",
"null"
]
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"cabinClass": {
"type": "string"
},
"contextKey": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"observedAt": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"nativePrice": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency",
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
},
"qualifier": {
"type": "string"
},
"interpretationVerified": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string"
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"sailing": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"selection": {
"type": "object",
"required": [
"cabinClass",
"offerId",
"eventSelector"
],
"properties": {
"offerId": {
"type": [
"string",
"null"
]
},
"cabinClass": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
}
},
"additionalProperties": false
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"headlinePriceHistory": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"cabinClass",
"sourceName",
"fareCode",
"eventSelector",
"guestCount",
"market",
"isCurrent",
"lastCheckedAt",
"points"
],
"properties": {
"id": {
"type": "string"
},
"basis": {
"type": "string"
},
"scope": {
"enum": [
"offer",
"headline"
],
"type": "string"
},
"market": {
"type": [
"string",
"null"
]
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"firstSeenAt",
"lastCheckedAt",
"amountCents",
"availability"
],
"properties": {
"id": {
"type": "string"
},
"runId": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"coverage": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"contextKey": {
"type": [
"string",
"null"
]
},
"amountCents": {
"type": [
"number",
"null"
]
},
"firstSeenAt": {
"type": "string"
},
"availability": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"currency": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"cabinClass": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"sourceName": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}get_sailing annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_cabin_price_history — View cabin headline history
Advertised read-only
Read lowest returned cabin prices across promotions. Use headlinePriceHistory[].id from get_sailing as seriesKey. Fare and category changes are explicit; missing observations do not establish unavailability.
get_cabin_price_history input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sailingId",
"seriesKey"
],
"properties": {
"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])))$"
},
"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])))$"
},
"maxPoints": {
"type": "integer",
"default": 100,
"maximum": 200,
"minimum": 1
},
"sailingId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"seriesKey": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}get_cabin_price_history output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"sailingId",
"series",
"priceContext",
"truncated"
],
"properties": {
"kind": {
"type": "string",
"const": "history"
},
"series": {
"type": "object",
"required": [
"id",
"cabinClass",
"sourceName",
"fareCode",
"eventSelector",
"guestCount",
"market",
"isCurrent",
"lastCheckedAt",
"points"
],
"properties": {
"id": {
"type": "string"
},
"basis": {
"type": "string"
},
"scope": {
"enum": [
"offer",
"headline"
],
"type": "string"
},
"market": {
"type": [
"string",
"null"
]
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"firstSeenAt",
"lastCheckedAt",
"amountCents",
"availability"
],
"properties": {
"id": {
"type": "string"
},
"runId": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"coverage": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"contextKey": {
"type": [
"string",
"null"
]
},
"amountCents": {
"type": [
"number",
"null"
]
},
"firstSeenAt": {
"type": "string"
},
"availability": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"currency": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"cabinClass": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"sourceName": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"sailingId": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}get_cabin_price_history annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_price_history — View cabin price history
Advertised read-only
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.
get_price_history input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sailingId",
"contextKey"
],
"properties": {
"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)."
},
"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."
},
"maxPoints": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Retain latest matching observations, default 100, maximum 200."
},
"sailingId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"contextKey": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact offers[].contextKey from get_sailing, identifying cabin/fare/occupancy/market/event; never infer or combine contexts."
}
},
"additionalProperties": false
}get_price_history output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"sailingId",
"series",
"priceContext",
"truncated"
],
"properties": {
"kind": {
"type": "string",
"const": "history"
},
"series": {
"type": "object",
"required": [
"id",
"cabinClass",
"sourceName",
"fareCode",
"eventSelector",
"guestCount",
"market",
"isCurrent",
"lastCheckedAt",
"points"
],
"properties": {
"id": {
"type": "string"
},
"basis": {
"type": "string"
},
"scope": {
"enum": [
"offer",
"headline"
],
"type": "string"
},
"market": {
"type": [
"string",
"null"
]
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"firstSeenAt",
"lastCheckedAt",
"amountCents",
"availability"
],
"properties": {
"id": {
"type": "string"
},
"runId": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"coverage": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"contextKey": {
"type": [
"string",
"null"
]
},
"amountCents": {
"type": [
"number",
"null"
]
},
"firstSeenAt": {
"type": "string"
},
"availability": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"currency": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"cabinClass": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"sourceName": {
"type": "string"
},
"categoryCode": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"sailingId": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}get_price_history annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}present_cruises — Your CruiseHops shortlist
Advertised read-only
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.
present_cruises input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sailings"
],
"properties": {
"sailings": {
"type": "array",
"items": {
"type": "object",
"required": [
"sailingId"
],
"properties": {
"offerId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"sailingId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
}present_cruises output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"items",
"priceContext"
],
"properties": {
"kind": {
"type": "string",
"const": "shortlist"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"properties": {
"sailing": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"properties": {
"id": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"market": {
"type": [
"string",
"null"
]
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"cabinClass": {
"type": "string"
},
"contextKey": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"observedAt": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"nativePrice": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency",
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
},
"qualifier": {
"type": "string"
},
"interpretationVerified": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string"
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}present_cruises annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}compare_sailings — Compare cruises
Advertised read-only
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.
compare_sailings input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sailings"
],
"properties": {
"sailings": {
"type": "array",
"items": {
"type": "object",
"required": [
"sailingId"
],
"properties": {
"offerId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"sailingId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"additionalProperties": false
},
"maxItems": 4,
"minItems": 2
}
},
"additionalProperties": false
}compare_sailings output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"items",
"priceContext"
],
"properties": {
"kind": {
"type": "string",
"const": "comparison"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"properties": {
"sailing": {
"type": "object",
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"properties": {
"id": {
"type": "string"
},
"ship": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"deepLink": {
"type": "string"
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"returnDate": {
"type": [
"string",
"null"
]
},
"searchRank": {
"type": "number"
},
"unavailable": {
"type": "boolean"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"durationDays": {
"type": [
"number",
"null"
]
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"departureDate": {
"type": "string"
},
"departurePort": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"eventSelector": {
"type": "string"
},
"dateOffsetDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"departureCount": {
"type": "number"
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"lastDepartureDate": {
"type": "string"
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"days",
"nights"
],
"type": "string"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"firstDepartureDate": {
"type": "string"
},
"durationNightsSource": {
"anyOf": [
{
"enum": [
"advertised_nights",
"sailing_dates"
],
"type": "string"
},
{
"type": "null"
}
]
},
"itineraryCompleteness": {
"type": "string"
}
},
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"properties": {
"id": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"currency": {
"type": "string",
"const": "USD"
},
"cabinClass": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"market": {
"type": [
"string",
"null"
]
},
"fareCode": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"cabinClass": {
"type": "string"
},
"contextKey": {
"type": "string"
},
"guestCount": {
"type": [
"number",
"null"
]
},
"observedAt": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"nativePrice": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency",
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
},
"qualifier": {
"type": "string"
},
"interpretationVerified": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string"
},
"eventSelector": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"properties": {
"basis": {
"type": "string",
"const": "per_person"
},
"caveat": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"quoteType": {
"type": "string",
"const": "captured"
},
"guestCount": {
"type": "number",
"const": 2
},
"partyTotal": {
"type": "null"
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}compare_sailings annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}present_excursions — Explore port experiences
Advertised read-onlyOpen-world
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.
present_excursions input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"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])))$"
},
"page": {
"type": "integer",
"default": 1,
"maximum": 833,
"minimum": 1
},
"portId": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}present_excursions annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_excursion_ports — Explore excursion ports
Advertised read-only
List local cruise ports and whether excursion searches are supported. No Viator product request. Use the returned port ID for find_port_excursions.
list_excursion_ports input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}list_excursion_ports annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_port_excursions — Find port excursions
Advertised read-onlyOpen-world
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.
find_port_excursions input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"portId"
],
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"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])))$"
},
"page": {
"type": "integer",
"default": 1,
"maximum": 833,
"minimum": 1
},
"portId": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}find_port_excursions annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_excursion — Explore an excursion
Advertised read-onlyOpen-world
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.
get_excursion input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"productCode"
],
"properties": {
"productCode": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,80}$"
}
},
"additionalProperties": false
}get_excursion annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
2 advertised
CruiseHops explorer
Interactive cruise search, sailing details, comparison and price history
CruiseHops explorer URI
ui://cruise-atlas/explorer-v1.htmlCruiseHops experiences
Browse port experiences, dates and excursion details
CruiseHops experiences URI
ui://cruisehops/excursions-v1.html30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1011 ms
- 95th percentile latency
- 1011 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1011 ms · metadata changed · 12 tool(s), 2 resource(s), 0 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http cruisehops-mcp https://cruisehops.com/mcpCodex
Codex configuration
codex mcp add cruisehops-mcp --url https://cruisehops.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"cruisehops-mcp": {
"url": "https://cruisehops.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"cruisehops-mcp": {
"type": "streamableHttp",
"url": "https://cruisehops.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"cruisehops-mcp": {
"type": "http",
"url": "https://cruisehops.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http cruisehops-mcp https://cruisehops.com/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"cruisehops-mcp": {
"url": "https://cruisehops.com/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"cruisehops-mcp": {
"serverUrl": "https://cruisehops.com/mcp"
}
}
}Let your agent find its tools
Find servers like CruiseHops MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run CruiseHops MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.