Skip to main content
The DataDocked MCP Server provides 18 tools for querying maritime data.

Basic Tools

Single-endpoint operations that query one API endpoint.
ToolAPI EndpointIdentifierCreditsRate Limit
track_vesselget-vessel-locationIMO or MMSI1100/min
track_vessels_bulkget-vessels-location-bulk-searchIMO or MMSI1/vessel15/min
search_vessel_by_namevessels-by-nameVessel name150/min
get_vessel_historyget-vessel-historical-dataIMO or MMSI5/day15/min
search_vessels_by_areaget-vessels-by-arealat, lon, radius_km1050/min
get_vessel_detailsget-vessel-infoIMO or MMSI515/min
get_vessel_specsget-vessel-particularsIMO or MMSI350/min
get_vessel_engineget-vessel-engine-dataIMO or MMSI350/min
get_vessel_managementget-vessel-management-dataIMO or MMSI350/min
get_port_callsport-calls-by-vesselIMO or MMSI115/min
get_port_trafficport-calls-by-portPort code515/min
get_psc_inspectionsvessel-mouIMO only315/min
get_vessel_weatherget-vessel-weatherIMO or MMSI215/min
get_vessel_details returns comprehensive data including specifications, engine info, and management details in a single call - often eliminating the need for separate get_vessel_specs, get_vessel_engine, and get_vessel_management calls.
get_psc_inspections requires IMO number only. MMSI is not accepted.

Compound Tools

Multi-endpoint operations that combine multiple API calls into comprehensive reports.
ToolDescriptionCredits
vessel_intelligence_reportComplete vessel dossier~13
fleet_dashboardFleet status with vessel details~3/vessel
voyage_analysisCurrent voyage with weather & history~38
port_activity_analysisRich port traffic analysisvaries
risk_assessmentComposite risk score~10
area_intelligenceRegion with full vessel profiles (circular search)10 + 5/vessel

Area-based searches use circular search with center coordinates and radius:
latitude, longitude, radius_km
Maximum radius is 50 km. For larger areas, use multiple searches with different center points.
Example regions:
RegionCenter LatCenter LonRadius
Singapore Strait1.25103.7550 km
Strait of Hormuz26.556.550 km
English Channel (Dover)51.11.350 km
Rotterdam Port51.94.530 km

Usage Examples

Track a Vessel

"Where is the Ever Given right now?"
Uses track_vessel (1 credit) to return:
  • Current position (lat/lon)
  • Speed and course
  • Destination and ETA
  • Navigation status

Get Complete Vessel Intelligence

"Generate a full dossier on vessel 9811000"
Uses vessel_intelligence_report (~13 credits) combining:
  • Position tracking
  • Full vessel details (specs, engine, management)
  • Port call history
  • PSC inspection records (requires IMO)

Search an Area

"Show me all tankers within 50km of Singapore"
Uses search_vessels_by_area (10 credits) with circular search to find vessels in the specified region, filtered by vessel type.

Credit Management

Check your credit balance anytime by asking: “How many credits do I have left?”
Credits are deducted when a tool executes. The MCP server shows estimated costs before running compound operations. To disable credit warnings:
export DATADOCKED_SHOW_COST=false