get_vessel_position
Retrieve a vessel's stored position (latitude, longitude, speed, heading, timestamp) to check its location and whether the fix may be outdated.
Instructions
Get the latest stored position of a vessel (latitude, longitude, speed, heading, timestamp). Check the timestamp: the fix may be hours or days old, especially for a vessel away from the coast. The response also carries the vessel's particulars, the destination and ETA it last reported, and a check against its previous position (minutes and distance between that report and this one, implied speed and course, whether the identifiers match). minutes_since_previous is not the age of this position; read vesselPosition.timestamp for that. A separate get_vessel_eta call is needed only when vesselEta is missing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vesselId": "<vesselId>"
},
"name": "get_vessel_position"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sat | No | Deprecated: the satellite fallback is withdrawn in its current form. From the cutoff date this option is accepted and ignored, and no credit is charged. Until then: fall back to a satellite position when no recent terrestrial one exists. Draws on a prepaid satellite credit balance: one credit when a satellite fix is returned, never twice for the same fix on this account, and nothing when a terrestrial position is returned. The result says whether a credit was charged. Use it only when a stored position is insufficient. | |
| idType | No | Identifier type: imo (default) or mmsi | |
| vesselId | Yes | Vessel identifier (IMO number by default) | |
| satMaxAgeMinutes | No | Only with sat: how old a stored position may be before a satellite lookup is made, 15 to 4800 minutes. Defaults to 60. Paid plans only. Deprecated: the satellite fallback is withdrawn in its current form. From the cutoff date this option is accepted and ignored, and no credit is charged. | |
| satLookbackMinutes | No | Only with sat: how old a satellite position may be and still be returned, 60 to 4800 minutes. Defaults to 180. Deprecated: the satellite fallback is withdrawn in its current form. From the cutoff date this option is accepted and ignored, and no credit is charged. |