Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Maersk Vessel Deadlines MCP Serverwhat's the schedule for vessel MSC Oscar with voyage 123E from Shanghai?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Maersk Vessel Deadlines MCP Server
This project is a Model Context Protocol (MCP) server that provides programmatic access to Maersk vessel information, including vessel schedules and shipment deadlines. It exposes tools that can be used by MCP-compatible clients (like Claude Desktop, GPTs, or other AI assistants) to retrieve up-to-date shipping data from Maersk's public APIs.
About Model Context Protocol (MCP)
The Model Context Protocol is an open standard that enables AI assistants to connect to external data sources and tools. MCP servers provide a standardized way for AI models to access real-time information and perform actions through a secure, structured interface.
Features & Available Tools
The MCP server exposes the following tools:
1. get_vessel_imo
Description: Retrieve the IMO (International Maritime Organization) number for a vessel by its name.
Input: Vessel name (string)
Output: IMO number (string)
2. get_vessel_schedule
Description: Retrieve the schedule and shipment deadlines for a vessel, given its IMO number, voyage number, port of loading, and ISO country code.
Inputs:
vessel_imo: IMO number of the vessel (string)voyage_number: Voyage number (string)port_of_loading: Port of loading (string)iso_country_code: ISO country code of the port (string)
Output: Human-readable summary of the vessel's schedule and deadlines
3. get_port_calls
Description: Retrieve the vessels calling on a specific port, given its Country and Port of Loading city for the next one week.
Inputs:
country_code: ISO Country Codecity_name: POL City name
Output: Human-readable summary of vessels calling upon the port in the next 1 week.
These tools are defined in main.py and are accessible via the MCP protocol for integration with AI assistants and other MCP clients.
Requirements
Python 3.11+
Maersk API Consumer Key (set as
CONSUMER_KEYin your environment)
Installation & Usage
Using Docker (Recommended)
A prebuilt Docker image is available at dipankan001/maersk-mcp:v1:
Connecting to MCP Clients
Claude Desktop
Add this to your Claude Desktop configuration:
Other MCP Clients
For other MCP-compatible clients, configure the server using the appropriate connection method (HTTP, stdio, etc.) as specified in the MCP specification.
Endpoints
The app exposes MCP tools for:
Getting vessel IMO numbers
Fetching vessel schedules and shipment deadlines
Fetching active port call vessels
See main.py for details on available tools and their parameters.