Serveur MCP

ocean-schedules

io.github.lxxmng/ocean-schedules
Entreprise et opérations Données et analytique Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Compares ocean carrier schedules, transit times, reliability, port congestion, cyclone exposure, and upcoming sailings, with optional lane alerts.

active_cyclones
Live tropical cyclones (typhoons/hurricanes) currently active on ocean trade lanes — name, basin, category, center position, max wind, pressure and movement, from CMA (NW-Pacific) + NHC (Atlantic/E-Pacific) + JTWC (Indian/Southern Hemisphere) + GDACS (global). Use this to see which storms are at sea right now.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
carrier_league
Carrier league table — ocean carriers ranked by overall on-time reliability across all tracked lanes.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
carrier_reliability
On-time performance and delay distribution for a specific carrier (by SCAC), optionally on a given lane.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['carrier_code'], 'properties': {'carrier_code': {'type': 'string', 'description': 'Carrier SCAC, e.g. MAEU'}}, 'additionalProperties': False}
compare_lanes
Compare ocean carriers serving an origin→destination port pair, ranked by on-time reliability and transit time. Use this to decide which line to book.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE, e.g. CNSHA'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE, e.g. NLRTM'}}, 'additionalProperties': False}
find_best_sailings
Decision query: the best upcoming sailings on a lane, ONE per carrier (next bookable departure), ranked. Filter by date window, max transit days, min on-time reliability, cut-off still open, and direct-vs-transshipment. Use this to answer "what should I book?".
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'to': {'type': 'string', 'description': 'Latest departure date YYYY-MM-DD (default: +60 days)'}, 'from': {'type': 'string', 'description': 'Earliest departure date YYYY-MM-DD (default: today)'}, 'sort': {'enum': ['recommended', 'reliability', 'fastest', 'soonest'], 'type': 'string', 'description': 'Ranking (default recommended = reliability blended with transit)'}, 'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE or name resolves upstream, e.g. CNSHA'}, 'cutoff_open': {'type': 'boolean', 'description': 'Only sailings whose booking cut-off has not passed'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE, e.g. NLRTM'}, 'direct_only': {'type': 'boolean', 'description': 'Exclude transshipment routings'}, 'max_transit_days': {'type': 'number', 'description': 'Maximum transit time in days'}, 'reliability_floor': {'type': 'number', 'description': 'Minimum 90-day on-time %, 0-100'}}, 'additionalProperties': False}
find_sailings
Observed and derived upcoming departures on an origin→destination lane, with carrier and frequency.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE'}}, 'additionalProperties': False}
get_schedules
Published forward sailing schedules on an origin→destination lane: carrier, vessel, voyage, ETD/ETA and cut-offs, soonest first. Sourced from carrier connectors (and aggregator coverage). Use this to find concrete upcoming departures to book.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE, e.g. CNSHA'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE, e.g. NLRTM'}}, 'additionalProperties': False}
lane_storm_exposure
Whether an origin→destination ocean lane currently passes through an active cyclone's forecast gale field (a "storm-exposed" sailing at risk of weather delay). Omit ports to list every exposed lane.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE, e.g. CNSHA'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE, e.g. USLAX'}}, 'additionalProperties': False}
port_congestion
Fused port-congestion signal for a port (UN/LOCODE): effective level (mild/moderate/severe), expected added wait in days (for ETA-band widening), a 0–1 confidence, and per-source detail — weiyun broad-AIS analysis + IMF PortWatch throughput + our own AIS wait/density.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port'], 'properties': {'port': {'type': 'string', 'description': 'Port UN/LOCODE, e.g. NLRTM'}}, 'additionalProperties': False}
port_reliability
Congestion and dwell signals for a port (UN/LOCODE) — average wait and vessels at anchor.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port'], 'properties': {'port': {'type': 'string', 'description': 'Port UN/LOCODE, e.g. NLRTM'}}, 'additionalProperties': False}
transit_time
Observed transit-time distribution (median / p90, in days) for a carrier on an origin→destination lane.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE'}, 'carrier_code': {'type': 'string', 'description': 'Optional carrier SCAC to filter'}}, 'additionalProperties': False}
watch_lane
Watch a lane for schedule alerts (PAID): get emailed when a sailing on it is blanked, a booking cut-off is about to close, or a sailing slips. Also alerts on reliability drops. Returns the created watch.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE, e.g. CNNGB'}, 'alert_slip': {'type': 'boolean', 'description': 'Alert when a sailing slips vs schedule (default true)'}, 'alert_blank': {'type': 'boolean', 'description': 'Alert on suspected blank sailings (default true)'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE, e.g. NLRTM'}, 'alert_cutoff': {'type': 'boolean', 'description': 'Alert when a booking cut-off is closing (default true)'}, 'carrier_code': {'type': 'string', 'description': 'Optional SCAC to scope the watch to one carrier'}, 'cutoff_lead_hours': {'type': 'number', 'description': 'Hours before cut-off to alert (default 48)'}}, 'additionalProperties': False}
Ajouté
lane_storm_exposure
17 September 2026 12:43
Ajouté
active_cyclones
17 September 2026 12:43
Ajouté
port_congestion
17 September 2026 12:43
Ajouté
carrier_league
17 September 2026 12:43
Ajouté
port_reliability
17 September 2026 12:43
Ajouté
watch_lane
17 September 2026 12:43
Ajouté
find_best_sailings
17 September 2026 12:43
Ajouté
get_schedules
17 September 2026 12:43
Ajouté
find_sailings
17 September 2026 12:43
Ajouté
transit_time
17 September 2026 12:43
Ajouté
carrier_reliability
17 September 2026 12:43
Ajouté
compare_lanes
17 September 2026 12:43