io.github.ship24-official/ship24-tracking
Track any parcel by tracking number β real-time status, event history, and carrier detection.
Ask AI about io.github.ship24-official/ship24-tracking
Powered by Claude Β· Grounded in docs
I know everything about io.github.ship24-official/ship24-tracking. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
ship24-tracking-mcp
An MCP (Model Context Protocol) server for shipment tracking. Connect any MCP-compatible AI assistant to the Ship24 API to track parcels by tracking number β with real-time status, full event history, carrier detection, and location information.
Requirements
- Node.js 18+
- A Ship24 API key
- Either a per-shipment or per-call Ship24 plan (or both)
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ship24-tracking": {
"command": "npx",
"args": ["ship24-tracking-mcp"],
"env": {
"SHIP24_API_KEY": "your_api_key_here",
"PLAN_PER_SHIPMENT": "true",
"PLAN_PER_CALL": "false"
}
}
}
}
Cursor / other MCP clients
{
"ship24-tracking": {
"command": "npx",
"args": ["ship24-tracking-mcp"],
"env": {
"SHIP24_API_KEY": "your_api_key_here",
"PLAN_PER_SHIPMENT": "true",
"PLAN_PER_CALL": "false"
}
}
}
Configuration
| Variable | Required | Description |
|---|---|---|
SHIP24_API_KEY | Yes | Your Ship24 API key |
PLAN_PER_SHIPMENT | One must be true | Enable the Trackers endpoint (per-shipment plan) |
PLAN_PER_CALL | One must be true | Enable the Tracking Search endpoint (per-call plan) |
SHIP24_BASE_URL | No | Override API base URL (default: https://api.ship24.com/public/v1) |
REQUEST_TIMEOUT_MS | No | HTTP timeout in ms (default: 15000) |
COURIERS_CACHE_TTL_HOURS | No | Couriers list cache duration in hours (default: 24) |
Tools
trackShipment
Track a shipment by tracking number. Returns the current status, most recent location, and full event timeline.
Parameters:
trackingNumber(required) β The shipment tracking numbercourierName(optional) β Carrier name (e.g. DHL, FedEx, UPS, USPS). Recommended when known.destinationPostCode(optional) β Destination ZIP or postal codedestinationCountryCode(optional) β Destination country (ISO alpha-2 or alpha-3)
serviceStatus
Check whether the tracking service is configured and operational.
License
MIT Β© Ship24
