Live AIS vessel positions by MMSI, name, area, or radius, plus coverage. No sign-in, no key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Vessels currently inside a latitude/longitude bounding box, newest report first, with optional kind and ship-type filters. Use for what is in a port, a strait, or a stretch of coast. Anonymous calls may cover 100 square degrees per call.
only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH
only this kind: vessel, aton (aid to navigation), base (base station), sar (search and rescue aircraft or distress beacon), or gear (fishing gear); vessel leaves out distress beacons and gear
rows to return: default 50, maximum 200
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
Vessels currently inside a latitude/longitude bounding box, newest report first, with optional kind and ship-type filters. Use for what is in a port, a strait, or a stretch of coast. Anonymous calls may cover 100 square degrees per call.
| Argument | Type | Description |
|---|---|---|
| bbox* | object | |
| flag | string | only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH |
| kind | string | only this kind: vessel, aton (aid to navigation), base (base station), sar (search and rescue aircraft or distress beacon), or gear (fishing gear); vessel leaves out distress beacons and gear |
| limit | integer | rows to return: default 50, maximum 200 |
| types | null | array | 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 |
{
"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), sar (search and rescue aircraft or distress beacon), or gear (fishing gear); vessel leaves out distress beacons and gear"
},
"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
}Vessels within a radius (default 10 NM, maximum 50) of a point or of another vessel's last known position, nearest first, each with distance and bearing from the centre. Use for what is near this position or what is around vessel X.
| Argument | Type | Description |
|---|---|---|
| lat | null | number | centre latitude, degrees; give lat and lon, or mmsi |
| lon | null | number | centre longitude, degrees |
| flag | string | only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH |
| kind | string | only this kind: vessel, aton, base, sar, or gear; vessel leaves out distress beacons and gear |
| mmsi | integer | centre on this vessel's last position instead of lat and lon; the vessel itself is left out of the results |
| limit | integer | rows to return: default 50, maximum 200 |
| types | null | array | only these ITU ship type codes; a code ending in 0 matches its decade |
| radius_nm | number | search radius in nautical miles: default 10, maximum 50 |
Where Open Waters AIS is hearing AIS right now: sources with their current delay, stations, freshness, and vessel counts. Pass a bounding box to learn which stations cover it and how many vessels are in it, or a station id for that station's numbers. Vessel counts cover the last 30 minutes; max_age widens them, to 7d for the last week or all for every vessel the network has heard. Call this before saying a region has no traffic.
| Argument | Type | Description |
|---|---|---|
| bbox | null | object | report the stations covering this box and the vessels currently in it |
| max_age | string | 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 | string | a station id from an earlier result, for that station's numbers |
{
"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
}The positions heard from one vessel over a time range, oldest first, with speed, course, and navigational status. Positions implying an impossible speed for the vessel are left out. Use for where a ship was yesterday, when it left port, or its route today. Give the vessel's mmsi, or its imo with a feeder or partner token. A call covers up to a year. By default the track is simplified by shape: the positions that hold its path, with breaks where the vessel went unheard; interval_minutes asks for even spacing instead.
| Argument | Type | Description |
|---|---|---|
| to | string | end, RFC 3339 UTC; default now |
| imo | integer | the vessel's IMO number, instead of mmsi; needs a feeder or partner token. Follows the one vessel the IMO names: its only MMSI, or the only one heard in the last 30 days |
| from | string | start, RFC 3339 UTC; default 24 hours before to. A call covers up to 366 days |
| mmsi | integer | the vessel's MMSI; give mmsi or imo. Use search_vessels_by_name first when you only have a name |
| limit | integer | positions to return: default 50, maximum 200; when more match, the newest are kept |
| interval_minutes | integer | at most one position per this many minutes, evenly spaced; by default the track is simplified by shape instead, keeping the positions that hold its path. Anonymous and personal calls reaching past 48 hours are rounded up to whole minutes |
Last known position and particulars of specific vessels by MMSI (Maritime Mobile Service Identity), or by IMO number with a feeder or partner token: the last report heard for each, however long ago, with destination, ETA, draught, and dimensions once its static data has been heard, and which identifiers match no vessel the network has heard. A vessel whose IMO number has a Wikidata item also carries its type, builder, year built, tonnage, registered dimensions, registry, home port, owner, operator, former names, and Wikipedia and Commons links from there, and a documented US vessel its service type, status, official number, registered dimensions, and tonnage from the US Coast Guard. Use search_vessels_by_name first when you only have a name.
| Argument | Type | Description |
|---|---|---|
| imo | null | array | IMO numbers to look up, counted with mmsi against the same cap; needs a feeder or partner token. Each returns up to 10 vessels that reported it, most recently heard first, and a vessel is found by IMO only once its static data has been heard |
| mmsi | null | array | MMSIs to look up; anonymous calls may pass 10 identifiers per call, a personal token 50 |
{
"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; needs a feeder or partner token. Each returns up to 10 vessels that reported it, most recently heard first, and 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
}Vessels whose name contains the text, case-insensitive, among every vessel the network has heard, each with its last known position. Use to turn a name into an MMSI, then get_vessels or find_vessels_near for detail. An optional bounding box narrows the search. With a feeder or partner token, text of the form IMO 9241061 finds the vessels reporting that IMO number, and a bare seven-digit number finds them ahead of the name matches.
| Argument | Type | Description |
|---|---|---|
| bbox | null | object | only vessels whose last position is inside this box |
| flag | string | only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH |
| name* | string | text to find in the vessel name, at least 2 characters, case-insensitive; with a feeder or partner token, IMO followed by an IMO number finds that IMO |
| limit | integer | rows to return: default 50, maximum 200 |
{
"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; with a feeder or partner token, IMO followed by an IMO number finds that IMO"
},
"limit": {
"type": "integer",
"description": "rows to return: default 50, maximum 200"
}
},
"additionalProperties": false
}{
"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, sar, or gear; vessel leaves out distress beacons and gear"
},
"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
}{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "end, RFC 3339 UTC; default now"
},
"imo": {
"type": "integer",
"maximum": 4294967295,
"minimum": 0,
"description": "the vessel's IMO number, instead of mmsi; needs a feeder or partner token. Follows the one vessel the IMO names: its only MMSI, or the only one heard in the last 30 days"
},
"from": {
"type": "string",
"description": "start, RFC 3339 UTC; default 24 hours before to. A call covers up to 366 days"
},
"mmsi": {
"type": "integer",
"maximum": 4294967295,
"minimum": 0,
"description": "the vessel's MMSI; give mmsi or imo. 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, evenly spaced; by default the track is simplified by shape instead, keeping the positions that hold its path. Anonymous and personal calls reaching past 48 hours are rounded up to whole minutes"
}
},
"additionalProperties": false
}