Track parcels in real-time by tracking number with automatic carrier detection and event history. Built for developers integrating multi-carrier shipment tracking into applications.
io.github.ship24-official/ship24-tracking
Local install
STDIO
No auth required
How models use it and what it is built for.
Track parcels in real-time by tracking number with automatic carrier detection and event history. Built for developers integrating multi-carrier shipment tracking into applications.
Local install — runs as a subprocess.
Configuration this server reads at startup.
Your Ship24 API key
Set to 'true' to enable the per-shipment Trackers endpoint (for per-shipment plan subscribers)
Set to 'true' to enable the per-call Tracking Search endpoint (for per-call plan subscribers)
Override the Ship24 API base URL (default: https://api.ship24.com/public/v1)
HTTP request timeout in milliseconds (default: 15000)
How long to cache the couriers list in hours (default: 24)
Where to find authoritative docs and source for Ship24 Official Ship24 Tracking.
Paste any of these into Agent Studio after connecting Ship24 Official Ship24 Tracking.
Common questions about connecting and running Ship24 Official Ship24 Tracking.
What do I need to get started with Ship24 tracking?
You need a Ship24 API key (set via SHIP24_API_KEY environment variable) and to install the MCP server with `npx ship24-tracking-mcp@1.0.0`. Choose your billing plan: PLAN_PER_SHIPMENT for per-shipment subscribers or PLAN_PER_CALL for per-call subscribers.
How does automatic carrier detection work?
The server automatically identifies which carrier is handling a parcel based on the tracking number format. This eliminates the need to manually specify carriers when querying shipment status.
Can I customize the API timeout and caching behavior?
Yes. Set REQUEST_TIMEOUT_MS to adjust HTTP timeouts (default 15000ms) and COURIERS_CACHE_TTL_HOURS to control how long the couriers list is cached (default 24 hours). You can also override the base API URL with SHIP24_BASE_URL if needed.
What's the difference between per-shipment and per-call billing?
Per-shipment billing (PLAN_PER_SHIPMENT) charges per tracked shipment and uses the Trackers endpoint. Per-call billing (PLAN_PER_CALL) charges per API call and uses the Tracking Search endpoint. Enable only the mode matching your Ship24 subscription.
What tracking data does the server return?
The server returns real-time parcel status, complete event history showing all delivery milestones, and automatically detected carrier information for each tracking number.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 30+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent Studio