Container Tracking MCP
DCSA container tracking across 228 ocean carriers: live vessel positions, ETAs, demurrage alerts.
Open source Repository Open in the app JSON README (API)
About
DCSA container tracking across 228 ocean carriers: live vessel positions, ETAs, demurrage alerts.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- lxxmng
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.3.0
- Last push
- 2026-07-16T12:23:59Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:27
- Updated
- 2026-08-29 04:00:27
- Origin id
io.github.lxxmng/container-tracking
README
# Container Tracking MCP Server
[](https://www.npmjs.com/package/container-tracking-mcp)
[](https://smithery.ai/servers/lxxmng/container-tracking)
**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
| Tool | What it does |
|------|-------------|
| `getShipmentSummary` | Portfolio overview: total active containers, exceptions, arriving soon, and demurrage risk. Use first to see what needs attention. |
| `getContainerDetail` | Full status for one container: current location, route, ETA with confidence %, carrier, vessel name + IMO, complete event history, and an AI-generated narrative. |
| `getVesselPosition` | Live AIS position for a vessel: latitude, longitude, speed over ground, heading, and navigational status (by IMO). |
| `getDemurrageReport` | Demurrage & detention risk: which containers are near or past free days, daily rates, and projected cost if not moved. |
| `getPortCongestion` | Congestion at one or more ports by UN/LOCODE: average vessel wait time, vessels at anchor, and level (low/moderate/high/severe). |
| `addContainer` | 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. |
## 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](https://trackingmcp.com/mcp).
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```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)
```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](https://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](https://trackingmcp.com/pricing).
## Links
- Product: [trackingmcp.com](https://trackingmcp.com)
- Get an API key: [trackingmcp.com/mcp](https://trackingmcp.com/mcp)
- Docs: [trackingmcp.com/docs](https://trackingmcp.com/docs)
- Pricing: [trackingmcp.com/pricing](https://trackingmcp.com/pricing)
- Status: [status.trackingmcp.com](https://status.trackingmcp.com)
## License
MIT