Tools / Vessel Tracker
Vessel Tracker icon

Vessel Tracker

Live ship positions and AIS data

Track ships and monitor maritime traffic worldwide using live AIS data. Look up vessel positions, speeds, headings, ship specs, navigation aids, and safety broadcasts for any area or vessel.

6 skillsv0.03
Search Vessels

Find vessels by MMSI or bounding box. Returns latest position, speed, course, heading, and navigation status. Collects live AIS position reports for ~15 seconds, deduplicated by vessel.

Returns: Real-time vessel positions with speed, course, heading, and navigation status
Parameters
mmsiarrayMMSI numbers to track (9-digit Maritime Mobile Service Identity). Maximum 50 vessels.
lat_minnumberSouthern boundary latitude (-90 to 90). Required if no MMSI provided.
lon_minnumberWestern boundary longitude (-180 to 180). Required if no MMSI provided.
lat_maxnumberNorthern boundary latitude (-90 to 90). Required if no MMSI provided.
lon_maxnumberEastern boundary longitude (-180 to 180). Required if no MMSI provided.
durationnumberCollection duration in seconds (1-30, default 15). Longer durations find more vessels in busy areas.
Example
Track a specific vessel by MMSI
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "search_vessels",
  "input": {
    "mmsi": [
      "259000420"
    ]
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Vessel Details

Get vessel specs: name, call sign, IMO, ship type, dimensions, destination, ETA, draught. Listens for static broadcasts (~6 min intervals) so takes longer than position lookups. Also captures position data.

Returns: Vessel profiles with name, type, dimensions, destination, ETA, and current position
Parameters
mmsi *arrayMMSI numbers to look up (9-digit Maritime Mobile Service Identity). Maximum 50 vessels.
durationnumberCollection duration in seconds (10-120, default 45). Longer durations increase the chance of receiving static data.
Example
Get details for a single vessel
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "vessel_details",
  "input": {
    "mmsi": [
      "259000420"
    ]
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Monitor Area

Comprehensive traffic report for a geographic area. Collects all AIS message types and aggregates into a summary with vessel counts, moving vs stationary breakdown, vessel types, and safety alerts.

Returns: Area traffic report with vessel positions, movement statistics, and safety alerts
Parameters
lat_min *numberSouthern boundary latitude (-90 to 90)
lon_min *numberWestern boundary longitude (-180 to 180)
lat_max *numberNorthern boundary latitude (-90 to 90)
lon_max *numberEastern boundary longitude (-180 to 180)
durationnumberCollection duration in seconds (10-180, default 60). Longer durations capture more vessels and patterns.
Example
Monitor the English Channel
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "monitor_area",
  "input": {
    "lat_min": 49.5,
    "lon_min": -5.5,
    "lat_max": 51.5,
    "lon_max": 2
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Safety Alerts

Listen for safety broadcasts in a geographic area: collision warnings, weather advisories, distress signals, and navigational warnings. Captures broadcast and addressed messages. Useful for risk assessment.

Returns: Maritime safety messages with alert text, source vessel, position, and timestamp
Parameters
lat_min *numberSouthern boundary latitude (-90 to 90)
lon_min *numberWestern boundary longitude (-180 to 180)
lat_max *numberNorthern boundary latitude (-90 to 90)
lon_max *numberEastern boundary longitude (-180 to 180)
durationnumberCollection duration in seconds (10-180, default 60). Safety messages are infrequent — longer durations catch more.
Example
Check for safety alerts in the Strait of Hormuz
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "safety_alerts",
  "input": {
    "lat_min": 25.5,
    "lon_min": 55.5,
    "lat_max": 27,
    "lon_max": 57
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Navigation Aids

Find buoys, beacons, lighthouses, and other navigation aids (AtoN) in a geographic area. Returns type, position, dimensions, virtual/physical status. Flags off-position aids for safe navigation.

Returns: Navigation aids inventory with type, position, virtual/physical status, and off-position alerts
Parameters
lat_min *numberSouthern boundary latitude (-90 to 90)
lon_min *numberWestern boundary longitude (-180 to 180)
lat_max *numberNorthern boundary latitude (-90 to 90)
lon_max *numberEastern boundary longitude (-180 to 180)
durationnumberCollection duration in seconds (10-120, default 30). AtoN stations broadcast at regular intervals.
Example
Find navigation aids near Port of Rotterdam
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "navigation_aids",
  "input": {
    "lat_min": 51.85,
    "lon_min": 3.9,
    "lat_max": 52,
    "lon_max": 4.2
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Visualize Area

Generate a bird's-eye satellite or radar-style image of live vessel positions in a geographic area. Collects AIS data, categorizes by status, then produces an AI visualization with vessel markers.

Returns: AI-generated bird's-eye map image with vessel positions, plus structured vessel data
Parameters
lat_min *numberSouthern boundary latitude (-90 to 90)
lon_min *numberWestern boundary longitude (-180 to 180)
lat_max *numberNorthern boundary latitude (-90 to 90)
lon_max *numberEastern boundary longitude (-180 to 180)
durationnumberAIS collection duration in seconds (5-30, default 15). Longer durations find more vessels.
stylestringVisual style: "satellite" for photorealistic overhead view with city lights, "radar" for military CRT radar display aesthetic. Default satellite.
Example
Satellite view of vessels in the Port of Rotterdam
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "vessel-tracker",
  "skill": "visualize_area",
  "input": {
    "lat_min": 51.85,
    "lon_min": 3.9,
    "lat_max": 52,
    "lon_max": 4.2
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Loading reviews...
Loading activity...
v0.032026-03-24
  • Added visualize_area skill — generates AI bird's-eye satellite/radar images from live vessel positions via generate-image composition
v0.022026-03-24
  • Added safety_alerts and navigation_aids skills, improved descriptions per building-tools guide
v0.012026-03-24
  • Initial release with search_vessels, vessel_details, and monitor_area

Quick Start

MCP (Claude Code)
claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp
REST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"vessel-tracker","skill":"search_vessels","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Can I track a specific ship or watch an area?

`search_vessels` finds a vessel by MMSI or bounding box, and `monitor_area` returns a fuller traffic report for a region.

Why does vessel details take longer?

`vessel_details` listens for static broadcasts, so it can take longer than a live position lookup, but it adds ship specs like IMO, dimensions, destination, and ETA.

Can I see safety warnings or navigational hazards?

Yes. `safety_alerts` surfaces collision, weather, distress, and navigational broadcasts, and `navigation_aids` finds buoys, beacons, and lighthouses.

Can I get a map-style view of traffic?

`visualize_area` generates a bird's-eye view with AIS vessel markers for the area you choose.