Vesselapi Mcp Server

by vessel-api

336 downloads
Not rated
GitHub

About

Query maritime vessel tracking data via natural language. Search vessels by name/IMO/MMSI, get real-time positions, ETAs, portevents, emissions, inspections, casualty records, and NAVTEX safety messages. Powered by vesselapi.com.

Details

Author
vessel-api
Downloads
336
Categories
Other, API

- Search vessels by name, IMO, MMSI, flag, or type.
- Get vessel positions, ETAs, classification, and ownership.
- Retrieve emissions reports, inspection history, and casualty records.
- Search ports worldwide and view arrivals/departures.
- Find vessels within a bounding box or radius of any coordinate.
- Access NAVTEX maritime safety messages and weather forecasts.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Vesselapi Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the provided JSON configuration to your MCP client's config file. The server runs via npx with the vesselapi-mcp package. Obtain a free API key by signing up at dashboard.vesselapi.com.

search_vessels

Search for vessels. Use q when you have an identifier but do not know which kind it is; use the specific filters to narrow a fleet.

get_vessel

Get detailed information about a specific vessel

get_vessel_position

Get the current position of a vessel (latitude, longitude, speed, heading)

get_vessel_eta

Get the estimated time of arrival for a vessel

get_vessel_emissions

Get emissions data for a vessel (CO2, fuel consumption)

get_vessel_casualties

Get marine casualty records for a vessel

get_vessel_positions_batch

Get positions for multiple vessels at once by MMSI or IMO numbers

search_ports

Search for ports by name, country, type, size, region, harbor size, or harbor use

get_port

Get detailed information about a specific port by UN/LOCODE

get_port_inbound

Get vessels heading to a specific port within an ETA arrival window

get_port_events

Get port events (arrivals/departures) for a specific port. Covers only the last 2 hours unless timeFrom is given.

get_port_events_by_vessel

Get port events (arrivals/departures) for a specific vessel

list_port_events

List port events (arrivals/departures) globally with optional filters for time, country, port, vessel, or event type

search_port_events_by_port

Search port events by port name. Covers only the last 2 hours unless timeFrom is given.

search_port_events_by_vessel

Search port events by vessel name. Covers only the last 2 hours unless timeFrom is given.

get_vessel_last_port_event

Get the most recent port event (arrival or departure) for a vessel

list_emissions

List global vessel emissions data with optional year filter

get_vessels_in_area

Find all vessels within a rectangular bounding box (latitude/longitude)

get_vessels_in_radius

Find all vessels within a radius of a point. The radius is in METRES, not nautical miles or kilometres.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "vesselapi mcp server": {
            "vesselapi": {
                "command": "npx",
                "args": [
                    "-y",
                    "vesselapi-mcp"
                ],
                "env": {
                    "VESSELAPI_API_KEY": "your-api-key"
                }
            }
        }
    }
}

McpServers

{
    "vesselapi": {
        "command": "npx",
        "args": [
            "-y",
            "vesselapi-mcp"
        ],
        "env": {
            "VESSELAPI_API_KEY": "your-api-key"
        }
    }
}

<h1>VesselAPI MCP Server</h1>
<p>Connect your AI assistant to real-time maritime data. The VesselAPI MCP Server gives Claude, Cursor, Windsurf, and other MCP-compatible tools access to vessel tracking, port activity, and maritime safety information - all through natural language.</p>

<h2>What You Can Do</h2>
<p>Ask your AI assistant questions like:</p>
<ul>
<li>"Where is the Ever Given right now?"</li>
<li>"Show me all vessels near the Port of Rotterdam"</li>
<li>"What ships arrived at Singapore last week?"</li>
<li>"Get the emissions report for IMO 9811000"</li>
<li>"Are there any NAVTEX warnings in the North Sea?"</li>
</ul>

<h2>Available Tools</h2>
<p><strong>Vessels</strong> - Search by name, IMO, MMSI, flag, or type. Get positions, ETAs, classification, ownership, emissions, inspection history, and casualty records.</p>
<p><strong>Ports</strong> - Search ports worldwide. View arrivals and departures by port or by vessel.</p>
<p><strong>Location</strong> - Find all vessels within a bounding box or radius of any coordinate.</p>
<p><strong>Safety</strong> - Retrieve NAVTEX maritime safety messages including navigational warnings and weather forecasts.</p>

<h2>Setup</h2>
<p>No installation required. Add this to your MCP client config:</p>
<pre><code>{
"mcpServers": {
"vesselapi": {
"command": "npx",
"args": ["-y", "vesselapi-mcp"],
"env": {
"VESSELAPI_API_KEY": "your-api-key"
}
}
}
}</code></pre>
<p>Sign up at <a href="https://dashboard.vesselapi.com">dashboard.vesselapi.com</a> to get your API key.</p>

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.