A
securityA
licenseA
qualityThis is an MCP (Model Context Protocol) server that provides tools for interacting with the NOAA Tides and Currents API.
Last updated -
24
2
4
MIT License
Provides a configuration mechanism for the MCP server to securely store and access the Shipxy API key through a .env file.
The server is built using Python, allowing developers to run the MCP server and extend its functionality using Python libraries and tools.
Enables querying tide station data and retrieving tide information for maritime operations through dedicated tide-related API endpoints.
shipxy-api-mcp
Shipxy MCP Server is a fully MCP-compliant, open-source Location-Based Service (LBS) solution for maritime scenarios, providing a comprehensive suite of ship and port APIs and tools for developers and AI agents. It enables seamless integration of real-time vessel data, route planning, weather, tides, and more into your applications.
🚀 Introduction
Shipxy MCP Server empowers your applications, LLMs, and agents with advanced maritime data and geospatial intelligence, including:
Ship Information & Tracking: Real-time vessel position, static info, fleet, and area queries.
Port & Berth Data: Global port search, berth/anchor/ETA queries, port call records.
Route Planning: Point-to-point and port-to-port route planning.
Weather & Tides: Marine weather, typhoon, and tide station data.
Rich Maritime APIs: Ship registry, particulars, approach events, and more.
All APIs follow the MCP protocol and can be called from any MCP-compliant client, LLM, or agent platform.
🛠️ Key Features
Full MCP Protocol Support: Seamless integration with any MCP-compliant agent, LLM, or platform.
Comprehensive Maritime Data: Ships, ports, routes, weather, tides, and more.
Real-Time & Historical Data: Live vessel tracking, voyage history, and event records.
Open Source & Extensible: MIT licensed, easy to customize and extend.
⚡ Quick Start
1. Get Your API Key
Register and create a server-side API Key at Shipxy Open Platform.
Note: The API key is required for all requests.
2. Installation
pip install -r requirements.txt
3. Configuration
Create a .env file in your project root:
SHIPXY_API_KEY=your_api_key_here
4. Start the Server
Recommended: Use an mcp.json configuration file for easy integration with MCP CLI and agent platforms. Example:
{
"mcpServers": {
"shipxy-api-mcp": {
"command": "python",
"args": ["/path/to/your/server.py"],
"env": {
"SHIPXY_API_KEY": "your_api_key_here"
}
}
}
}
🧩 Supported APIs
Tool Name | Description |
search_ship | Fuzzy search for ships by MMSI, IMO, name, or call sign |
get_single_ship | Query real-time info for a single ship by MMSI |
get_many_ship | Query real-time info for multiple ships by MMSI list |
get_fleet_ship | Query all ships in a fleet |
get_surrounding_ship | Query ships within 10nm of a given ship |
get_area_ship | Query ships in a specified area |
get_ship_registry | Query ship registry/country info |
search_ship_particular | Query ship particulars by MMSI/IMO/call sign/name |
search_port | Fuzzy search for ports by name or code |
get_berth_ships | Query ships currently berthed at a port |
get_anchor_ships | Query ships at anchor at a port |
get_eta_ships | Query ships with ETA to a port |
get_ship_track | Query historical track points for a ship |
search_ship_approach | Query ship-to-ship approach events |
get_port_of_call_by_ship | Query port call records for a ship |
get_port_of_call_by_port | Query port call records for a port |
plan_route_by_point | Plan route between two coordinates |
plan_route_by_port | Plan route between two ports |
get_single_eta_precise | Get ETA and voyage info for a ship |
get_weather_by_point | Query marine weather by coordinates |
get_weather | Query marine weather by area |
get_all_typhoon | List recent typhoons |
get_single_typhoon | Query details for a specific typhoon |
get_tides | List tide stations |
get_tide_data | Query tide data for a station |
🌍 Application Scenarios
Maritime Logistics & Fleet Management
Vessel Tracking & Monitoring
Port Operations & ETA Prediction
Smart Shipping & Route Optimization
Marine Weather & Safety Applications
📦 Project Structure
.
├── server.py # MCP server entry point
├── ship_service.py # Shipxy API integration and business logic
├── requirements.txt # Python dependencies
├── pyproject.toml # Project metadata
└── README.md # This file
📄 License
MIT © shipxy-api-mcp contributors
📞 Contact
For more information or business inquiries, please contact:
Phone: 400-010-8558 / 010-8286 8599
This server cannot be installed
A fully MCP-compliant, open-source maritime data service that provides real-time vessel tracking, port information, route planning, and weather/tide data for maritime applications.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides real-time weather information including temperature, humidity, wind speed, and sunrise/sunset times through the OpenWeatherMap API.Last updated -12MIT License
- AsecurityAlicenseAqualityAn MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.Last updated -1746PythonMIT License
- -securityFlicense-qualityAn MCP server that provides real-time weather alerts, forecasts, stock market data, and news information through various API integrations.Last updated -