Ocean Schedules

io.github.lxxmngPublished by GitHub account lxxmngv0.4.0Updated Oct 24, 2026

Compare ocean carrier schedules, transit times and reliability: 60+ carriers, 72,000+ sailings.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for ocean freight: lets an assistant compare carrier sailing schedules, transit times and on-time reliability before booking.

What you can do
Compare carriers on a port-to-port lane, ranked by on-time reliability and transit time, and view a carrier league table and per-carrier delay distributions by SCAC (compare_lanes, carrier_league, carrier_reliability). Retrieve forward sailing schedules with vessel, voyage, ETD/ETA, cut-offs and routing details (get_schedules). Find the best upcoming bookable sailing per carrier, filtered by date window, transit days, reliability, open cut-off and direct versus transshipment (find_best_sailings). Check port congestion levels and expected added wait by UN/LOCODE (port_congestion). Review active tropical cyclones and whether a lane crosses a storm's forecast gale field (active_cyclones, lane_s
When to use it
Useful when planning or comparing ocean freight bookings: choosing which line to book on a lane, checking how reliable a carrier has been, seeing upcoming departures and cut-offs, or assessing port congestion and storm risk before committing.
Requirements
A remote MCP endpoint; nothing to self-host. An Authorization bearer key is sent as a header; a public demo key is offered for trial with synthetic demo data, and a dashboard key is needed for full coverage. Some calls consume Navo Tokens.
Before you install
Several tools are metered: compare_lanes, carrier_reliability, carrier_league and port_congestion cost 10 tokens per call with Navo Tokens, and watch_lane is marked PAID and sends email alerts. A key must be supplied in the Authorization header. Demo data is synthetic, so results from the demo key are not real schedules.

Installation

In SourceWeft

  1. Open Ocean Schedules in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.lxxmng%2Focean-schedules/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ocean-schedules": {
      "type": "http",
      "url": "https://mcp.schedulesmcp.com/mcp"
    }
  }
}

README

Sailing Schedule MCP Server

[npm]

Compare ocean sailing schedules, transit times, and carrier on-time reliability across 60+ carriers from Claude, Cursor, or any MCP client.

SchedulesMCP is an ocean-freight sailing-schedule MCP server that lets an AI assistant find sailings and rank shipping lines before you book. It covers 60+ carriers, 72,000+ forward sailings, and 5,000+ point-to-point lanes across 255 ports. Carrier reliability is derived from observed actual-vs-scheduled arrivals across 4,200+ scored ocean port calls — not carrier promises. It runs as a hosted remote server, so there is nothing to self-host.

Ask your AI: "Compare Shanghai→Rotterdam carriers by reliability" or "What's the median transit time for Maersk on CNSHA→USLAX?"

Coverage

  • 60+ ocean carriers ranked head-to-head on any lane (Maersk, MSC, CMA CGM, COSCO, Hapag-Lloyd, ONE, Evergreen, HMM, Yang Ming, ZIM, and more)
  • 72,000+ forward sailings — observed and derived upcoming departures
  • 5,000+ point-to-point lanes across 255 ports (UN/LOCODE)
  • On-time reliability scored from 4,200+ observed actual-vs-scheduled port calls, with median / p90 transit-time distributions

Sister product to TrackingMCP (ocean container tracking) and LoadingMCP (container load planning).

Tools

ToolWhat it does
compare_lanesRank carriers serving an origin→destination port pair by on-time reliability and transit time. Use this to decide which line to book.
carrier_reliabilityOn-time performance and delay distribution for a specific carrier (by SCAC).

Quick connect

The server is hosted at https://mcp.schedulesmcp.com/mcp. Try it with zero signup using the public demo key smcp_demo_public (synthetic demo data; try lanes CNSHA→NLRTM or CNSHA→USLAX).

Claude Desktop

