Vessel MCP Server

Read-only Model Context Protocol (MCP) server for vessel AIS / ship tracking data — connects Claude, ChatGPT, Claude Code, and Codex plugin workflows

Local serverstdio

What is the Vessel MCP server?

Connect Vessel to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Read-only Model Context Protocol (MCP) server for vessel AIS / ship tracking data — connects Claude, ChatGPT, Claude Code, and Codex plugin workflows to MarineTraffic, VesselFinder, AISStream, AISHub, and other authorized maritime data. The vessel mcp server is what makes that connection.

What the server does

Vessel Traffic MCP is a read-only Model Context Protocol (MCP) server for vessel identity lookup, AIS-style positions, tracks, port calls, carrier schedules, vessel schedules, and delay heuristics. It gives Claude, ChatGPT, Codex, MCP Inspector, and other MCP clients one normalized maritime-data tool surface.

Installation

npm on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • carrier_schedule_search — vessel_schedule
  • provider_status — data_sources
  • credential_profiles — provider_onboarding

Credentials and setup notes

Configuration is passed through the environment: VESSEL_MCP_TRANSPORT, VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS, VESSEL_MCP_HTTP_HOST, VESSEL_MCP_HTTP_PORT, VESSEL_MCP_AUTH_TOKEN, VESSEL_MCP_PROFILE_MARINETRAFFIC__API_KEY, VESSEL_MCP_ENABLE_BYOK_PROVIDERS. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Vessel's toolset — carrier_schedule_search, provider_status, credential_profiles — is a fair guide to whether it matches your workflow. It is maintained by seokmogu; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
carrier_schedule_searchvessel_schedule
provider_statusdata_sources
credential_profilesprovider_onboarding

How to install the Vessel MCP server

{
  "mcpServers": {
    "vessel-traffic-mcp": {
      "command": "npx",
      "args": ["-y", "@tools-mcp/vessel-traffic-mcp"],
      "env": {
        "VESSEL_MCP_TRANSPORT": "stdio",
        "VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS": "myshiptracking,tradlinx"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
VESSEL_MCP_TRANSPORTConfiguration value read at startup.Optional
VESSEL_MCP_ENABLE_PUBLIC_PROVIDERSConfiguration value read at startup.Optional
VESSEL_MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional
VESSEL_MCP_HTTP_PORTConfiguration value read at startup.Optional
VESSEL_MCP_AUTH_TOKENCredential the server authenticates with.Yes
VESSEL_MCP_PROFILE_MARINETRAFFIC__API_KEYCredential the server authenticates with.Yes
VESSEL_MCP_ENABLE_BYOK_PROVIDERSConfiguration value read at startup.Optional

Example prompts to try

  • Use Vessel to carrier schedule search.
  • Use Vessel to provider status.
  • Use Vessel to credential profiles.

Frequently asked questions

It connects Vessel to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (carrier_schedule_search, provider_status, credential_profiles) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Vessel directly.