Live Ship Position
live_ship_positionWhere is a specific ship right now, live AIS position for one or more vessels by MMSI number. Returns position, speed, course, navigational status and destination as currently broadcast. BEST EFFORT BY NATURE: this listens for a live broadcast rather than reading a stored position, and many vessels transmit less than once a minute, so a single call frequently hears nothing even for a ship that is definitely sailing. Measured behaviour, not a caveat for form. Improve the odds with a longer window_seconds, or use live_ships_in_area if you know roughly where the ship is. For a guaranteed last-known position rather than a live catch, use vesselfinder_vessel (paid key). COVERAGE IS PARTIAL AND TERRESTRIAL, there is no receiver coverage in the Persian Gulf, Strait of Hormuz, Gulf of Oman or Red Sea, so this tool cannot answer questions about those waters (use chokepoint_status for Hormuz/Suez/Bab el-Mandeb transit counts instead). Counts are vessels heard during a listening window of a few seconds, not a complete count of vessels present.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mmsi": [
"219034351"
]
},
"name": "live_ship_position"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mmsi | Yes | One or more 9-digit MMSI numbers, e.g. ["219034351"] | |
| _apiKey | No | aisstream.io API key (free at aisstream.io) | |
| window_seconds | No | How long to listen, 3-40 seconds (default 30). Hit rate scales almost linearly with this: many vessels transmit less than once a minute, so a 10-second window will usually miss and a 40-second one often succeeds. Prefer a long window here, the wait buys the answer. |