Open Waters AIS
Qué hace este MCP
Queries live AIS vessel positions by identifier, name, area, or radius and reports vessel details and coverage freshness.
Herramientas
Esquema de entrada
{'type': 'object', 'required': ['bbox'], 'properties': {'bbox': {'type': 'object', 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'additionalProperties': False}, 'flag': {'type': 'string', 'description': 'only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH'}, 'kind': {'type': 'string', 'description': 'only this kind: vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)'}, 'limit': {'type': 'integer', 'description': 'rows to return: default 50, maximum 200'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}, 'description': 'only these ITU ship type codes, e.g. 30 fishing, 36 sailing, 37 pleasure craft, 52 tug, 60 passenger, 70 cargo, 80 tanker; a code ending in 0 matches its decade, so 70 matches 70 to 79'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['vessels', 'total', 'truncated', 'attribution'], 'properties': {'total': {'type': 'integer', 'description': 'vessels matched before the limit was applied'}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['mmsi', 'kind', 'seen', 'age_s', 'source', 'station'], 'properties': {'cog': {'type': ['null', 'number'], 'description': 'course over ground, degrees true'}, 'eta': {'type': 'string', 'description': 'estimated arrival as sent, MM-DD HH:MM UTC or MM-DD; AIS carries no year, so read it as the next occurrence'}, 'imo': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "IMO number, once the vessel's static data has been heard"}, 'lat': {'type': ['null', 'number'], 'description': 'latitude of the last position, degrees; absent when no position has been heard'}, 'lon': {'type': ['null', 'number'], 'description': 'longitude of the last position, degrees'}, 'sog': {'type': ['null', 'number'], 'description': 'speed over ground, knots'}, 'beam': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'beam, metres'}, 'flag': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits"}, 'kind': {'type': 'string', 'description': 'vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'name': {'type': 'string', 'description': "name from the vessel's static data, when heard"}, 'seen': {'type': 'string', 'description': 'time of the last message heard, RFC 3339 UTC'}, 'type': {'type': 'integer', 'maximum': 255, 'minimum': 0, 'description': 'ITU ship and cargo type code, or the aid type for an aton'}, 'age_s': {'type': 'integer', 'description': 'seconds since seen'}, 'length': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'overall length, metres'}, 'source': {'type': 'string', 'description': 'feed or station kind the last message came from'}, 'bearing': {'type': ['null', 'number'], 'description': 'degrees true from the search centre to the vessel (find_vessels_near)'}, 'draught': {'type': ['null', 'number'], 'description': 'maximum static draught, metres'}, 'heading': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'true heading, degrees'}, 'sources': {'type': 'object', 'description': "each contributing source's credit, license, and its own page for this vessel (get_vessels)", 'additionalProperties': {'type': 'object', 'required': ['credit', 'license'], 'properties': {'url': {'type': 'string', 'description': "the source's page for this vessel, or its public search when the source keeps no per-vessel pages"}, 'credit': {'type': 'string', 'description': 'display credit for the source'}, 'license': {'type': 'string'}}, 'additionalProperties': False}}, 'station': {'type': 'string'}, 'callsign': {'type': 'string'}, 'type_name': {'type': 'string'}, 'nav_status': {'type': ['null', 'integer'], 'maximum': 255, 'minimum': 0, 'description': 'AIS navigational status code'}, 'provenance': {'type': 'object', 'description': "the source of each particulars field, by the field's name; values are keys of sources (get_vessels)", 'additionalProperties': {'type': 'string'}}, 'destination': {'type': 'string', 'description': 'destination as typed by the crew: a port name, a UN/LOCODE, or nothing useful'}, 'distance_nm': {'type': ['null', 'number'], 'description': 'nautical miles from the search centre (find_vessels_near)'}, 'particulars': {'type': ['null', 'object'], 'properties': {'beam': {'type': 'number', 'description': 'beam as registered, metres'}, 'depth': {'type': 'number', 'description': 'registered depth, metres'}, 'image': {'type': 'string', 'description': 'the Commons page of a photo of the ship, which shows its license and credit'}, 'owner': {'type': 'string'}, 'length': {'type': 'number', 'description': 'length as registered, metres; may differ from the AIS length'}, 'status': {'type': 'string', 'description': 'flag-state status, e.g. Active, Laid Up'}, 'builder': {'type': 'string', 'description': 'shipyard or builder'}, 'draught': {'type': 'number', 'description': 'design draught, metres; AIS reports the draught on the current voyage'}, 'service': {'type': 'string', 'description': 'flag-state service type, e.g. Towing Vessel, Passenger (Inspected), Recreational'}, 'callsign': {'type': 'string', 'description': "call sign as registered; the callsign in the vessel's own properties is the one AIS reports"}, 'operator': {'type': 'string'}, 'registry': {'type': 'string', 'description': 'country of registry, in English'}, 'home_port': {'type': 'string', 'description': 'port of registry'}, 'ship_type': {'type': 'string', 'description': 'kind of ship, e.g. bulk carrier, container ship, ferry'}, 'wikipedia': {'type': 'string', 'description': "the ship's English Wikipedia article"}, 'deadweight': {'type': 'integer', 'description': 'deadweight, tonnes'}, 'year_built': {'type': 'integer'}, 'net_tonnage': {'type': 'integer'}, 'yard_number': {'type': 'string', 'description': "the builder's hull number"}, 'former_names': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'names the vessel has carried before, oldest first'}, 'gross_tonnage': {'type': 'integer'}, 'identification': {'type': 'string', 'description': "the flag state's number for the vessel: a documented vessel's official number, else its state registration"}, 'registered_name': {'type': 'string', 'description': 'name as documented with the flag state, when it differs from what AIS reports'}, 'tonnage_measure': {'type': 'string', 'description': 'how a tonnage from the flag state was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)'}, 'commons_category': {'type': 'string', 'description': "the category of the ship's photos on Wikimedia Commons"}}, 'description': 'particulars as registered, merged from the enrichment sources into one vocabulary (get_vessels)', 'additionalProperties': False}, 'nav_status_name': {'type': 'string'}}, 'additionalProperties': False}}, 'truncated': {'type': 'boolean', 'description': 'true when total exceeds the rows returned; narrow the query or raise limit'}, 'attribution': {'type': 'object', 'description': 'credit line per source kind in the rows, to show with the data', 'additionalProperties': {'type': 'string'}}, 'unknown_imo': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested IMO numbers matching no vessel the network has heard'}, 'unknown_mmsi': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested MMSIs matching no vessel the network has heard'}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', 'properties': {'lat': {'type': ['null', 'number'], 'description': 'centre latitude, degrees; give lat and lon, or mmsi'}, 'lon': {'type': ['null', 'number'], 'description': 'centre longitude, degrees'}, 'flag': {'type': 'string', 'description': 'only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH'}, 'kind': {'type': 'string', 'description': 'only this kind: vessel, aton, base, or sar'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "centre on this vessel's last position instead of lat and lon; the vessel itself is left out of the results"}, 'limit': {'type': 'integer', 'description': 'rows to return: default 50, maximum 200'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}, 'description': 'only these ITU ship type codes; a code ending in 0 matches its decade'}, 'radius_nm': {'type': 'number', 'description': 'search radius in nautical miles: default 10, maximum 50'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['vessels', 'total', 'truncated', 'attribution'], 'properties': {'total': {'type': 'integer', 'description': 'vessels matched before the limit was applied'}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['mmsi', 'kind', 'seen', 'age_s', 'source', 'station'], 'properties': {'cog': {'type': ['null', 'number'], 'description': 'course over ground, degrees true'}, 'eta': {'type': 'string', 'description': 'estimated arrival as sent, MM-DD HH:MM UTC or MM-DD; AIS carries no year, so read it as the next occurrence'}, 'imo': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "IMO number, once the vessel's static data has been heard"}, 'lat': {'type': ['null', 'number'], 'description': 'latitude of the last position, degrees; absent when no position has been heard'}, 'lon': {'type': ['null', 'number'], 'description': 'longitude of the last position, degrees'}, 'sog': {'type': ['null', 'number'], 'description': 'speed over ground, knots'}, 'beam': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'beam, metres'}, 'flag': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits"}, 'kind': {'type': 'string', 'description': 'vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'name': {'type': 'string', 'description': "name from the vessel's static data, when heard"}, 'seen': {'type': 'string', 'description': 'time of the last message heard, RFC 3339 UTC'}, 'type': {'type': 'integer', 'maximum': 255, 'minimum': 0, 'description': 'ITU ship and cargo type code, or the aid type for an aton'}, 'age_s': {'type': 'integer', 'description': 'seconds since seen'}, 'length': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'overall length, metres'}, 'source': {'type': 'string', 'description': 'feed or station kind the last message came from'}, 'bearing': {'type': ['null', 'number'], 'description': 'degrees true from the search centre to the vessel (find_vessels_near)'}, 'draught': {'type': ['null', 'number'], 'description': 'maximum static draught, metres'}, 'heading': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'true heading, degrees'}, 'sources': {'type': 'object', 'description': "each contributing source's credit, license, and its own page for this vessel (get_vessels)", 'additionalProperties': {'type': 'object', 'required': ['credit', 'license'], 'properties': {'url': {'type': 'string', 'description': "the source's page for this vessel, or its public search when the source keeps no per-vessel pages"}, 'credit': {'type': 'string', 'description': 'display credit for the source'}, 'license': {'type': 'string'}}, 'additionalProperties': False}}, 'station': {'type': 'string'}, 'callsign': {'type': 'string'}, 'type_name': {'type': 'string'}, 'nav_status': {'type': ['null', 'integer'], 'maximum': 255, 'minimum': 0, 'description': 'AIS navigational status code'}, 'provenance': {'type': 'object', 'description': "the source of each particulars field, by the field's name; values are keys of sources (get_vessels)", 'additionalProperties': {'type': 'string'}}, 'destination': {'type': 'string', 'description': 'destination as typed by the crew: a port name, a UN/LOCODE, or nothing useful'}, 'distance_nm': {'type': ['null', 'number'], 'description': 'nautical miles from the search centre (find_vessels_near)'}, 'particulars': {'type': ['null', 'object'], 'properties': {'beam': {'type': 'number', 'description': 'beam as registered, metres'}, 'depth': {'type': 'number', 'description': 'registered depth, metres'}, 'image': {'type': 'string', 'description': 'the Commons page of a photo of the ship, which shows its license and credit'}, 'owner': {'type': 'string'}, 'length': {'type': 'number', 'description': 'length as registered, metres; may differ from the AIS length'}, 'status': {'type': 'string', 'description': 'flag-state status, e.g. Active, Laid Up'}, 'builder': {'type': 'string', 'description': 'shipyard or builder'}, 'draught': {'type': 'number', 'description': 'design draught, metres; AIS reports the draught on the current voyage'}, 'service': {'type': 'string', 'description': 'flag-state service type, e.g. Towing Vessel, Passenger (Inspected), Recreational'}, 'callsign': {'type': 'string', 'description': "call sign as registered; the callsign in the vessel's own properties is the one AIS reports"}, 'operator': {'type': 'string'}, 'registry': {'type': 'string', 'description': 'country of registry, in English'}, 'home_port': {'type': 'string', 'description': 'port of registry'}, 'ship_type': {'type': 'string', 'description': 'kind of ship, e.g. bulk carrier, container ship, ferry'}, 'wikipedia': {'type': 'string', 'description': "the ship's English Wikipedia article"}, 'deadweight': {'type': 'integer', 'description': 'deadweight, tonnes'}, 'year_built': {'type': 'integer'}, 'net_tonnage': {'type': 'integer'}, 'yard_number': {'type': 'string', 'description': "the builder's hull number"}, 'former_names': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'names the vessel has carried before, oldest first'}, 'gross_tonnage': {'type': 'integer'}, 'identification': {'type': 'string', 'description': "the flag state's number for the vessel: a documented vessel's official number, else its state registration"}, 'registered_name': {'type': 'string', 'description': 'name as documented with the flag state, when it differs from what AIS reports'}, 'tonnage_measure': {'type': 'string', 'description': 'how a tonnage from the flag state was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)'}, 'commons_category': {'type': 'string', 'description': "the category of the ship's photos on Wikimedia Commons"}}, 'description': 'particulars as registered, merged from the enrichment sources into one vocabulary (get_vessels)', 'additionalProperties': False}, 'nav_status_name': {'type': 'string'}}, 'additionalProperties': False}}, 'truncated': {'type': 'boolean', 'description': 'true when total exceeds the rows returned; narrow the query or raise limit'}, 'attribution': {'type': 'object', 'description': 'credit line per source kind in the rows, to show with the data', 'additionalProperties': {'type': 'string'}}, 'unknown_imo': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested IMO numbers matching no vessel the network has heard'}, 'unknown_mmsi': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested MMSIs matching no vessel the network has heard'}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', 'properties': {'bbox': {'type': ['null', 'object'], 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'description': 'report the stations covering this box and the vessels currently in it', 'additionalProperties': False}, 'max_age': {'type': 'string', 'description': 'count vessels heard within this long, network-wide and in bbox, instead of the last 30 minutes: a duration such as 6h, 24h, or 7d, or all for every vessel the network has heard'}, 'station': {'type': 'string', 'description': "a station id from an earlier result, for that station's numbers"}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['time', 'summary', 'sources', 'stations', 'vessels', 'events_per_second'], 'properties': {'area': {'type': ['null', 'object'], 'required': ['bbox', 'vessels', 'stations'], 'properties': {'bbox': {'type': 'object', 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'additionalProperties': False}, 'vessels': {'type': 'integer', 'description': 'vessels whose last known position is inside the box, heard in the last 30 minutes or within max_age'}, 'stations': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['station', 'source', 'vessels', 'events_24h', 'last_age_s'], 'properties': {'bbox': {'type': ['null', 'object'], 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'description': 'extent of the positions this station has heard', 'additionalProperties': False}, 'source': {'type': 'string'}, 'station': {'type': 'string'}, 'vessels': {'type': 'integer', 'description': 'distinct vessels heard in the last 30 minutes'}, 'events_24h': {'type': 'integer'}, 'last_age_s': {'type': 'integer'}}, 'additionalProperties': False}, 'description': 'stations whose heard extent overlaps the box'}}, 'additionalProperties': False}, 'note': {'type': 'string'}, 'time': {'type': 'string'}, 'sources': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'vessels', 'vessels_exclusive', 'events_24h', 'last_age_s', 'license', 'attribution'], 'properties': {'kind': {'type': 'string'}, 'delay': {'type': ['null', 'object'], 'required': ['p50', 'p99'], 'properties': {'p50': {'type': 'number', 'description': 'median delay in seconds'}, 'p99': {'type': 'number', 'description': '99th percentile delay in seconds'}}, 'description': 'seconds from broadcast to arrival over the last position reports from this source', 'additionalProperties': False}, 'license': {'type': 'string'}, 'vessels': {'type': 'integer', 'description': 'distinct vessels heard from this source in the last 30 minutes'}, 'events_24h': {'type': 'integer'}, 'last_age_s': {'type': 'integer', 'description': 'seconds since the source last delivered a message'}, 'attribution': {'type': 'string'}, 'description': {'type': 'string'}, 'vessels_exclusive': {'type': 'integer', 'description': 'of those, heard by no other source'}}, 'additionalProperties': False}}, 'station': {'type': ['null', 'object'], 'required': ['station', 'source', 'vessels', 'events_24h', 'last_age_s'], 'properties': {'bbox': {'type': ['null', 'object'], 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'description': 'extent of the positions this station has heard', 'additionalProperties': False}, 'source': {'type': 'string'}, 'station': {'type': 'string'}, 'vessels': {'type': 'integer', 'description': 'distinct vessels heard in the last 30 minutes'}, 'events_24h': {'type': 'integer'}, 'last_age_s': {'type': 'integer'}}, 'additionalProperties': False}, 'summary': {'type': 'string'}, 'vessels': {'type': 'object', 'required': ['total', 'active', 'with_position'], 'properties': {'new': {'type': ['null', 'integer'], 'description': 'vessels first heard within max_age; present when max_age is a duration'}, 'heard': {'type': ['null', 'integer'], 'description': 'vessels heard within max_age; present when max_age is given'}, 'total': {'type': 'integer', 'description': 'every vessel the network has heard'}, 'active': {'type': 'integer', 'description': 'vessels heard in the last 30 minutes'}, 'with_position': {'type': 'integer', 'description': 'of the active vessels, those with a position'}}, 'additionalProperties': False}, 'stations': {'type': 'object', 'required': ['total', 'active'], 'properties': {'total': {'type': 'integer'}, 'active': {'type': 'integer', 'description': 'heard within the last 5 minutes'}}, 'additionalProperties': False}, 'events_per_second': {'type': 'number'}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', 'properties': {'imo': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'IMO numbers to look up, counted with mmsi against the same cap; a vessel is found by IMO only once its static data has been heard'}, 'mmsi': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'MMSIs to look up; anonymous calls may pass 10 identifiers per call, a personal token 50'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['vessels', 'total', 'truncated', 'attribution'], 'properties': {'total': {'type': 'integer', 'description': 'vessels matched before the limit was applied'}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['mmsi', 'kind', 'seen', 'age_s', 'source', 'station'], 'properties': {'cog': {'type': ['null', 'number'], 'description': 'course over ground, degrees true'}, 'eta': {'type': 'string', 'description': 'estimated arrival as sent, MM-DD HH:MM UTC or MM-DD; AIS carries no year, so read it as the next occurrence'}, 'imo': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "IMO number, once the vessel's static data has been heard"}, 'lat': {'type': ['null', 'number'], 'description': 'latitude of the last position, degrees; absent when no position has been heard'}, 'lon': {'type': ['null', 'number'], 'description': 'longitude of the last position, degrees'}, 'sog': {'type': ['null', 'number'], 'description': 'speed over ground, knots'}, 'beam': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'beam, metres'}, 'flag': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits"}, 'kind': {'type': 'string', 'description': 'vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'name': {'type': 'string', 'description': "name from the vessel's static data, when heard"}, 'seen': {'type': 'string', 'description': 'time of the last message heard, RFC 3339 UTC'}, 'type': {'type': 'integer', 'maximum': 255, 'minimum': 0, 'description': 'ITU ship and cargo type code, or the aid type for an aton'}, 'age_s': {'type': 'integer', 'description': 'seconds since seen'}, 'length': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'overall length, metres'}, 'source': {'type': 'string', 'description': 'feed or station kind the last message came from'}, 'bearing': {'type': ['null', 'number'], 'description': 'degrees true from the search centre to the vessel (find_vessels_near)'}, 'draught': {'type': ['null', 'number'], 'description': 'maximum static draught, metres'}, 'heading': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'true heading, degrees'}, 'sources': {'type': 'object', 'description': "each contributing source's credit, license, and its own page for this vessel (get_vessels)", 'additionalProperties': {'type': 'object', 'required': ['credit', 'license'], 'properties': {'url': {'type': 'string', 'description': "the source's page for this vessel, or its public search when the source keeps no per-vessel pages"}, 'credit': {'type': 'string', 'description': 'display credit for the source'}, 'license': {'type': 'string'}}, 'additionalProperties': False}}, 'station': {'type': 'string'}, 'callsign': {'type': 'string'}, 'type_name': {'type': 'string'}, 'nav_status': {'type': ['null', 'integer'], 'maximum': 255, 'minimum': 0, 'description': 'AIS navigational status code'}, 'provenance': {'type': 'object', 'description': "the source of each particulars field, by the field's name; values are keys of sources (get_vessels)", 'additionalProperties': {'type': 'string'}}, 'destination': {'type': 'string', 'description': 'destination as typed by the crew: a port name, a UN/LOCODE, or nothing useful'}, 'distance_nm': {'type': ['null', 'number'], 'description': 'nautical miles from the search centre (find_vessels_near)'}, 'particulars': {'type': ['null', 'object'], 'properties': {'beam': {'type': 'number', 'description': 'beam as registered, metres'}, 'depth': {'type': 'number', 'description': 'registered depth, metres'}, 'image': {'type': 'string', 'description': 'the Commons page of a photo of the ship, which shows its license and credit'}, 'owner': {'type': 'string'}, 'length': {'type': 'number', 'description': 'length as registered, metres; may differ from the AIS length'}, 'status': {'type': 'string', 'description': 'flag-state status, e.g. Active, Laid Up'}, 'builder': {'type': 'string', 'description': 'shipyard or builder'}, 'draught': {'type': 'number', 'description': 'design draught, metres; AIS reports the draught on the current voyage'}, 'service': {'type': 'string', 'description': 'flag-state service type, e.g. Towing Vessel, Passenger (Inspected), Recreational'}, 'callsign': {'type': 'string', 'description': "call sign as registered; the callsign in the vessel's own properties is the one AIS reports"}, 'operator': {'type': 'string'}, 'registry': {'type': 'string', 'description': 'country of registry, in English'}, 'home_port': {'type': 'string', 'description': 'port of registry'}, 'ship_type': {'type': 'string', 'description': 'kind of ship, e.g. bulk carrier, container ship, ferry'}, 'wikipedia': {'type': 'string', 'description': "the ship's English Wikipedia article"}, 'deadweight': {'type': 'integer', 'description': 'deadweight, tonnes'}, 'year_built': {'type': 'integer'}, 'net_tonnage': {'type': 'integer'}, 'yard_number': {'type': 'string', 'description': "the builder's hull number"}, 'former_names': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'names the vessel has carried before, oldest first'}, 'gross_tonnage': {'type': 'integer'}, 'identification': {'type': 'string', 'description': "the flag state's number for the vessel: a documented vessel's official number, else its state registration"}, 'registered_name': {'type': 'string', 'description': 'name as documented with the flag state, when it differs from what AIS reports'}, 'tonnage_measure': {'type': 'string', 'description': 'how a tonnage from the flag state was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)'}, 'commons_category': {'type': 'string', 'description': "the category of the ship's photos on Wikimedia Commons"}}, 'description': 'particulars as registered, merged from the enrichment sources into one vocabulary (get_vessels)', 'additionalProperties': False}, 'nav_status_name': {'type': 'string'}}, 'additionalProperties': False}}, 'truncated': {'type': 'boolean', 'description': 'true when total exceeds the rows returned; narrow the query or raise limit'}, 'attribution': {'type': 'object', 'description': 'credit line per source kind in the rows, to show with the data', 'additionalProperties': {'type': 'string'}}, 'unknown_imo': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested IMO numbers matching no vessel the network has heard'}, 'unknown_mmsi': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested MMSIs matching no vessel the network has heard'}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', 'required': ['mmsi'], 'properties': {'to': {'type': 'string', 'description': 'end, RFC 3339 UTC; default now'}, 'from': {'type': 'string', 'description': 'start, RFC 3339 UTC; default 24 hours before to. Anonymous and personal calls reach back 48 hours; feeder and commercial tokens reach the archive, up to 366 days per call'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "the vessel's MMSI; use search_vessels_by_name first when you only have a name"}, 'limit': {'type': 'integer', 'description': 'positions to return: default 50, maximum 200; when more match, the newest are kept'}, 'interval_minutes': {'type': 'integer', 'description': 'at most one position per this many minutes; by default the limit is spread over the range at a round spacing, reported as interval_s'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['mmsi', 'from', 'to', 'interval_s', 'positions', 'truncated', 'attribution'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string', 'description': 'start of the range covered, after clamping to what the caller can reach: the last 48 hours, or the archive for feeder and commercial tokens'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'name': {'type': 'string'}, 'positions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['seen', 'lat', 'lon'], 'properties': {'cog': {'type': ['null', 'number'], 'description': 'course over ground, degrees true'}, 'lat': {'type': 'number'}, 'lon': {'type': 'number'}, 'sog': {'type': ['null', 'number'], 'description': 'speed over ground, knots'}, 'seen': {'type': 'string', 'description': 'time of the report, RFC 3339 UTC'}, 'heading': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'true heading, degrees'}, 'nav_status': {'type': ['null', 'integer'], 'maximum': 255, 'minimum': 0, 'description': 'AIS navigational status code'}, 'nav_status_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'oldest first'}, 'truncated': {'type': 'boolean', 'description': 'true when more positions matched than were returned; the newest were kept, so set from later or raise interval_minutes'}, 'interval_s': {'type': 'integer', 'description': 'at most one position per this many seconds; 0 is every position heard'}, 'attribution': {'type': 'object', 'description': 'credit line per source kind in the positions, to show with the data', 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', 'required': ['name'], 'properties': {'bbox': {'type': ['null', 'object'], 'required': ['min_lat', 'min_lon', 'max_lat', 'max_lon'], 'properties': {'max_lat': {'type': 'number', 'description': 'north edge, degrees, -90 to 90'}, 'max_lon': {'type': 'number', 'description': 'east edge, degrees, -180 to 180'}, 'min_lat': {'type': 'number', 'description': 'south edge, degrees, -90 to 90'}, 'min_lon': {'type': 'number', 'description': 'west edge, degrees, -180 to 180'}}, 'description': 'only vessels whose last position is inside this box', 'additionalProperties': False}, 'flag': {'type': 'string', 'description': 'only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH'}, 'name': {'type': 'string', 'description': 'text to find in the vessel name, at least 2 characters, case-insensitive'}, 'limit': {'type': 'integer', 'description': 'rows to return: default 50, maximum 200'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['vessels', 'total', 'truncated', 'attribution'], 'properties': {'total': {'type': 'integer', 'description': 'vessels matched before the limit was applied'}, 'vessels': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['mmsi', 'kind', 'seen', 'age_s', 'source', 'station'], 'properties': {'cog': {'type': ['null', 'number'], 'description': 'course over ground, degrees true'}, 'eta': {'type': 'string', 'description': 'estimated arrival as sent, MM-DD HH:MM UTC or MM-DD; AIS carries no year, so read it as the next occurrence'}, 'imo': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0, 'description': "IMO number, once the vessel's static data has been heard"}, 'lat': {'type': ['null', 'number'], 'description': 'latitude of the last position, degrees; absent when no position has been heard'}, 'lon': {'type': ['null', 'number'], 'description': 'longitude of the last position, degrees'}, 'sog': {'type': ['null', 'number'], 'description': 'speed over ground, knots'}, 'beam': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'beam, metres'}, 'flag': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits"}, 'kind': {'type': 'string', 'description': 'vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)'}, 'mmsi': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'name': {'type': 'string', 'description': "name from the vessel's static data, when heard"}, 'seen': {'type': 'string', 'description': 'time of the last message heard, RFC 3339 UTC'}, 'type': {'type': 'integer', 'maximum': 255, 'minimum': 0, 'description': 'ITU ship and cargo type code, or the aid type for an aton'}, 'age_s': {'type': 'integer', 'description': 'seconds since seen'}, 'length': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'overall length, metres'}, 'source': {'type': 'string', 'description': 'feed or station kind the last message came from'}, 'bearing': {'type': ['null', 'number'], 'description': 'degrees true from the search centre to the vessel (find_vessels_near)'}, 'draught': {'type': ['null', 'number'], 'description': 'maximum static draught, metres'}, 'heading': {'type': ['null', 'integer'], 'maximum': 65535, 'minimum': 0, 'description': 'true heading, degrees'}, 'sources': {'type': 'object', 'description': "each contributing source's credit, license, and its own page for this vessel (get_vessels)", 'additionalProperties': {'type': 'object', 'required': ['credit', 'license'], 'properties': {'url': {'type': 'string', 'description': "the source's page for this vessel, or its public search when the source keeps no per-vessel pages"}, 'credit': {'type': 'string', 'description': 'display credit for the source'}, 'license': {'type': 'string'}}, 'additionalProperties': False}}, 'station': {'type': 'string'}, 'callsign': {'type': 'string'}, 'type_name': {'type': 'string'}, 'nav_status': {'type': ['null', 'integer'], 'maximum': 255, 'minimum': 0, 'description': 'AIS navigational status code'}, 'provenance': {'type': 'object', 'description': "the source of each particulars field, by the field's name; values are keys of sources (get_vessels)", 'additionalProperties': {'type': 'string'}}, 'destination': {'type': 'string', 'description': 'destination as typed by the crew: a port name, a UN/LOCODE, or nothing useful'}, 'distance_nm': {'type': ['null', 'number'], 'description': 'nautical miles from the search centre (find_vessels_near)'}, 'particulars': {'type': ['null', 'object'], 'properties': {'beam': {'type': 'number', 'description': 'beam as registered, metres'}, 'depth': {'type': 'number', 'description': 'registered depth, metres'}, 'image': {'type': 'string', 'description': 'the Commons page of a photo of the ship, which shows its license and credit'}, 'owner': {'type': 'string'}, 'length': {'type': 'number', 'description': 'length as registered, metres; may differ from the AIS length'}, 'status': {'type': 'string', 'description': 'flag-state status, e.g. Active, Laid Up'}, 'builder': {'type': 'string', 'description': 'shipyard or builder'}, 'draught': {'type': 'number', 'description': 'design draught, metres; AIS reports the draught on the current voyage'}, 'service': {'type': 'string', 'description': 'flag-state service type, e.g. Towing Vessel, Passenger (Inspected), Recreational'}, 'callsign': {'type': 'string', 'description': "call sign as registered; the callsign in the vessel's own properties is the one AIS reports"}, 'operator': {'type': 'string'}, 'registry': {'type': 'string', 'description': 'country of registry, in English'}, 'home_port': {'type': 'string', 'description': 'port of registry'}, 'ship_type': {'type': 'string', 'description': 'kind of ship, e.g. bulk carrier, container ship, ferry'}, 'wikipedia': {'type': 'string', 'description': "the ship's English Wikipedia article"}, 'deadweight': {'type': 'integer', 'description': 'deadweight, tonnes'}, 'year_built': {'type': 'integer'}, 'net_tonnage': {'type': 'integer'}, 'yard_number': {'type': 'string', 'description': "the builder's hull number"}, 'former_names': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'names the vessel has carried before, oldest first'}, 'gross_tonnage': {'type': 'integer'}, 'identification': {'type': 'string', 'description': "the flag state's number for the vessel: a documented vessel's official number, else its state registration"}, 'registered_name': {'type': 'string', 'description': 'name as documented with the flag state, when it differs from what AIS reports'}, 'tonnage_measure': {'type': 'string', 'description': 'how a tonnage from the flag state was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)'}, 'commons_category': {'type': 'string', 'description': "the category of the ship's photos on Wikimedia Commons"}}, 'description': 'particulars as registered, merged from the enrichment sources into one vocabulary (get_vessels)', 'additionalProperties': False}, 'nav_status_name': {'type': 'string'}}, 'additionalProperties': False}}, 'truncated': {'type': 'boolean', 'description': 'true when total exceeds the rows returned; narrow the query or raise limit'}, 'attribution': {'type': 'object', 'description': 'credit line per source kind in the rows, to show with the data', 'additionalProperties': {'type': 'string'}}, 'unknown_imo': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested IMO numbers matching no vessel the network has heard'}, 'unknown_mmsi': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 4294967295, 'minimum': 0}, 'description': 'requested MMSIs matching no vessel the network has heard'}}, 'additionalProperties': False}
Cambios recientes en herramientas
Servidores MCP similares
gisgp
Provides GIS geocoding, routing, spatial transformations, ArcGIS layer inspection and export, and location due diligence for haza…
UK Environmental Intelligence MCP Server from MCPBundles
Provides UK environmental intelligence covering flood warnings, river and groundwater readings, bathing water quality, ecology ob…
Maptiler
Provides MapTiler geocoding, coordinate conversion, and point or route elevation data using map and terrain datasets.
Open Meteo
Provides global weather forecasts, historical reanalysis, geocoding, air-quality, marine, and flood data for specified locations.
Nasa Eonet
Retrieves NASA EONET natural hazard events such as wildfires, storms, volcanoes, floods, and landslides, including geographic and…
Coordinates
Performs geographic coordinate calculations including bounding boxes, centroids, midpoints, and point-in-box tests.
Openweather
Provides geocoding, current weather, forecasts, and air-quality data for cities and geographic coordinates.
Usgs National Map
Accesses USGS National Map data and services for geographic and geospatial information.