Vesselapi-mcp Server

An MCP (Model Context Protocol) server that exposes maritime data from the VesselAPI to AI assistants like Claude Desktop, Cursor, Windsurf, and Claude Code.

Local serverstdioMIT

What is the Vesselapi-mcp Server?

Vesselapi Mcp Server is an MCP project maintained in the vessel-api/vesselapi-mcp repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server that exposes maritime data from the VesselAPI to AI assistants like Claude Desktop, Cursor, Windsurf, and Claude Code”. Read the project documentation for the complete scope.

Installation

The documented npm package is vesselapi-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares VESSELAPI_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search_vessels	Search vessels by name, IMO, MMSI, flag, type, callsign, or year built
get_vessel	Get detailed vessel information
get_vessel_position	Get the latest stored vessel position (lat/lon, speed, heading, timestamp); it may be hours or days old
get_vessel_eta	Get the ETA the vessel last reported (declared, not predicted)
get_vessel_emissions	Get EU MRV emissions reports (CO2, fuel consumption)
get_vessel_casualties	Get marine casualty records
get_vessel_positions_batch	Get positions for multiple vessels at once (with optional time range)
search_ports	Search ports by name, country, type, size, region, harbor size, or harbor use
get_port	Get port details by UN/LOCODE
get_port_inbound	Get vessels reporting a port as their destination, within an ETA window
get_port_events	Get arrivals/departures for a port (last 2 hours unless timeFrom is given)
get_port_events_by_vessel	Get port events for a vessel (last 2 hours unless timeFrom is given)
list_port_events	List port events across all covered ports, with filters for time, country, port, vessel, or event type
search_port_events_by_port	Search port events by port name
search_port_events_by_vessel	Search port events by vessel name
get_vessel_last_port_event	Get the most recent port event for a vessel
list_emissions	List EU MRV emissions reports, with an optional reporting-year filter
get_vessels_in_area	Find vessels with an AIS position in a bounding box (default last 2 hours, at most 4 hours)
get_vessels_in_radius	Find vessels with an AIS position within a radius of a point (default last 2 hours, at most 4 hours)

How to install the Vesselapi-mcp Server

{
  "mcpServers": {
    "vesselapi": {
      "command": "npx",
      "args": [
        "-y",
        "vesselapi-mcp"
      ],
      "env": {
        "VESSELAPI_API_KEY": "YOUR_VESSELAPI_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.