# SchedulesMCP

> SchedulesMCP is pre-booking ocean-freight intelligence: compare ocean carriers on any lane by transit time and **real on-time reliability** — 72,000+ tracked forward sailings from 60+ carriers across 5,000+ lanes and 255 ports, scored against 4,200+ observed port calls (134 lanes, 42 carriers, growing daily), not carrier promises — through a web app, a REST API, and a hosted MCP server built to be called by AI agents.

Full agent reference: https://schedulesmcp.com/llms-full.txt · OpenAPI spec: https://schedulesmcp.com/openapi.json · Human API docs: https://schedulesmcp.com/docs

SchedulesMCP answers one question for a cargo owner or forwarder: **which ocean carrier should I book on this lane, and how reliably does it actually sail?** It ranks carriers on an origin→destination pair by observed on-time reliability and transit time, derived from real arrivals rather than published schedules. It is MCP-native (callable directly by Claude, ChatGPT, Cursor, and any MCP client), also ships a REST API, and is a sister product to [TrackingMCP](https://trackingmcp.com), whose live container tracking supplies the observed arrivals.

## Definitions
- **Sailing schedule** — a carrier's planned point-to-point departures on a lane: vessel, voyage, service loop, cut-off, departure and arrival dates.
- **On-time reliability (schedule reliability)** — the share of a carrier's sailings that arrive on schedule, measured from actual vs scheduled arrivals across tracked port calls. Not a carrier promise, not a survey.
- **Transit time** — days from origin to destination for a sailing; SchedulesMCP reports the observed **median (p50)** and **p90**.
- **p90 delay** — the delay 90% of sailings stayed within; a worst-case consistency signal that a simple average hides.
- **Early-data / low-sample** — a lane with too few tracked arrivals to score honestly. SchedulesMCP labels it rather than inventing a number.

## Start here
- [Compare lanes](https://schedulesmcp.com/compare) — enter an origin and destination; rank every carrier on that lane by on-time reliability and transit time. Free, no signup.
- [Lanes](https://schedulesmcp.com/lanes) — a directory of ocean shipping lanes (origin→destination routes) grouped by trade, each with its carriers, sailing count, and median transit time; one page per lane at /lanes/{origin}-to-{destination}.
- [Carriers](https://schedulesmcp.com/carriers) — every ocean carrier with a live schedule connector, one page each, with trades covered and how schedules are sourced.
- [MCP server](https://schedulesmcp.com/mcp) — connect SchedulesMCP to any MCP client (Claude, Cursor, Windsurf, VS Code, agents).
- [API docs](https://schedulesmcp.com/docs) — free, unauthenticated /public REST endpoints with curl examples (no key, 120 req/min).
- [Pricing](https://schedulesmcp.com/pricing) — schedule comparison, reliability scoring, and MCP/API access with a free tier.

## Lane pages
Per-lane sailing-schedule pages at https://schedulesmcp.com/lanes/{origin}-to-{destination} (e.g. shanghai-to-rotterdam) cover the ocean lanes with tracked forward sailings — each states the carriers on the lane, the number of sailings in the schedule window, and the median port-to-port transit, then links into the live compare tool. Every figure comes from real schedule data; no transit time or reliability number is invented.

## MCP endpoint
- Remote Streamable HTTP: `https://mcp.schedulesmcp.com/mcp`
- Auth: `Authorization: Bearer YOUR_API_KEY`. Public demo key `smcp_demo_public` works with no signup (sample data for connection testing; the web Compare search and the /public REST endpoints are live real data).
- Registry: `io.github.lxxmng/ocean-schedules`
- Tools:
  - `compare_lanes` — rank carriers on an origin→destination pair by on-time reliability and transit time.
  - `carrier_reliability` — on-time % and delay distribution for a carrier, optionally per lane.
  - `transit_time` — observed median / p90 transit time for a carrier on a lane.
  - `find_sailings` — observed and derived upcoming departures on a lane.
  - `get_schedules` — published forward sailings on a lane: carrier, vessel, voyage, ETD/ETA and cut-offs.
  - `find_best_sailings` — best upcoming sailings on a lane, one per carrier, ranked; filter by dates, transit, reliability, open cut-offs.
  - `watch_lane` — watch a lane for schedule alerts: blank sailings, closing cut-offs, slips, reliability drops (paid).
  - `port_reliability` — congestion and dwell signals for a port.
  - `carrier_league` — league table of carriers ranked by overall on-time reliability.
  - `port_congestion` — fused port-congestion signal: level, expected added wait in days, confidence.
  - `active_cyclones` — live tropical cyclones currently active on ocean trade lanes.
  - `lane_storm_exposure` — whether a lane currently passes through an active cyclone's forecast gale field.

## Carrier schedule pages
One page per carrier with a live schedule connector today. Each states which trades the connector returns and how schedules are sourced; reliability figures are only ever computed live from actual-vs-scheduled arrivals in the compare tool, never fabricated on the page.
- [Maersk](https://schedulesmcp.com/carriers/maersk) (MAEU) — global east–west and north–south trades
- [MSC](https://schedulesmcp.com/carriers/msc) (MSCU) — the widest global network of any line
- [CMA CGM](https://schedulesmcp.com/carriers/cma-cgm) (CMDU) — global Ocean Alliance trades plus Mediterranean and West Africa
- [COSCO](https://schedulesmcp.com/carriers/cosco) (COSU) — global Ocean Alliance trades, dense Asia–Europe and transpacific
- [Hapag-Lloyd](https://schedulesmcp.com/carriers/hapag-lloyd) (HLCU) — global Gemini Cooperation network with Maersk
- [ONE](https://schedulesmcp.com/carriers/one) (ONEY) — global Premier Alliance trades
- [Yang Ming](https://schedulesmcp.com/carriers/yang-ming) (YMLU) — Premier Alliance east–west and intra-Asia
- [OOCL](https://schedulesmcp.com/carriers/oocl) (OOLU) — global Ocean Alliance trades, COSCO Shipping group
- [HMM](https://schedulesmcp.com/carriers/hmm) (HDMU) — Premier Alliance east–west plus intra-Asia
- [ZIM](https://schedulesmcp.com/carriers/zim) (ZIMU) — asset-light niche transpacific, Atlantic, Mediterranean express
- [SITC](https://schedulesmcp.com/carriers/sitc) (SITC) — dense intra-Asia and Greater China network
- [TS Lines](https://schedulesmcp.com/carriers/ts-lines) (TSLL) — intra-Asia trades
- [RCL](https://schedulesmcp.com/carriers/rcl) (RCLS) — intra-Asia feeder and mainline services
- [KMTC](https://schedulesmcp.com/carriers/kmtc) (KMTC) — intra-Asia trades, strong Korea/China/SE-Asia/India
- [Tarros](https://schedulesmcp.com/carriers/tarros) (GETU) — short-sea Mediterranean trades
- [Seaboard Marine](https://schedulesmcp.com/carriers/seaboard-marine) (SMLU) — US, Caribbean, Latin America trades
- [Swire Shipping](https://schedulesmcp.com/carriers/swire-shipping) (SWBC) — Asia-Pacific and Pacific Islands trades

## Common questions
- **How do I compare ocean carrier schedules?** Enter origin and destination on [/compare](https://schedulesmcp.com/compare); carriers are ranked side by side by on-time reliability and transit time. Or call it over MCP / the REST API.
- **Which carrier is most reliable on my lane?** It depends on the lane — SchedulesMCP ranks carriers per origin→destination pair by observed on-time reliability, flagging the most reliable and marking thin lanes as early-data.
- **What is transit time vs on-time reliability?** Transit time is how many days a sailing takes (median and p90); on-time reliability is how often the carrier arrives when it said it would. SchedulesMCP shows both because a fast-but-late lane can be worse than a slower dependable one.
- **How do I connect the MCP server?** Point any MCP client at `https://mcp.schedulesmcp.com/mcp` with an `Authorization: Bearer` header; try it with `smcp_demo_public`.

## Example agent queries
- "Compare carriers from Shanghai to Rotterdam by on-time reliability."
- "Which carrier is most reliable on CNSHA→NLRTM, and what's the median transit time?"
- "Show the carrier league table ranked by overall on-time reliability."
- "What's the p90 transit time for Maersk on the Asia–North Europe lane?"
- "How congested is the port of Rotterdam right now?"

## About
- Reliability is measured from actual vs scheduled arrivals across tracked port calls — never carrier promises, never fabricated. Thin lanes are labelled, not guessed.
- Sister product to [TrackingMCP](https://trackingmcp.com) (live container tracking & shipment visibility), which supplies the observed arrivals.