json
{  "mcpServers": {    "ocean-schedules": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.schedulesmcp.com/mcp",               "--header", "Authorization: Bearer smcp_demo_public"]    }  }}

Cursor / Windsurf / VS Code (native HTTP MCP)

json
{  "mcpServers": {    "ocean-schedules": {      "url": "https://mcp.schedulesmcp.com/mcp",      "headers": { "Authorization": "Bearer smcp_demo_public" }    }  }}

Replace smcp_demo_public with a key from your dashboard for full coverage. Don't add "type": "streamable-http" — Claude Desktop rejects unknown config fields; Cursor/Windsurf infer transport from url. Registry ID: io.github.lxxmng/ocean-schedules.

Example prompts

  • "Compare Shanghai→Rotterdam carriers by reliability."
  • "Which line is most on-time from CNSHA to USLAX?"
  • "What's Maersk's on-time performance on the transpacific?"
  • "Give me the median and p90 transit time for CMA CGM from Ningbo to Los Angeles."
  • "Show upcoming sailings from Shanghai to Rotterdam."
  • "How congested is the port of Rotterdam right now?"

Endpoint

  • Remote: https://mcp.schedulesmcp.com/mcp
  • Health: https://mcp.schedulesmcp.com/health

Links

License

MIT

Source: README.md at commit c72aa48

Tools

9

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. With Navo Tokens this costs 10 tokens per call; an empty answer is free.

Parametersoriginrequireddestinationrequired

carrier_reliability

On-time performance and delay distribution for a specific carrier (by SCAC). With Navo Tokens this costs 10 tokens per call; an empty answer is free.

Parameterscarrier_coderequired

get_schedules

Published forward sailing schedules on an origin→destination lane: carrier, vessel, voyage, ETD/ETA, cut-offs and routing (leg count, transshipment ports, distance, CO2 per TEU and the port-by-port route_legs where the carrier publishes them; null where they do not), soonest first, from each carrier's own published schedules. Use this to find concrete upcoming departures to book. Every schedule time (published_departure, published_arrival, cut-offs, route_legs times, the from window) is the local time of its own port as the line publishes it, written without a timezone offset (2026-10-01T13:00:00): quote the digits and do not convert them; departure_precision/arrival_precision say minute (a time) or day (a date only); only retrieved_at is UTC and carries an offset; use transit_days for voyage length. The answer also carries carriers: one entry per line with carrier_code, carrier_name and count (its sailings in this answer; the counts add up to count), most first. An entry has error only when that line was asked live for this lane in this request and gave no answer: timeout (no answer in time), failed (error or unreachable), or paused (not asked; it timed out twice in a row here, retried after 6 h). A line that answered it has no sailings carries no error, and a line in error is listed even at count 0. With Navo Tokens this costs 80 tokens for a new port pair and 10 for a repeat of the same pair within 24 hours (shared with the other lane search); an empty answer is free.

Parametersfromoriginrequireddestinationrequired

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?". etd, eta, cutoff.at and the from/to window are port-local times with no timezone offset (2026-10-01T13:00:00): quote the digits, do not convert; only retrieved_at is UTC. With Navo Tokens this costs 80 tokens for a new port pair and 10 for a repeat of the same pair within 24 hours (shared with the other lane search); an empty answer is free.

Parameterstofromsortcutofforiginrequireddestinationrequiredtransshipmentmax_transit_daysreliability_floorcutoff_include_unknown

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. Free with Navo Tokens: a watch is configuration, not data.

Parametersoriginrequiredalert_slipalert_blankdestinationrequiredalert_cutoffcarrier_codecutoff_lead_hours

carrier_league

Carrier league table: ocean carriers ranked by overall on-time reliability across all tracked lanes. With Navo Tokens this costs 10 tokens per call; an empty answer is free.

Takes no parameters.

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 the independent readings behind it: measured vessel waiting times, port-call throughput and AIS wait/density. With Navo Tokens this costs 10 tokens per call; an empty answer is free.

Parametersportrequired

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.

Takes no parameters.

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.

Parametersorigindestination

Version history

3
  1. v0.4.0LatestOct 23, 2026
  2. v0.3.0Oct 5, 2026
  3. v0.2.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts