lxxmng avatar

Container Tracking MCP

lxxmng/container-tracking-mcp

This connects Claude and ChatGPT to real-time container shipping data through a streamable HTTP interface. You get vessel positions, demurrage risk assessments, and port congestion metrics without having to wrangle multiple logistics APIs yourself. Reach for this when you're building supply chain tools, automating freight workflows, or need to surface shipping delays and associated costs in your AI applications. The dual transport support (streamable HTTP and SSE) means you can integrate it whether you need request-response patterns or live streaming updates as vessel positions change.

GitHub stars
1
tools
6
transport
HTTP
last updated
Jul 16, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

getShipmentSummaryPortfolio overview: total active containers, exceptions, arriving soon, and demurrage risk. Use first to see what needs attention.

Portfolio overview: total active containers, exceptions, arriving soon, and demurrage risk. Use first to see what needs attention.

No parameter schema in public metadata yet.

getContainerDetailFull status for one container: current location, route, ETA with confidence %, carrier, vessel name + IMO, complete event history, and an AI-generated narrative.

Full status for one container: current location, route, ETA with confidence %, carrier, vessel name + IMO, complete event history, and an AI-generated narrative.

No parameter schema in public metadata yet.

getVesselPositionLive AIS position for a vessel: latitude, longitude, speed over ground, heading, and navigational status (by IMO).

Live AIS position for a vessel: latitude, longitude, speed over ground, heading, and navigational status (by IMO).

No parameter schema in public metadata yet.

getDemurrageReportDemurrage & detention risk: which containers are near or past free days, daily rates, and projected cost if not moved.

Demurrage & detention risk: which containers are near or past free days, daily rates, and projected cost if not moved.

No parameter schema in public metadata yet.

getPortCongestionCongestion at one or more ports by UN/LOCODE: average vessel wait time, vessels at anchor, and level (low/moderate/high/severe).

Congestion at one or more ports by UN/LOCODE: average vessel wait time, vessels at anchor, and level (low/moderate/high/severe).

No parameter schema in public metadata yet.

addContainerStart tracking a new container ID or bill of lading. First status update arrives within ~15 minutes; optional tags organise by client, project, or urgency.

Start tracking a new container ID or bill of lading. First status update arrives within ~15 minutes; optional tags organise by client, project, or urgency.

No parameter schema in public metadata yet.

Sponsors

Readme

Container Tracking MCP Server

npm smithery badge

Track ocean containers across 200+ shipping lines from Claude, ChatGPT, Cursor, or any MCP client.

Container Tracking MCP is an ocean-freight MCP server that lets an AI assistant track a container via MCP across 225 carriers — including Maersk, MSC, CMA CGM, COSCO, and Hapag-Lloyd. Track by container number, bill of lading, or booking number to get live milestones, vessel position, ETA, and demurrage & detention free time as DCSA-normalised events. It runs as a hosted remote server, so there is nothing to self-host.

Ask your AI: "Where is container MSCU7349821?" or "Which shipments have demurrage risk this week?"

Supported carriers & coverage

Container Tracking MCP covers 200+ ocean shipping lines (225 carriers). Top lines include:


View the full README on GitHub

Details

Repository
github.com/lxxmng/container-tracking-mcp
Website
trackingmcp.com
Transport
HTTP
Registry
MCP registry, active