Ocean Schedules README

Sailing Schedule MCP Server

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

Tool	What it does
`compare_lanes`	Rank carriers serving an origin→destination port pair by on-time reliability and transit time. Use this to decide which line to book.
`carrier_reliability`	On-time performance and delay distribution for a specific carrier (by SCAC), optionally on a given lane.
`transit_time`	Observed transit-time distribution (median / p90, in days) for a carrier on an origin→destination lane.
`find_sailings`	Observed and derived upcoming departures on an origin→destination lane, with carrier and frequency.
`port_reliability`	Congestion and dwell signals for a port (UN/LOCODE): average wait and vessels at anchor.

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

config.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)

config.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

License

MIT