MCP-Server
Datalastic Vessel Tracking & Maritime Intelligence
com.datalastic/vessel-tracking
Was dieses MCP kann
Provides live and historical vessel tracking, port and terminal data, maritime ownership and inspection intelligence, routes, schedules, weather, and fleet reports.
Funktionen
Tools
25
Tools
estimated_vessel_position
Estimate a vessel's current position (SAT-E)
Estimate where a vessel is right now when its last AIS position is stale â Datalastic uses terrestrial AIS only, so a ship in open ocean can be many hours old. The position is calculated from the last known fix, the recognized destination port, and the route-based ETA. It is an ESTIMATE, not an observed position.
Tool selection â use this LAST: prefer get_vessel for a live position (cheapest); prefer get_vessel_pro when the user wants the ETA or recognized destination. Only reach for this tool when BOTH hold: (1) a prior get_vessel/get_vessel_pro lookup shows the last known position is old, and (2) the vessel has a destination and an ETA. It is the heaviest call (it builds a route) and adds nothing when get_vessel already returns a recent position.
Because it is an estimate, OFFER it to the user first rather than calling it silently, and when you present the result make clear it is an estimated position, not a real fix. If estimated_position equals the last known lat/lon, the system could not extrapolate (the position is recent, or the ETA is missing/outdated) â say so instead of implying movement.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number, exactly 7 digits. Provide exactly one of mmsi, imo, or uuid.'}, 'mmsi': {'type': 'string', 'description': 'Vessel MMSI identifier, exactly 9 digits. Provide exactly one of mmsi, imo, or uuid.'}, 'uuid': {'type': 'string', 'description': 'Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'lat', 'lon', 'speed', 'course', 'heading', 'current_draught', 'navigation_status', 'destination', 'dest_port_uuid', 'dest_port', 'dest_port_unlocode', 'dep_port_uuid', 'dep_port', 'dep_port_unlocode', 'last_position_epoch', 'last_position_UTC', 'atd_epoch', 'atd_UTC', 'eta_epoch', 'eta_UTC', 'timezone_offset_sec', 'timezone', 'estimated_position'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'atd_UTC': {'type': ['null', 'string']}, 'eta_UTC': {'type': ['null', 'string']}, 'heading': {'type': ['null', 'integer']}, 'dep_port': {'type': ['null', 'string']}, 'timezone': {'type': ['null', 'string']}, 'atd_epoch': {'type': ['null', 'integer']}, 'dest_port': {'type': ['null', 'string']}, 'eta_epoch': {'type': ['null', 'integer']}, 'country_iso': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'dep_port_uuid': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}, 'dest_port_uuid': {'type': ['null', 'string']}, 'current_draught': {'type': ['null', 'number']}, 'dep_port_unlocode': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'navigation_status': {'type': ['null', 'string']}, 'dest_port_unlocode': {'type': ['null', 'string']}, 'estimated_position': {'type': ['null', 'object'], 'required': ['lat', 'lon'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}}, 'additionalProperties': False}, 'last_position_epoch': {'type': ['null', 'integer']}, 'timezone_offset_sec': {'type': ['null', 'integer']}}, 'additionalProperties': False}
find_ports
Search for ports
Search the port registry and return matching ports (identity, country, UN/LOCODE, classification, coordinates, maritime area). Search by name (optionally fuzzy), UN/LOCODE, classification, country, or geographically (lat + lon + radius in nautical miles). Always returns a list, even for a single match. Use this to discover ports or resolve a name to a UN/LOCODE/uuid; for full detail on one known port (including terminals) use get_port.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'lat': {'type': ['null', 'number'], 'description': 'Center latitude for a geographic search (use with lon and radius).'}, 'lon': {'type': ['null', 'number'], 'description': 'Center longitude for a geographic search (use with lat and radius).'}, 'name': {'type': 'string', 'description': 'Port name to search for (set fuzzy for approximate matching).'}, 'uuid': {'type': 'string', 'description': 'Datalastic port UUID.'}, 'fuzzy': {'type': 'boolean', 'description': 'Match the name approximately instead of exactly.'}, 'radius': {'type': 'number', 'description': 'Search radius in nautical miles (max 50); requires lat and lon.'}, 'unlocode': {'type': 'string', 'description': 'Port UN/LOCODE: 5 alphanumeric characters (case-insensitive).'}, 'port_type': {'type': 'string', 'description': 'Filter by classification. One of: Port, Anchorage, Marina, Offshore Terminal, Shelter, Demolition Yard, Canal, Fishing Harbour.'}, 'country_iso': {'type': 'string', 'description': '2-letter ISO country code (e.g. GB).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['ports'], 'properties': {'ports': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['uuid', 'port_name', 'country_iso', 'country_name', 'unlocode', 'port_type', 'lat', 'lon', 'area_lvl1', 'area_lvl2'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'uuid': {'type': 'string'}, 'unlocode': {'type': ['null', 'string']}, 'area_lvl1': {'type': ['null', 'string']}, 'area_lvl2': {'type': ['null', 'string']}, 'port_name': {'type': ['null', 'string']}, 'port_type': {'type': ['null', 'string']}, 'country_iso': {'type': ['null', 'string']}, 'country_name': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
find_vessels
Find vessels (registry search)
Search the vessel registry by any combination of name (optionally fuzzy), type, flag country, dimensions, tonnage, or year built â no MMSI or IMO needed. Returns up to 500 static specification records per page (tonnage, dimensions, year built, home port, callsign, etc.) â this is reference data, NOT live position. Provide at least one search criterion; use the response's next token via the next argument to page. Credits: 1 per vessel found. For a vessel's live position use get_vessel; for vessels currently in an area use get_vessels_in_radius.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Vessel name to search for. Combine with fuzzy for similar-name matching.'}, 'next': {'type': 'string', 'description': "Pagination token from a previous response's next field, to fetch the next page (up to 500 results per page)."}, 'type': {'type': 'string', 'description': 'Filter by vessel type (e.g. Cargo, Tanker).'}, 'fuzzy': {'type': 'boolean', 'description': 'If true, match similar/approximate names; if false (default) the name must match exactly. Only meaningful together with name.'}, 'length_max': {'type': ['null', 'number'], 'description': 'Maximum length (meters).'}, 'length_min': {'type': ['null', 'number'], 'description': 'Minimum length (meters).'}, 'breadth_max': {'type': ['null', 'number'], 'description': 'Maximum breadth (meters).'}, 'breadth_min': {'type': ['null', 'number'], 'description': 'Minimum breadth (meters).'}, 'country_iso': {'type': 'string', 'description': 'Filter by flag country, 2-letter ISO code (e.g. MT).'}, 'type_specific': {'type': 'string', 'description': 'Filter by vessel subtype (e.g. Bulk Carrier).'}, 'deadweight_max': {'type': ['null', 'integer'], 'description': 'Maximum deadweight (tonnes).'}, 'deadweight_min': {'type': ['null', 'integer'], 'description': 'Minimum deadweight (tonnes).'}, 'year_built_max': {'type': ['null', 'integer'], 'description': 'Latest year built.'}, 'year_built_min': {'type': ['null', 'integer'], 'description': 'Earliest year built.'}, 'gross_tonnage_max': {'type': ['null', 'integer'], 'description': 'Maximum gross tonnage.'}, 'gross_tonnage_min': {'type': ['null', 'integer'], 'description': 'Minimum gross tonnage.'}, 'include_unknown_type': {'type': ['null', 'boolean'], 'description': "Include vessels with no/unknown type. Maps to the API's _empty_."}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['vessels', 'next'], 'properties': {'next': {'type': ['null', 'string']}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['uuid', 'name', 'name_ais', 'mmsi', 'imo', 'eni', 'country_iso', 'country_name', 'callsign', 'type', 'type_specific', 'gross_tonnage', 'deadweight', 'teu', 'liquid_gas', 'length', 'breadth', 'draught_avg', 'draught_max', 'speed_avg', 'speed_max', 'year_built', 'is_navaid', 'home_port'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'teu': {'type': ['null', 'string']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'length': {'type': ['null', 'number']}, 'breadth': {'type': ['null', 'number']}, 'callsign': {'type': ['null', 'string']}, 'name_ais': {'type': ['null', 'string']}, 'home_port': {'type': ['null', 'string']}, 'is_navaid': {'type': ['null', 'boolean']}, 'speed_avg': {'type': ['null', 'number']}, 'speed_max': {'type': ['null', 'number']}, 'deadweight': {'type': ['null', 'integer']}, 'liquid_gas': {'type': ['null', 'string']}, 'year_built': {'type': ['null', 'string']}, 'country_iso': {'type': ['null', 'string']}, 'draught_avg': {'type': ['null', 'number']}, 'draught_max': {'type': ['null', 'number']}, 'country_name': {'type': ['null', 'string']}, 'gross_tonnage': {'type': ['null', 'integer']}, 'type_specific': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_port
Get one port with its terminals
Return detailed information for a single port â identity, country, UN/LOCODE, classification, coordinates, maritime area, and the list of terminals (name, operating company, coordinates, address, website). Look up the port by its Datalastic uuid or its UN/LOCODE (exactly one). To search for a port by name or location, or when you don't have an exact identifier, use find_ports first.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'uuid': {'type': 'string', 'description': 'Datalastic port UUID. Provide exactly one of uuid or unlocode.'}, 'unlocode': {'type': 'string', 'description': 'Port UN/LOCODE: 5 alphanumeric characters, e.g. ESMPG (case-insensitive). Provide exactly one of uuid or unlocode.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'port_name', 'country_iso', 'country_name', 'unlocode', 'port_type', 'lat', 'lon', 'area_lvl1', 'area_lvl2', 'terminals'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'uuid': {'type': 'string'}, 'unlocode': {'type': ['null', 'string']}, 'area_lvl1': {'type': ['null', 'string']}, 'area_lvl2': {'type': ['null', 'string']}, 'port_name': {'type': ['null', 'string']}, 'port_type': {'type': ['null', 'string']}, 'terminals': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['terminal_code', 'terminal_name', 'company_name', 'lat', 'lon', 'url', 'address'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'url': {'type': ['null', 'string']}, 'address': {'type': ['null', 'string']}, 'company_name': {'type': ['null', 'string']}, 'terminal_code': {'type': ['null', 'string']}, 'terminal_name': {'type': ['null', 'string']}}, 'additionalProperties': False}}, 'country_iso': {'type': ['null', 'string']}, 'country_name': {'type': ['null', 'string']}}, 'additionalProperties': False}
get_vessel
Get vessel position
Return the current position and basic information for a single vessel, identified by exactly one of: MMSI (9 digits), IMO (7 digits), or Datalastic UUID. Includes live coordinates, speed, course, heading, navigation status and the raw AIS destination text. This is the default tool for vessel lookups. For the recognized destination or origin port (name + UNLOCODE), actual departure time (ATD), a reliable estimated time of arrival (ETA), or draught, use get_vessel_pro instead.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number, exactly 7 digits (e.g. 9839179). Provide exactly one of mmsi, imo, or uuid.'}, 'mmsi': {'type': 'string', 'description': 'Vessel MMSI identifier, exactly 9 digits (e.g. 477553000). Provide exactly one of mmsi, imo, or uuid.'}, 'uuid': {'type': 'string', 'description': 'Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'lat', 'lon', 'speed', 'course', 'heading', 'navigation_status', 'destination', 'last_position_epoch', 'last_position_UTC', 'eta_epoch', 'eta_UTC'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'eta_UTC': {'type': ['null', 'string']}, 'heading': {'type': ['null', 'integer']}, 'eta_epoch': {'type': ['null', 'integer']}, 'country_iso': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'navigation_status': {'type': ['null', 'string']}, 'last_position_epoch': {'type': ['null', 'integer']}}, 'additionalProperties': False}
get_vessel_history
Get vessel history
Return the historical track (ordered position records) for a single vessel, identified by exactly one of: MMSI (9 digits), IMO (7 digits), or Datalastic UUID. Specify the time range with either 'days' (last N days) or 'from'/'to' dates (YYYY-MM-DD, 'to' at most 30 days after 'from'). Data is available since 2021-08-10; only position changes are stored, so stationary periods may have gaps.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': "End date YYYY-MM-DD (at most 30 days after 'from'). Requires 'from'. Defaults to now if omitted."}, 'imo': {'type': 'string', 'description': 'Vessel IMO number, exactly 7 digits. Provide exactly one of mmsi, imo, or uuid.'}, 'days': {'type': 'integer', 'description': 'Number of past days from today to include (e.g. 3). Use either days OR from/to, not both.'}, 'from': {'type': 'string', 'description': 'Start date YYYY-MM-DD. Data is available since 2021-08-10. Use either from/to OR days, not both.'}, 'mmsi': {'type': 'string', 'description': 'Vessel MMSI identifier, exactly 9 digits. Provide exactly one of mmsi, imo, or uuid.'}, 'uuid': {'type': 'string', 'description': 'Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'positions'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'positions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['lat', 'lon', 'speed', 'course', 'heading', 'destination', 'last_position_epoch', 'last_position_UTC'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'heading': {'type': ['null', 'integer']}, 'destination': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'last_position_epoch': {'type': ['null', 'integer']}}, 'additionalProperties': False}}, 'country_iso': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}}, 'additionalProperties': False}
get_vessel_info
Get vessel specifications
Return static specifications for a single vessel, identified by exactly one of: MMSI (9 digits), IMO (7 digits), or Datalastic UUID. Includes physical dimensions (length, breadth, draught), tonnage and cargo capacity (gross tonnage, deadweight, TEU, liquid gas), speed characteristics, year built, flag country, callsign and home port. This is reference data, NOT live position â use get_vessel for the current position, or find_vessels to search the registry by attributes.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number, exactly 7 digits (e.g. 9525338). Provide exactly one of mmsi, imo, or uuid.'}, 'mmsi': {'type': 'string', 'description': 'Vessel MMSI identifier, exactly 9 digits (e.g. 566093000). Provide exactly one of mmsi, imo, or uuid.'}, 'uuid': {'type': 'string', 'description': 'Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'name', 'name_ais', 'mmsi', 'imo', 'eni', 'country_iso', 'country_name', 'callsign', 'type', 'type_specific', 'gross_tonnage', 'deadweight', 'teu', 'liquid_gas', 'length', 'breadth', 'draught_avg', 'draught_max', 'speed_avg', 'speed_max', 'year_built', 'is_navaid', 'home_port'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'teu': {'type': ['null', 'string']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'length': {'type': ['null', 'number']}, 'breadth': {'type': ['null', 'number']}, 'callsign': {'type': ['null', 'string']}, 'name_ais': {'type': ['null', 'string']}, 'home_port': {'type': ['null', 'string']}, 'is_navaid': {'type': ['null', 'boolean']}, 'speed_avg': {'type': ['null', 'number']}, 'speed_max': {'type': ['null', 'number']}, 'deadweight': {'type': ['null', 'integer']}, 'liquid_gas': {'type': ['null', 'string']}, 'year_built': {'type': ['null', 'string']}, 'country_iso': {'type': ['null', 'string']}, 'draught_avg': {'type': ['null', 'number']}, 'draught_max': {'type': ['null', 'number']}, 'country_name': {'type': ['null', 'string']}, 'gross_tonnage': {'type': ['null', 'integer']}, 'type_specific': {'type': ['null', 'string']}}, 'additionalProperties': False}
get_vessel_pro
Get vessel position (enriched)
Richer, heavier variant of get_vessel for a single vessel, identified by exactly one of: MMSI (9 digits), IMO (7 digits), or Datalastic UUID. In addition to the basic position and identity, it returns the recognized destination port and origin port (name + UNLOCODE), the actual time of departure (ATD), a reliable estimated time of arrival (ETA), and current draught. Prefer get_vessel for ordinary position or identity lookups; use get_vessel_pro only when the user asks about the destination or origin port, departure time, arrival time or ETA, or draught, as it is heavier on the backend. If the last known position is stale (the vessel may be out of terrestrial AIS range) and it has a destination and ETA, consider offering estimated_vessel_position to estimate where it is now.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number, exactly 7 digits (e.g. 9839179). Provide exactly one of mmsi, imo, or uuid.'}, 'mmsi': {'type': 'string', 'description': 'Vessel MMSI identifier, exactly 9 digits (e.g. 477553000). Provide exactly one of mmsi, imo, or uuid.'}, 'uuid': {'type': 'string', 'description': 'Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'lat', 'lon', 'speed', 'course', 'heading', 'current_draught', 'navigation_status', 'destination', 'dest_port_uuid', 'dest_port', 'dest_port_unlocode', 'dep_port_uuid', 'dep_port', 'dep_port_unlocode', 'last_position_epoch', 'last_position_UTC', 'atd_epoch', 'atd_UTC', 'eta_epoch', 'eta_UTC', 'timezone_offset_sec', 'timezone'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'atd_UTC': {'type': ['null', 'string']}, 'eta_UTC': {'type': ['null', 'string']}, 'heading': {'type': ['null', 'integer']}, 'dep_port': {'type': ['null', 'string']}, 'timezone': {'type': ['null', 'string']}, 'atd_epoch': {'type': ['null', 'integer']}, 'dest_port': {'type': ['null', 'string']}, 'eta_epoch': {'type': ['null', 'integer']}, 'country_iso': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'dep_port_uuid': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}, 'dest_port_uuid': {'type': ['null', 'string']}, 'current_draught': {'type': ['null', 'number']}, 'dep_port_unlocode': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'navigation_status': {'type': ['null', 'string']}, 'dest_port_unlocode': {'type': ['null', 'string']}, 'last_position_epoch': {'type': ['null', 'integer']}, 'timezone_offset_sec': {'type': ['null', 'integer']}}, 'additionalProperties': False}
get_vessels_bulk
Get many vessels at once (bulk position)
Return the current position and basic information for many vessels in a single call â supply any mix of MMSI, IMO and UUID lists, up to 100 identifiers in total. Each result has the same fields as get_vessel. Only successfully found vessels are returned (the response includes how many were found). Use this instead of many get_vessel calls when looking up a known set of vessels; for a single vessel use get_vessel.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'List of vessel IMO numbers (each exactly 7 digits).'}, 'mmsi': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'List of vessel MMSI identifiers (each exactly 9 digits).'}, 'uuid': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'List of Datalastic vessel UUIDs.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['total', 'vessels'], 'properties': {'total': {'type': ['null', 'integer']}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'lat', 'lon', 'speed', 'course', 'heading', 'navigation_status', 'destination', 'last_position_epoch', 'last_position_UTC', 'eta_epoch', 'eta_UTC'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'eta_UTC': {'type': ['null', 'string']}, 'heading': {'type': ['null', 'integer']}, 'eta_epoch': {'type': ['null', 'integer']}, 'country_iso': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'navigation_status': {'type': ['null', 'string']}, 'last_position_epoch': {'type': ['null', 'integer']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_vessels_in_radius
Get vessels in radius (area scan)
Scan a circular area and return all vessels currently within a given radius (nautical miles, greater than 0 and at most 50). Specify the center in exactly one way: lat+lon coordinates, a port (port_unlocode or port_uuid), or a vessel to center on (mmsi/imo/uuid). Optional filters: type, type_specific, exclude, nav_status, and include_unknown_type. Returns up to 500 vessels per page, each with its distance (nautical miles) from the center; if more remain, pass the response's 'next' token via the 'next' argument to page through them. Credits are charged per vessel found.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['radius'], 'properties': {'imo': {'type': 'string', 'description': 'Center the scan on a vessel, by IMO (exactly 7 digits).'}, 'lat': {'type': ['null', 'number'], 'description': 'Center latitude (-90..90). Must be used together with lon. Provide exactly one center: lat+lon, a port, or a vessel identifier.'}, 'lon': {'type': ['null', 'number'], 'description': 'Center longitude (-180..180). Must be used together with lat.'}, 'mmsi': {'type': 'string', 'description': 'Center the scan on a vessel, by MMSI (exactly 9 digits).'}, 'next': {'type': 'string', 'description': "Optional: pagination token from a previous response's 'next' field, to fetch the next page (up to 500 vessels per page)."}, 'type': {'type': 'string', 'description': 'Optional: only include vessels of this type (e.g. Tanker, Cargo).'}, 'uuid': {'type': 'string', 'description': 'Center the scan on a vessel, by Datalastic vessel UUID.'}, 'radius': {'type': 'number', 'description': 'Required. Scan radius in nautical miles, greater than 0 and at most 50.'}, 'exclude': {'type': 'string', 'description': 'Optional: exclude vessels of this type.'}, 'port_uuid': {'type': 'string', 'description': 'Center the scan on a port, by Datalastic port UUID.'}, 'nav_status': {'type': ['null', 'integer'], 'description': 'Optional: filter by AIS navigational status number (e.g. 0 = under way using engine).'}, 'port_unlocode': {'type': 'string', 'description': 'Center the scan on a port, by UN/LOCODE (e.g. ESVLC).'}, 'type_specific': {'type': 'string', 'description': 'Optional: only include vessels of this specific subtype (e.g. LPG Tanker).'}, 'include_unknown_type': {'type': ['null', 'boolean'], 'description': 'Optional: include vessels that have no/unknown type. Defaults to the API default when omitted.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['point', 'total', 'vessels', 'next'], 'properties': {'next': {'type': ['null', 'string']}, 'point': {'type': ['null', 'object'], 'required': ['lat', 'lon', 'radius'], 'properties': {'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'radius': {'type': ['null', 'number']}}, 'additionalProperties': False}, 'total': {'type': ['null', 'integer']}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['uuid', 'name', 'mmsi', 'imo', 'eni', 'country_iso', 'type', 'type_specific', 'lat', 'lon', 'speed', 'course', 'heading', 'navigation_status', 'destination', 'last_position_epoch', 'last_position_UTC', 'eta_epoch', 'eta_UTC', 'distance'], 'properties': {'eni': {'type': ['null', 'string']}, 'imo': {'type': ['null', 'string']}, 'lat': {'type': ['null', 'number']}, 'lon': {'type': ['null', 'number']}, 'mmsi': {'type': ['null', 'string']}, 'name': {'type': ['null', 'string']}, 'type': {'type': ['null', 'string']}, 'uuid': {'type': 'string'}, 'speed': {'type': ['null', 'number']}, 'course': {'type': ['null', 'number']}, 'eta_UTC': {'type': ['null', 'string']}, 'heading': {'type': ['null', 'integer']}, 'distance': {'type': ['null', 'number']}, 'eta_epoch': {'type': ['null', 'integer']}, 'country_iso': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'type_specific': {'type': ['null', 'string']}, 'last_position_UTC': {'type': ['null', 'string']}, 'navigation_status': {'type': ['null', 'string']}, 'last_position_epoch': {'type': ['null', 'integer']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_weather
Get weather for a location
Return weather for one location: marine conditions (wave height/direction/period, swell, sea-surface temperature, ocean currents, sea level, â¦) plus general atmospheric conditions (air temperature, precipitation, wind speed/direction/gusts, humidity, cloud cover, visibility, pressure, weather code, â¦). Specify the location as exactly one of: coordinates (lat+lon), a vessel (mmsi/imo/uuid â weather near its last known position), or a port (port_unlocode/port_uuid). Use mode to choose current conditions (default), a 7-day daily forecast, a 7-day hourly forecast, or any combination. Each weather field has a matching entry in the corresponding *_units object.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Weather near this vessel by IMO (7 digits).'}, 'lat': {'type': ['null', 'number'], 'description': 'Latitude of the location (use together with lon).'}, 'lon': {'type': ['null', 'number'], 'description': 'Longitude of the location (use together with lat).'}, 'mmsi': {'type': 'string', 'description': 'Weather near this vessel by MMSI (9 digits).'}, 'mode': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Forecast mode(s); omit for current. One or more of: current (now), daily (7-day daily forecast), hourly (7-day hourly forecast). Combine for several at once.'}, 'uuid': {'type': 'string', 'description': 'Weather near this vessel by Datalastic UUID.'}, 'port_uuid': {'type': 'string', 'description': 'Weather near this port by Datalastic port UUID.'}, 'port_unlocode': {'type': 'string', 'description': 'Weather near this port by UN/LOCODE (5 alphanumeric, case-insensitive).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['location', 'weather'], 'properties': {'weather': {'type': 'object', 'additionalProperties': True}, 'location': {'type': ['null', 'object'], 'required': ['type', 'geometry', 'properties'], 'properties': {'type': {'type': 'string'}, 'geometry': {'type': 'object', 'required': ['type', 'coordinates'], 'properties': {'type': {'type': 'string'}, 'coordinates': {'type': ['null', 'array'], 'items': {'type': 'number'}}}, 'additionalProperties': False}, 'properties': {'type': 'object', 'required': ['type', 'mmsi', 'imo', 'uuid', 'port_name', 'port_uuid', 'port_unlocode'], 'properties': {'imo': {'type': ['null', 'string']}, 'mmsi': {'type': ['null', 'string']}, 'type': {'type': 'string'}, 'uuid': {'type': ['null', 'string']}, 'port_name': {'type': ['null', 'string']}, 'port_uuid': {'type': ['null', 'string']}, 'port_unlocode': {'type': ['null', 'string']}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}
intel_casualties
Vessel casualty & incident history
Retrieve a vessel's recorded maritime incidents â groundings, collisions, fires, machinery breakdowns, detentions and similar events â each with a date, category and a narrative description. Useful for risk and condition assessment. Identify the vessel by imo or name, and optionally bound the period with from / to. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'Only include incidents on or before this date (YYYY-MM-DD).'}, 'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'from': {'type': 'string', 'description': 'Only include incidents on or after this date (YYYY-MM-DD).'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'imo', 'vessel_name', 'casualty_date', 'casualty_type', 'casualty_details', 'modified_at'], 'properties': {'id': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'casualty_date': {'type': ['null', 'string']}, 'casualty_type': {'type': ['null', 'string']}, 'casualty_details': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_class
Vessel classification & technical particulars
Return a vessel's classification society together with its principal technical particulars: gross and net tonnage, deadweight, length overall, length between perpendiculars, beam, depth, design draft, propulsion and engine maker, plus owner/manager and next survey dates. Identify the vessel by imo or name (set fuzzy for loose name matching), or filter by owner/manager. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}, 'fuzzy': {'type': 'boolean', 'description': 'Match the name loosely instead of exactly.'}, 'updated_from': {'type': 'string', 'description': 'Only include records updated on or after this date (YYYY-MM-DD).'}, 'beneficial_owner': {'type': 'string', 'description': 'Filter by beneficial owner company name.'}, 'technical_manager': {'type': 'string', 'description': 'Filter by technical manager company name.'}, 'beneficial_owner_imo': {'type': 'string', 'description': 'Filter by beneficial owner company IMO number.'}, 'technical_manager_imo': {'type': 'string', 'description': 'Filter by technical manager company IMO number.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['imo', 'vessel_name', 'vessel_type_code', 'flag_name', 'built_year', 'dwt_design', 'special_survey_date', 'dry_dock_date', 'class1_code', 'beneficial_owner_imo', 'beneficial_owner', 'technical_manager_imo', 'technical_manager', 'draft_design', 'nt', 'gt', 'loa', 'lbp', 'depth', 'beam_moduled', 'engine_builder', 'engine_designer', 'propulsion_type_code', 'modified_at'], 'properties': {'gt': {'type': ['null', 'integer']}, 'nt': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'lbp': {'type': ['null', 'number']}, 'loa': {'type': ['null', 'number']}, 'depth': {'type': ['null', 'number']}, 'flag_name': {'type': ['null', 'string']}, 'built_year': {'type': ['null', 'string']}, 'dwt_design': {'type': ['null', 'integer']}, 'class1_code': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'beam_moduled': {'type': ['null', 'number']}, 'draft_design': {'type': ['null', 'number']}, 'dry_dock_date': {'type': ['null', 'string']}, 'engine_builder': {'type': ['null', 'string']}, 'engine_designer': {'type': ['null', 'string']}, 'beneficial_owner': {'type': ['null', 'string']}, 'vessel_type_code': {'type': ['null', 'string']}, 'technical_manager': {'type': ['null', 'string']}, 'special_survey_date': {'type': ['null', 'string']}, 'beneficial_owner_imo': {'type': ['null', 'string']}, 'propulsion_type_code': {'type': ['null', 'string']}, 'technical_manager_imo': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_companies
Maritime company profile
Look up a maritime company profile â owners, operators, managers and charterers â returning its full and short name, company type, registration country, operating status, contact details, and parent company. Search by the company's own IMO number (company_imo) or by name. This is a company directory, so company_imo refers to the company (not a vessel); to find the companies behind a specific ship use intel_ownership. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Company name to search for.'}, 'company_imo': {'type': 'string', 'description': "Company IMO number (exactly 7 digits). Note this is the company's own IMO, not a vessel IMO."}, 'updated_from': {'type': 'string', 'description': 'Only include records updated on or after this date (YYYY-MM-DD).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'short_name', 'long_name', 'company_type', 'country_code', 'company_imo', 'website', 'company_status', 'email', 'phone', 'address', 'linkedin', 'parent_company_imo', 'parent_company_name', 'modified_at'], 'properties': {'id': {'type': ['null', 'integer']}, 'email': {'type': ['null', 'string']}, 'phone': {'type': ['null', 'string']}, 'address': {'type': ['null', 'string']}, 'website': {'type': ['null', 'string']}, 'linkedin': {'type': ['null', 'string']}, 'long_name': {'type': ['null', 'string']}, 'short_name': {'type': ['null', 'string']}, 'company_imo': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'company_type': {'type': ['null', 'string']}, 'country_code': {'type': ['null', 'string']}, 'company_status': {'type': ['null', 'string']}, 'parent_company_imo': {'type': ['null', 'string']}, 'parent_company_name': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_drydock
Vessel drydock & survey schedule
Look up planned and past dry-dock dates, special-survey dates, and IOPP (oil-pollution) certificate dates for a vessel, along with its technical manager's contact details. Target a single vessel by imo or name, or scan a forward window across the fleet with dry_dock_from / dry_dock_to to find vessels due for drydocking in a date range. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}, 'dry_dock_to': {'type': 'string', 'description': 'Only include vessels whose next dry dock falls on or before this date (YYYY-MM-DD).'}, 'dry_dock_from': {'type': 'string', 'description': 'Only include vessels whose next dry dock falls on or after this date (YYYY-MM-DD).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'imo', 'vessel_name', 'special_survey_date', 'dry_dock_date', 'iopp_issue_date', 'iopp_exp_date', 'country_name', 'technical_manager', 'country_code', 'website', 'email', 'phone', 'address', 'linkedin', 'modified_at'], 'properties': {'id': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'email': {'type': ['null', 'string']}, 'phone': {'type': ['null', 'string']}, 'address': {'type': ['null', 'string']}, 'website': {'type': ['null', 'string']}, 'linkedin': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'country_code': {'type': ['null', 'string']}, 'country_name': {'type': ['null', 'string']}, 'dry_dock_date': {'type': ['null', 'string']}, 'iopp_exp_date': {'type': ['null', 'string']}, 'iopp_issue_date': {'type': ['null', 'string']}, 'technical_manager': {'type': ['null', 'string']}, 'special_survey_date': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_engine
Vessel main-engine specifications
Return the main-engine specification for a vessel: engine designation (model), builder and designer, propulsion type, and maximum continuous output (MCO) with its unit and rpm. Identify the vessel by imo or name (set fuzzy for loose name matching). Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}, 'fuzzy': {'type': 'boolean', 'description': 'Match the name loosely instead of exactly.'}, 'updated_from': {'type': 'string', 'description': 'Only include records updated on or after this date (YYYY-MM-DD).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['imo', 'vessel_name', 'vessel_type_code', 'propulsion_type_code', 'mco', 'mco_unit', 'mco_rpm', 'trading_category_code', 'built_year', 'gt', 'engine_designation', 'engine_builder', 'engine_designer', 'modified_at'], 'properties': {'gt': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'mco': {'type': ['null', 'number']}, 'mco_rpm': {'type': ['null', 'integer']}, 'mco_unit': {'type': ['null', 'string']}, 'built_year': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'engine_builder': {'type': ['null', 'string']}, 'engine_designer': {'type': ['null', 'string']}, 'vessel_type_code': {'type': ['null', 'string']}, 'engine_designation': {'type': ['null', 'string']}, 'propulsion_type_code': {'type': ['null', 'string']}, 'trading_category_code': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_info
Maritime Reports add-on status
Check whether the Maritime Reports add-on is active on the connected Datalastic account, and what it offers: vessel ownership/management, classification, engine specs, Port State Control inspections, casualties, drydock schedules, sale & purchase records, company profiles, sea routes, estimated out-of-AIS positions, and bulk dataset exports. Use this when the user asks whether they have (or what is included in) the add-on, when an intel_* tool reports the add-on is missing, or after the user says they have purchased or updated their subscription.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['addon_active', 'message', 'capabilities'], 'properties': {'message': {'type': 'string'}, 'addon_active': {'type': 'boolean'}, 'capabilities': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}
intel_inspections
Vessel Port State Control inspections
Retrieve a vessel's Port State Control (PSC) inspection record: the inspecting authority and port, the inspection type and date, whether the vessel was detained, and the number and description of any deficiencies found. Identify the vessel by imo or name, and optionally bound the period with from / to. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'Only include inspections on or before this date (YYYY-MM-DD).'}, 'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'from': {'type': 'string', 'description': 'Only include inspections on or after this date (YYYY-MM-DD).'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'imo', 'vessel_name', 'vessel_type_code', 'flag_code', 'inspection_date', 'inspection_authority', 'inspection_port', 'inspection_type', 'detention', 'ship_deficiencies', 'deficiency_description', 'technical_ism_manager', 'country_code', 'website', 'email', 'phone', 'address', 'company_imo', 'modified_at'], 'properties': {'id': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'email': {'type': ['null', 'string']}, 'phone': {'type': ['null', 'string']}, 'address': {'type': ['null', 'string']}, 'website': {'type': ['null', 'string']}, 'detention': {'type': ['null', 'string']}, 'flag_code': {'type': ['null', 'string']}, 'company_imo': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'country_code': {'type': ['null', 'string']}, 'inspection_date': {'type': ['null', 'string']}, 'inspection_port': {'type': ['null', 'string']}, 'inspection_type': {'type': ['null', 'string']}, 'vessel_type_code': {'type': ['null', 'string']}, 'ship_deficiencies': {'type': ['null', 'string']}, 'inspection_authority': {'type': ['null', 'string']}, 'technical_ism_manager': {'type': ['null', 'string']}, 'deficiency_description': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_ownership
Vessel ownership & management chain
Reveal the commercial control behind a vessel: beneficial owner, operator, technical manager and commercial manager â each with its company IMO and country â plus the P&I club and flag. Look up one vessel by imo or name, or turn the question around and pass a company name (beneficial_owner, operator, technical_manager or commercial_manager) to list every vessel that company controls. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}, 'operator': {'type': 'string', 'description': 'Company name of the operator; returns every vessel under that operator.'}, 'updated_from': {'type': 'string', 'description': 'Only include records updated on or after this date (YYYY-MM-DD).'}, 'beneficial_owner': {'type': 'string', 'description': 'Company name of the beneficial owner; returns every vessel under that owner.'}, 'technical_manager': {'type': 'string', 'description': 'Company name of the technical manager; returns every vessel under that manager.'}, 'commercial_manager': {'type': 'string', 'description': 'Company name of the commercial manager; returns every vessel under that manager.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'imo', 'vessel_name', 'beneficial_owner', 'beneficial_owner_imo', 'beneficial_owner_country', 'operator', 'operator_imo', 'operator_country', 'flag_name', 'vessel_type_code', 'built_year', 'buyer', 'dwt_design', 'class1_code', 'technical_manager', 'technical_manager_imo', 'technical_manager_country', 'commercial_manager', 'commercial_manager_imo', 'commercial_manager_country', 'pi_club', 'modified_at'], 'properties': {'id': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'buyer': {'type': ['null', 'string']}, 'pi_club': {'type': ['null', 'string']}, 'operator': {'type': ['null', 'string']}, 'flag_name': {'type': ['null', 'string']}, 'built_year': {'type': ['null', 'string']}, 'dwt_design': {'type': ['null', 'integer']}, 'class1_code': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'operator_imo': {'type': ['null', 'string']}, 'beneficial_owner': {'type': ['null', 'string']}, 'operator_country': {'type': ['null', 'string']}, 'vessel_type_code': {'type': ['null', 'string']}, 'technical_manager': {'type': ['null', 'string']}, 'commercial_manager': {'type': ['null', 'string']}, 'beneficial_owner_imo': {'type': ['null', 'string']}, 'technical_manager_imo': {'type': ['null', 'string']}, 'commercial_manager_imo': {'type': ['null', 'string']}, 'beneficial_owner_country': {'type': ['null', 'string']}, 'technical_manager_country': {'type': ['null', 'string']}, 'commercial_manager_country': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
intel_report_request
Request a bulk intelligence report (async)
Submit an async job to export a FULL bulk dataset for one of the Maritime Reports add-on datasets (dry_dock_dates, casualty, inspections, sales_purchase_demolitions, ownership, class_society, engine, companies). This returns the ENTIRE dataset (all records), not one vessel â for a single vessel use the matching lookup tool instead (e.g. intel_ownership, intel_inspections). Like all reports it is asynchronous: this returns a report_id and a _PENDING_ status without waiting; submit ONCE, then poll report_status with that report_id until _DONE_, which yields a result_url to hand to the user to download. Do not resubmit while a job is running, and if a report comes back _FAILED_, do not automatically submit a replacement â report the message to the user first. At most 10 reports may be pending per account at once (across every report type), so a retry loop can exhaust the queue. The server never downloads the file itself. Part of the Maritime Reports add-on.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['report_type'], 'properties': {'report_type': {'type': 'string', 'description': 'Which bulk dataset report to generate. One of: dry_dock_dates, casualty, inspections, sales_purchase_demolitions, ownership, class_society, engine, companies.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['report_id', 'report_type', 'status', 'message', 'result_url', 'created_at', 'updated_at'], 'properties': {'status': {'type': ['null', 'string']}, 'message': {'type': ['null', 'string']}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string']}, 'result_url': {'type': ['null', 'string']}, 'updated_at': {'type': ['null', 'string']}, 'report_type': {'type': ['null', 'string']}}, 'additionalProperties': False}
intel_spd
Ship sale & purchase / demolition records
Retrieve ship sale-and-purchase transactions for a vessel: second-hand sales, newbuilding deliveries and demolition (scrap) sales, including seller, buyer, reported price, price per lightweight ton, and demolition destination. Useful for asset valuation and market tracking. Identify the vessel by imo or name, and optionally bound the period with from / to. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'Only include transactions reported on or before this date (YYYY-MM-DD).'}, 'imo': {'type': 'string', 'description': 'Vessel IMO number (exactly 7 digits) to look up.'}, 'from': {'type': 'string', 'description': 'Only include transactions reported on or after this date (YYYY-MM-DD).'}, 'name': {'type': 'string', 'description': 'Vessel name to look up (use when the IMO is unknown).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['records'], 'properties': {'records': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'sales_report_date', 'imo', 'vessel_name', 'flag_name', 'vessel_type_code', 'built_year', 'dwt_design', 'gt', 'ldt', 'seller', 'buyer', 'sales_price_usd_mio', 'sales_price_usd/ldt', 'destination', 'sales_type', 'dry_dock_date', 'special_survey_date', 'sales_note', 'previous_sales_record', 'modified_at'], 'properties': {'gt': {'type': ['null', 'integer']}, 'id': {'type': ['null', 'integer']}, 'imo': {'type': ['null', 'string']}, 'ldt': {'type': ['null', 'integer']}, 'buyer': {'type': ['null', 'string']}, 'seller': {'type': ['null', 'string']}, 'flag_name': {'type': ['null', 'string']}, 'built_year': {'type': ['null', 'string']}, 'dwt_design': {'type': ['null', 'integer']}, 'sales_note': {'type': ['null', 'string']}, 'sales_type': {'type': ['null', 'string']}, 'destination': {'type': ['null', 'string']}, 'modified_at': {'type': ['null', 'string']}, 'vessel_name': {'type': ['null', 'string']}, 'dry_dock_date': {'type': ['null', 'string']}, 'vessel_type_code': {'type': ['null', 'string']}, 'sales_report_date': {'type': ['null', 'string']}, 'sales_price_usd/ldt': {'type': ['null', 'number']}, 'sales_price_usd_mio': {'type': ['null', 'number']}, 'special_survey_date': {'type': ['null', 'string']}, 'previous_sales_record': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
report_list
List async reports
List the caller's recent async report jobs with their statuses â result_url on the ones that are _DONE_, and message explaining the cause on any that are _FAILED_. Use this to recover a report_id, see which reports have finished, or find out why one failed â for example if a report was submitted earlier and its id was lost. Listing is free and never re-runs a report.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['reports'], 'properties': {'reports': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['report_id', 'report_type', 'status', 'message', 'result_url', 'created_at', 'updated_at'], 'properties': {'status': {'type': ['null', 'string']}, 'message': {'type': ['null', 'string']}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string']}, 'result_url': {'type': ['null', 'string']}, 'updated_at': {'type': ['null', 'string']}, 'report_type': {'type': ['null', 'string']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
report_request
Request an async report
Submit an async report job. Reports are generated in the background and can take a while (seconds to many minutes), so this returns a report_id and an initial status (_PENDING_) â it does NOT wait. Submit ONCE, then poll report_status with the returned report_id until _DONE_, which yields a result_url. Do not resubmit while a job is running. If a report comes back _FAILED_, do not automatically submit a replacement â report the message to the user first. At most 10 reports may be pending per account at once; further submissions are rejected until some finish. When done, give the user the result_url to download; the server never downloads report files itself.
Supported report_type values:
- request_usage: a FREE log of your account's API usage (endpoint, credits, timestamp); optional from/to (<=31 days), default last month.
- vessel_list: the full vessel database (no other parameters).
- port_list: the full ports database (no other parameters).
- inradius_history: all vessels that passed through an area in a time window; REQUIRES lat, lon, radius (<=50 NM), from and to (<=7 days apart).
Note: vessel_list, port_list and inradius_history consume API credits (vessel_list and inradius_history can be substantial) â it's good to tell the user before submitting. For the add-on bulk datasets (ownership, inspections, etc.) use intel_report_request instead.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['report_type'], 'properties': {'to': {'type': 'string', 'description': 'End date YYYY-MM-DD. Optional for request_usage (<=31 days after from); required for inradius_history (<=7 days after from).'}, 'lat': {'type': ['null', 'number'], 'description': 'Center latitude. Required for inradius_history.'}, 'lon': {'type': ['null', 'number'], 'description': 'Center longitude. Required for inradius_history.'}, 'from': {'type': 'string', 'description': 'Start date YYYY-MM-DD. Optional for request_usage; required for inradius_history.'}, 'radius': {'type': ['null', 'number'], 'description': 'Radius in nautical miles, max 50. Required for inradius_history.'}, 'report_type': {'type': 'string', 'description': 'Which report to generate: request_usage, vessel_list, port_list, or inradius_history.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['report_id', 'report_type', 'status', 'message', 'result_url', 'created_at', 'updated_at'], 'properties': {'status': {'type': ['null', 'string']}, 'message': {'type': ['null', 'string']}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string']}, 'result_url': {'type': ['null', 'string']}, 'updated_at': {'type': ['null', 'string']}, 'report_type': {'type': ['null', 'string']}}, 'additionalProperties': False}
report_status
Check an async report
Check an async report job by report_id (from report_request or report_list). Returns its status: _PENDING_ or _IN_PROGRESS_ (still generating â wait and check again), _DONE_, or _FAILED_.
When _DONE_, result_url is a download link for the result ZIP; hand it to the user. Links are time-limited â if one has expired, run report_status again for a fresh link. The server never downloads the file itself.
_FAILED_ is terminal. Stop polling: it will never become _DONE_ and there will be no result_url. Read the message field and relay it to the user â it is written for a person and explains the cause. Do not resubmit on your own: tell the user what failed and let them decide. If the message points at a parameter the user can correct, offer the corrected submission rather than making it silently.
A report going from _IN_PROGRESS_ back to _PENDING_ is an automatic retry, not a failure. Keep polling.
Failed reports are not charged, and polling is free â it never re-runs the report or deducts credits.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['report_id'], 'properties': {'report_id': {'type': 'string', 'description': 'The report_id returned by report_request (or seen in report_list).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['report_id', 'report_type', 'status', 'message', 'result_url', 'created_at', 'updated_at'], 'properties': {'status': {'type': ['null', 'string']}, 'message': {'type': ['null', 'string']}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string']}, 'result_url': {'type': ['null', 'string']}, 'updated_at': {'type': ['null', 'string']}, 'report_type': {'type': ['null', 'string']}}, 'additionalProperties': False}
sea_route
Schematic sea route between two points
Calculate a schematic sea route between two points and return it as GeoJSON (a LineString of waypoints) with the total distance in kilometres and nautical miles. Specify the origin and destination each as either coordinates (lat+lon), a port UUID, or a port UN/LOCODE. â ï¸ This is a SCHEMATIC sea route, not a navigable one. It does not account for actual navigation, hazards, traffic separation, drafts or local rules â do NOT use it for real-world sailing. Use it for estimating distance and travel time, visualizing the approximate path/shape, and similar analysis. Part of the Maritime Reports add-on.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'lat_to': {'type': ['null', 'number'], 'description': 'Destination latitude (use together with lon_to).'}, 'lon_to': {'type': ['null', 'number'], 'description': 'Destination longitude (use together with lat_to).'}, 'lat_from': {'type': ['null', 'number'], 'description': 'Origin latitude (use together with lon_from).'}, 'lon_from': {'type': ['null', 'number'], 'description': 'Origin longitude (use together with lat_from).'}, 'port_uuid_to': {'type': 'string', 'description': 'Destination port UUID.'}, 'port_uuid_from': {'type': 'string', 'description': 'Origin port UUID.'}, 'port_unlocode_to': {'type': 'string', 'description': 'Destination port UN/LOCODE (5 alphanumeric, case-insensitive).'}, 'port_unlocode_from': {'type': 'string', 'description': 'Origin port UN/LOCODE (5 alphanumeric, case-insensitive).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['from', 'route', 'to'], 'properties': {'to': {'type': ['null', 'object'], 'required': ['type', 'geometry', 'properties'], 'properties': {'type': {'type': 'string'}, 'geometry': {'type': 'object', 'required': ['type', 'coordinates'], 'properties': {'type': {'type': 'string'}, 'coordinates': {'type': ['null', 'array'], 'items': {'type': 'number'}}}, 'additionalProperties': False}, 'properties': {'type': 'object', 'required': ['type', 'port_name', 'port_uuid', 'port_unlocode'], 'properties': {'type': {'type': 'string'}, 'port_name': {'type': ['null', 'string']}, 'port_uuid': {'type': ['null', 'string']}, 'port_unlocode': {'type': ['null', 'string']}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'from': {'type': ['null', 'object'], 'required': ['type', 'geometry', 'properties'], 'properties': {'type': {'type': 'string'}, 'geometry': {'type': 'object', 'required': ['type', 'coordinates'], 'properties': {'type': {'type': 'string'}, 'coordinates': {'type': ['null', 'array'], 'items': {'type': 'number'}}}, 'additionalProperties': False}, 'properties': {'type': 'object', 'required': ['type', 'port_name', 'port_uuid', 'port_unlocode'], 'properties': {'type': {'type': 'string'}, 'port_name': {'type': ['null', 'string']}, 'port_uuid': {'type': ['null', 'string']}, 'port_unlocode': {'type': ['null', 'string']}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'route': {'type': ['null', 'object'], 'required': ['type', 'geometry', 'properties'], 'properties': {'type': {'type': 'string'}, 'geometry': {'type': 'object', 'required': ['type', 'coordinates'], 'properties': {'type': {'type': 'string'}, 'coordinates': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'number'}}}}, 'additionalProperties': False}, 'properties': {'type': 'object', 'required': ['total_dist', 'total_dist_nm'], 'properties': {'total_dist': {'type': ['null', 'number']}, 'total_dist_nm': {'type': ['null', 'number']}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}
Verlauf
Letzte Tool-Änderungen
Geändert
sea_route
25. September 2026 03:02
Geändert
report_status
25. September 2026 03:02
Geändert
report_request
25. September 2026 03:02
Geändert
report_list
25. September 2026 03:02
Geändert
intel_spd
25. September 2026 03:02
Geändert
intel_report_request
25. September 2026 03:02
Geändert
intel_ownership
25. September 2026 03:02
Geändert
intel_inspections
25. September 2026 03:02
Geändert
intel_info
25. September 2026 03:02
Geändert
intel_engine
25. September 2026 03:02
Geändert
intel_drydock
25. September 2026 03:02
Geändert
intel_companies
25. September 2026 03:02
Geändert
intel_class
25. September 2026 03:02
Geändert
intel_casualties
25. September 2026 03:02
Geändert
get_weather
25. September 2026 03:02
Geändert
get_vessels_in_radius
25. September 2026 03:02
Geändert
get_vessels_bulk
25. September 2026 03:02
Geändert
get_vessel_pro
25. September 2026 03:02
Geändert
get_vessel_info
25. September 2026 03:02
Geändert
get_vessel_history
25. September 2026 03:02
Geändert
get_vessel
25. September 2026 03:02
Geändert
get_port
25. September 2026 03:02
Geändert
find_vessels
25. September 2026 03:02
Geändert
find_ports
25. September 2026 03:02
Geändert
estimated_vessel_position
25. September 2026 03:02
Hinzugefügt
sea_route
17. September 2026 12:34
Hinzugefügt
report_status
17. September 2026 12:34
Hinzugefügt
report_request
17. September 2026 12:34
Hinzugefügt
report_list
17. September 2026 12:34
Hinzugefügt
intel_spd
17. September 2026 12:34
Entdecken
Ähnliche MCP-Server
SupplyGraph.AI Data
io.github.SupplyGraphAI/daasmart
Provides China-focused location, surrounding-area, company, industry-chain, property, population, retail, and regional business i…
EasyTerritory MCP
ai.easyterritory/ezt-mcp
Builds, balances, analyzes, and edits sales or service territories, with geocoding, routing, scheduling, map visualization, and G…
Ny Dmv
io.github.pipeworx-io/ny-dmv
Provides New York DMV data on vehicle registrations, electric-vehicle adoption, licensed facilities, DMV offices, road-test sites…
Predicthq
io.github.pipeworx-io/predicthq
Finds and retrieves PredictHQ events, including categories, impact rankings, dates, attendance estimates, and nearby locations.
Vessel Tracking
io.github.pipeworx-io/vessel-tracking
Provides live AIS-based ship positions, vessel details, and receiver coverage checks for geographic areas or specific vessels.
Or Dmv
io.github.pipeworx-io/or-dmv
Provides Oregon DMV office locations and live queue lengths, including wait times and customer counts.
Mo Dmv
io.github.pipeworx-io/mo-dmv
Finds Missouri license offices and provides addresses, hours, contact details, coordinates, managers, and closure dates.
Sonar Connections
com.sonarconnections/sonar-connections
Provides business details, appointment availability, menus and pickup times, event schedules, venue booths, city datasets, and GI…