Datalastic Vessel Tracking & Maritime Intelligence README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Datalastic Vessel Tracking & Maritime Intelligence listing page.
Datalastic MCP Server
Official Model Context Protocol (MCP) server for Datalastic — real-time vessel tracking, port data, maritime weather, and maritime intelligence for any MCP-compatible AI client.
Overview
The Datalastic MCP server exposes 25 tools across six categories:
- Live vessel positions — track ships in real time by MMSI, IMO, or name
- Vessel registry — specs, dimensions, flag, and tonnage for 750,000+ vessels
- Port data — global port and terminal directory with UN/LOCODEs
- Area search — all vessels currently within a radius of any point or port
- Maritime weather — wave, swell, and sea conditions merged with atmospheric weather, with 7-day forecasts at any coordinates, port, or vessel
- Maritime intelligence (Maritime Reports add-on) — ownership, inspections, casualties, dry dock, engine specs, sale & purchase transactions
The server runs at mcp.datalastic.com — no local installation required.
Getting Started
Sign in with your Datalastic account
No API key needed. Just add https://mcp.datalastic.com/mcp as the server URL in your client with no headers or credentials. When you connect, your client will automatically open a browser window to sign in with your Datalastic account. Once you approve, you're connected — the client handles everything else.
To disconnect, use the disconnect option in your MCP client or revoke access from your Datalastic account settings.
API key
Sign up at datalastic.com/pricing and subscribe to a plan. Your API key is delivered by email and visible in your account dashboard.
For clients that support custom request headers in their config file, use the examples in the Client Configuration section below. For Claude Code, use the CLI command instead.
Client Configuration
Claude Code
Run this command to add the server with your API key:
For Claude Desktop, use OAuth (sign in with your Datalastic account above) — custom header authentication via config file is not yet supported.
Cursor
Edit ~/.cursor/mcp.json:
VS Code (GitHub Copilot)
Edit .vscode/mcp.json in your workspace, or your user-level mcp.json:
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
Gemini CLI
Edit ~/.gemini/settings.json:
Any Streamable HTTP client
Tools
All 25 tools are always listed in your client. The Maritime Intelligence tools require the Maritime Reports add-on; everything else is available on every plan.
Vessel Tracking
get_vessel- Live position, speed, heading, and navigation status for a single vesselget_vessel_pro- Likeget_vesselplus recognized destination port, ETA, actual departure time, and draughtget_vessel_info- Static specifications: dimensions, tonnage, cargo capacity, year built, flag, callsignfind_vessels- Search the registry by name, type, flag, tonnage, or dimensionsget_vessels_bulk- Live positions for up to 100 vessels in one callget_vessel_history- Historical AIS track for a vessel (data available since 2021-08-10)get_vessels_in_radius- All vessels currently within a radius (max 50 NM) of a point, port, or vessel
Choosing the right vessel tool: start with
get_vesselfor a live position. Useget_vessel_proonly when you need the destination port, ETA, or draught.
Ports
find_ports- Search the port registry by name, UN/LOCODE, country, type, or coordinatesget_port- Full port detail including terminals, operators, addresses, and coordinates
Maritime Weather
get_weather- One complete weather picture: marine conditions (waves, swell, currents, sea surface temperature) merged with atmospheric conditions (wind, temperature, visibility, pressure). Works at fixed coordinates, at a port, or around a vessel, resolving to the ship's last known position. Returns current conditions plus 7-day daily and hourly forecasts
Maritime Intelligence (Maritime Reports add-on)
intel_ownership- Beneficial owner, operator, technical and commercial manager, P&I clubintel_inspections- Port State Control inspection records — detentions and deficienciesintel_casualties- Recorded incidents: groundings, collisions, fires, machinery failuresintel_drydock- Next dry-dock date, special-survey date, and IOPP certificate expiryintel_class- Classification society, principal dimensions, and next survey datesintel_engine- Main engine model, builder, propulsion type, and maximum continuous outputintel_spd- Sale-and-purchase and demolition transactions — buyer, seller, reported priceintel_companies- Maritime company profiles: owners, operators, managers, and contact detailssea_route- Schematic sea route and distance in km / NM between two ports or coordinates. For distance estimation and visualization — not for real-world navigation.estimated_vessel_position- Estimated current position for vessels out of terrestrial AIS range (open ocean)intel_report_request- Submit a full bulk export of any Maritime Reports datasetintel_info- Your Maritime Reports add-on status, what the add-on includes, and how to enable it (available on all plans)
Don't have the add-on? Calling a Maritime Intelligence tool without the Maritime Reports add-on returns a message explaining that the add-on is required —
intel_infoshows your status and how to enable it. Upgrades take effect immediately in the same session, no reconnect needed.
Bulk Reports (async)
report_request- Submit an async export:vessel_list,port_list,inradius_history, orrequest_usagereport_status- Poll a report job; returns a download URL when completereport_list- List your recent report jobs and statuses
Reports are generated asynchronously and can take minutes. The server returns a
result_urlto download — it never fetches the file itself. Download links are signed URLs valid for 6 hours; checking the report status again issues a fresh link at any time, free, without regenerating the export. Some exports (full vessel list, area history) can be large and consume API credits.