# BerthTime

The BerthTime MCP server for Claude Code connects an assistant to ocean shipment data. It can report container ETAs, delays and carrier events, or start tracking a shipment.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: berthtime
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/berthtime/berthtime-mcp
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/berthtime

## What it does

BerthTime lets an AI assistant query ocean shipments, including a container’s current location, expected arrival and carrier event history. It can also find delayed or arriving shipments and begin tracking with a booking reference.

The service is hosted by BerthTime, so there is no server process to install or run locally. A BerthTime account is required; authentication uses OAuth or an API key. Each API key is tied to one company.

Changing shipment data requires read-and-write access and an owner or admin role. Creating shipment share links is limited to paid plans.

## Requirements
- Remote server: `https://berthtime.com/api/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http berthtime https://berthtime.com/api/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add berthtime --url https://berthtime.com/api/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "berthtime": {
            "url": "https://berthtime.com/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "berthtime": {
            "type": "http",
            "url": "https://berthtime.com/api/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http berthtime https://berthtime.com/api/v1/mcp
```

## When to use it
- check a container’s current location
- find delayed shipments
- review carrier events for a shipment
- start tracking from a booking reference

## Example prompts
- Where is container MSCU1234566 now?
- Which of my containers are due to arrive this week?
- Start tracking booking 123456789.

## Similar
- [container-loading](https://affpapa.org/en/nevibecode/mcp/container-loading.md) — MCP server · 467 installs
- [Shipping Rates](https://affpapa.org/en/nevibecode/mcp/shipping-rates.md) — MCP server · 1820 installs
- [Multi-Carrier Shipping API — powered by Secureship](https://affpapa.org/en/nevibecode/mcp/multi-carrier-shipping-api-powered-by-secureship.md) — MCP server · 6130 installs
- [mcp-andreani](https://affpapa.org/en/nevibecode/mcp/mcp-andreani.md) — MCP server · ★ 279 repo stars
- [Shippo](https://affpapa.org/en/nevibecode/mcp/shippo.md) — MCP server · ★ 3 repo stars
- [Easyship](https://affpapa.org/en/nevibecode/mcp/easyship.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
