DataDocked MCP Server (TypeScript)

MCP (Model Context Protocol) server for the DataDocked Maritime API. Enables AI assistants like Claude to access real-time vessel tracking, port operations, and maritime intelligence.

What's New in v1.5.0

• NEW: Vessel name search: Search for vessels by name using search_vessel_by_name tool
  • Query: "Where is the Ever Given?" → First searches by name, gets IMO, then tracks
• Fixed API endpoints: Corrected endpoint names (vessel-mou, get-vessel-weather, port-calls-by-vessel, etc.)
• Fixed API parameters: Updated from_date/to_date for historical data, imo_or_mmsi for weather
• Improved formatters: Handle string values from API responses (tonnage, dimensions)
• Better error handling: Graceful fallbacks when data is unavailable
• All compound tools tested and working: vessel_intelligence_report, voyage_analysis, risk_assessment, area_intelligence

Features

• 21 MCP Tools: 13 basic single-endpoint tools + 8 compound multi-endpoint tools
• Pre-execution Credit Warnings: Know the cost before running operations
• Rich Formatted Output: Markdown tables and structured reports
• Parallel API Calls: Compound tools fetch data concurrently for speed

Quick Start

npm install -g datadocked-mcp
datadocked-setup

The setup wizard will:

1. Ask for your API key (get it from datadocked.com/dashboard)
2. Configure Claude Desktop and/or Cursor automatically
3. Install Claude Code skills

Installation

NPM (Recommended)

npm install -g datadocked-mcp

From Source

git clone https://github.com/Data-Docked/mcp-server.git
cd mcp-server/datadocked-mcp-ts
npm install
npm run build

Configuration

Option 1: Interactive Setup (Recommended)

datadocked-setup

Option 2: Manual Configuration

Environment Variables

# Required: Your DataDocked API key
export DATADOCKED_API_KEY="your_api_key_here"

# Optional: Disable credit cost warnings (default: true)
export DATADOCKED_SHOW_COST="false"

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "datadocked": {
      "command": "npx",
      "args": ["datadocked-mcp"],
      "env": {
        "DATADOCKED_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "datadocked": {
    "command": "npx",
    "args": ["datadocked-mcp"],
    "env": {
      "DATADOCKED_API_KEY": "your_api_key_here"
    }
  }
}

Available Tools

Basic Tools (Single-Endpoint)

| Tool | Description | Credits | Identifier | |------|-------------|---------|------------| | track_vessel | Real-time position, speed, course, ETA | 1 | IMO or MMSI | | track_vessels_bulk | Track up to 50 vessels | 1/vessel | IMO or MMSI | | get_vessel_history | Historical positions (up to 2 years) | 5/day | IMO or MMSI | | search_vessels_by_area | Find vessels in circular area (lat, lon, radius) | 10 | N/A | | get_vessel_details | Full vessel profile (includes management + engine) | 5 | IMO or MMSI | | get_vessel_specs | Dimensions, tonnage, capacity | 1 | IMO or MMSI | | get_vessel_engine | Engine specs, fuel type | 1 | IMO or MMSI | | get_vessel_management | Owner, operator, P&I club | 1 | IMO or MMSI | | get_port_calls | Port visit history | 1 | IMO or MMSI | | get_port_traffic | Port arrivals/departures | 5 | Port code | | get_psc_inspections | PSC inspection records (vessel-mou) | 3 | IMO only | | get_vessel_weather | Weather at vessel location | 1 | IMO or MMSI | | search_vessel_by_name | Search vessels by name, returns IMO/MMSI | 1 | Vessel name |

Compound Tools (Multi-Endpoint)

| Tool | Description | Credits | |------|-------------|---------| | vessel_intelligence_report | Complete vessel dossier (7 endpoints) | ~13 | | fleet_dashboard | Fleet status with vessel details | ~6/vessel | | voyage_analysis | Current voyage with weather + history | ~38 | | port_activity_analysis | Rich port traffic analysis | varies | | risk_assessment | PSC + management + risk score | ~10 | | area_intelligence | Region with full vessel profiles | 10 + 5/vessel |

Usage Examples

Natural Language Queries

"Where is the Ever Given right now?"
→ Uses search_vessel_by_name to find IMO, then track_vessel

"Track vessel IMO 9811000" (Ever Given)
→ Uses track_vessel

"Show me all tankers near the Strait of Hormuz"
→ Uses search_vessels_by_area with vessel_type filter

"Give me a full intelligence report on vessel 9321483"
→ Uses vessel_intelligence_report (7 API calls combined)

"What's the risk profile of IMO 1012775?"
→ Uses risk_assessment (4 API calls + analysis)

Tip: Using IMO (7 digits) or MMSI (9 digits) directly is most efficient. Use search_vessel_by_name when you only know the vessel name (+1 credit). Find IMO numbers on MarineTraffic or VesselFinder.

Credit Estimation

When enabled, each tool shows the estimated cost before execution:

--- Credit Estimate ---
Operation: Vessel Intelligence Report
Estimated Cost: 18 credits
Current Balance: 1,250 credits
To disable: set DATADOCKED_SHOW_COST=false
------------------------

Claude Code Skills

This package includes 10 slash command skills for Claude Code. Install them with:

datadocked-skills --install-skills

Or list available skills:

datadocked-skills --list-skills

Available Skills

| Command | Description | Credits | |---------|-------------|---------| | /track-vessel <IMO> | Quick position lookup | 1 | | /vessel-info <IMO> | Basic vessel details | 5 | | /port-traffic <port> | Port arrivals/departures | 5 | | /vessel-dossier <IMO> | Complete intelligence report | ~10 | | /fleet-monitor <IMOs> | Multi-vessel dashboard | ~6/vessel | | /voyage-brief <IMO> | Voyage narrative with weather | ~38 | | /port-intel <port> | Port activity analysis | ~55 | | /compliance-audit <IMO> | PSC risk assessment (requires IMO) | ~9 | | /area-watch <lat,lon,radius> | Circular area monitoring | ~60 | | /route-history <IMO> | Historical voyage patterns | ~156 |

Resources

The server also exposes MCP resources:

| Resource URI | Description | |--------------|-------------| | datadocked://credits/balance | Current credit balance |

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspector

API Reference

Full API documentation: https://docs.datadocked.com

License

MIT

Support

• Documentation: https://docs.datadocked.com
• Issues: https://github.com/Data-Docked/mcp-server/issues
• Website: https://datadocked.com