# Vessel Traffic MCP

This read-only MCP server gives agents vessel, port-call, and shipping-schedule data. Use it to test maritime workflows with fixture data or connected providers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: tools-mcp
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tools-mcp/vessel-traffic-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/vessel-traffic-mcp

## What it does

Vessel Traffic MCP exposes one read-only interface for maritime data. An agent can identify a vessel by name, MMSI, IMO number, callsign, or bill-of-lading text, then request its position, past movement, nearby vessels, port calls, or container-shipping schedules. Results from live and public sources include the provider name and original landing URL.

The server includes generic `search` and `fetch` operations, vessel identity and movement tools, schedule tools, and provider-configuration tools. Its default fixture mode runs without network access, accounts, or API keys. Public providers are enabled with `VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS`; commercial services use the user’s own credentials. It is not a navigation product.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VESSEL_MCP_TRANSPORT`, `VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VESSEL_MCP_TRANSPORT=<VESSEL_MCP_TRANSPORT> --env VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=<VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS> --transport stdio vessel-traffic-mcp -- npx -y @tools-mcp/vessel-traffic-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add vessel-traffic-mcp --env VESSEL_MCP_TRANSPORT=<VESSEL_MCP_TRANSPORT> --env VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=<VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS> -- npx -y @tools-mcp/vessel-traffic-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vessel-traffic-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@tools-mcp/vessel-traffic-mcp"
            ],
            "env": {
                "VESSEL_MCP_TRANSPORT": "<VESSEL_MCP_TRANSPORT>",
                "VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS": "<VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vessel-traffic-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tools-mcp/vessel-traffic-mcp"
            ],
            "env": {
                "VESSEL_MCP_TRANSPORT": "<VESSEL_MCP_TRANSPORT>",
                "VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS": "<VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VESSEL_MCP_TRANSPORT=<VESSEL_MCP_TRANSPORT> -e VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=<VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS> vessel-traffic-mcp npx -y @tools-mcp/vessel-traffic-mcp
```
Replace <…> with your own values

## When to use it
- resolve a vessel from an IMO or MMSI number
- retrieve a ship’s current position and track
- list vessels operating in an area
- search a carrier schedule between two ports
- test maritime agent flows with fixture data

## Example prompts
- Find the current position of EVER GIVEN and return the provider and original source URL.
- Search the carrier schedule from KRPUS to NLRTM and include its source link.
- Identify the vessel from this IMO number and show its recent port calls.

## Similar
- [Datalastic Vessel Tracking & Maritime Intelligence](https://affpapa.org/en/nevibecode/mcp/datalastic-vessel-tracking-maritime-intelligence.md) — MCP server
- [Open Waters AIS](https://affpapa.org/en/nevibecode/mcp/open-waters-ais.md) — MCP server · ★ 8
- [track-planes-and-ships](https://affpapa.org/en/nevibecode/skills/track-planes-and-ships.md) — skill · 1700 installs
- [novaposhta](https://affpapa.org/en/nevibecode/mcp/novaposhta.md) — MCP server · ★ 7
- [proxyman-traffic-debugging](https://affpapa.org/en/nevibecode/skills/proxyman-traffic-debugging.md) — skill · 490 installs
- [mcp-andreani](https://affpapa.org/en/nevibecode/mcp/mcp-andreani.md) — MCP server · ★ 274

---
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