Container Tracking MCP logo

Container Tracking MCP

DCSA container tracking across 228 ocean carriers: live vessel positions, ETAs, demurrage alerts.

Install Container Tracking MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "container-tracking-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "container-tracking-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y container-tracking-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 5d ago.

Overview

Tools6

What Container Tracking MCP lets your agent do. Expand a tool for its parameters.

Self-reported~227 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

9/9 checks healthy over the last 53d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · container-tracking-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads37Package downloads in the last 30 days.
Last commit11d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed6Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

From the project 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:

Maersk · MSC · CMA CGM · COSCO · Hapag-Lloyd · ONE (Ocean Network Express) · Evergreen · HMM · Yang Ming · ZIM · OOCL · Wan Hai · PIL · Hyundai · SITC · KMTC · Matson · Sinokor · Heung-A · Namsung — and 200+ more.

Every carrier is normalised to the DCSA ocean-tracking event standard, so a milestone from any line looks the same to your AI client. Track by:

  • Container number (e.g. MSCU7349821)
  • Bill of lading number
  • Booking number

You get: live milestone events, current vessel name + IMO, live AIS vessel position, ETA with a confidence percentage, demurrage & detention free-time countdown, and port congestion signals.

Tools

ToolWhat it does
getShipmentSummaryPortfolio overview: total active containers, exceptions, arriving soon, and demurrage risk. Use first to see what needs attention.
getContainerDetailFull status for one container: current location, route, ETA with confidence %, carrier, vessel name + IMO, complete event history, and an AI-generated narrative.
getVesselPositionLive AIS position for a vessel: latitude, longitude, speed over ground, heading, and navigational status (by IMO).
getDemurrageReportDemurrage & detention risk: which containers are near or past free days, daily rates, and projected cost if not moved.
getPortCongestionCongestion at one or more ports by UN/LOCODE: average vessel wait time, vessels at anchor, and level (low/moderate/high/severe).
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.

Quick connect

The server is hosted at https://mcp.trackingmcp.com/mcp. Try it with zero signup using the public demo key tmcp_demo_public, or get a free API key.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json
{
  "mcpServers": {
    "container-tracking": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.trackingmcp.com/mcp",
               "--header", "Authorization: Bearer tmcp_demo_public"]
    }
  }
}

Cursor / Windsurf / VS Code (native HTTP MCP)

config.json
{
  "mcpServers": {
    "container-tracking": {
      "url": "https://mcp.trackingmcp.com/mcp",
      "headers": { "Authorization": "Bearer tmcp_demo_public" }
    }
  }
}

Replace tmcp_demo_public with your own key from trackingmcp.com/mcp for live production tracking. Registry ID: io.github.lxxmng/container-tracking.

Example prompts

  • "Where is container MSCU7349821?"
  • "What's the status of bill of lading HLCU2840012?"
  • "Give me a summary of all active shipments."
  • "Which containers arrive at Rotterdam this week?"
  • "Am I at risk of demurrage on any containers?"
  • "How congested is Felixstowe port right now?"
  • "Start tracking BL MAEU123456789."

Pricing

Token-metered, no subscription. Starter 3,000 tokens €49 · Growth 15,000 €199 · Pro 50,000 €549 · Enterprise 100,000 €849. Tokens never expire. One full container check (getContainerDetail + getVesselPosition + getShipmentSummary) ≈ 90 tokens. See trackingmcp.com/pricing.

Links

License

MIT

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Container Tracking MCP

Container Tracking MCP is an MCP server that lets AI assistants track ocean-freight shipments across 225 carriers, including major lines such as Maersk, MSC, and CMA CGM. It provides DCSA-normalised milestones, vessel positions, ETA confidence, demurrage and detention information, and port congestion data through a hosted remote server.

Track a shipment using its container number, bill of lading number, or booking number. The getContainerDetail tool returns the current location, route, ETA with confidence percentage, carrier, vessel details, complete event history, and an AI-generated narrative.

Container Tracking MCP supports 225 ocean carriers, including Maersk, MSC, CMA CGM, COSCO, Hapag-Lloyd, ONE, Evergreen, HMM, Yang Ming, ZIM, OOCL, Wan Hai, PIL, Matson, and others. Carrier events are normalised to the DCSA ocean-tracking event standard.

Yes, Container Tracking MCP identifies containers nearing or past their free days, shows daily demurrage and detention rates, and projects costs if containers are not moved. Use getDemurrageReport for risk details or getShipmentSummary for a portfolio-level overview.

Connect to the hosted MCP endpoint at https://mcp.trackingmcp.com/mcp using an MCP client such as Claude Desktop, Cursor, Windsurf, or VS Code. The service supports Bearer-token authentication and provides a public demo key for testing, with free API keys available for production tracking.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewContainer Tracking MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/container-tracking-mcp?style=directory)](https://allmcps.com/mcp/container-tracking-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/container-tracking-mcp"><img src="https://allmcps.com/api/badge/container-tracking-mcp?style=directory" alt="Container Tracking MCP on AllMCPs" /></a>