datadocked-mcp

# DataDocked MCP Server (Python) 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.2.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 ## 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 - **Async API Client**: Non-blocking concurrent requests for compound tools ## Installation ### PyPI (Recommended) ```bash pip install datadocked-mcp ``` ### From Source ```bash git clone https://github.com/datadocked/mcp-server.git cd mcp-server/datadocked-mcp-py pip install -e . ``` ## Configuration ### Environment Variables ```bash # 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`): ```json { "mcpServers": { "datadocked": { "command": "datadocked-mcp", "env": { "DATADOCKED_API_KEY": "your_api_key_here" } } } } ``` Or using uvx: ```json { "mcpServers": { "datadocked": { "command": "uvx", "args": ["datadocked-mcp"], "env": { "DATADOCKED_API_KEY": "your_api_key_here" } } } } ``` ### Cursor / VS Code Add to your MCP settings: ```json { "datadocked": { "command": "datadocked-mcp", "env": { "DATADOCKED_API_KEY": "your_api_key_here" } } } ``` ## Available Tools ### Basic Tools (Single-Endpoint) | Tool | Description | Credits | |------|-------------|…