io.github.ship24-official/ship24-tracking

Official

Track any parcel by tracking number — real-time status, event history, and carrier detection.

Tracks parcels in real-time with status, history, and carrier detection.

Install

Configuration

Environment variables

SHIP24_API_KEY

Your Ship24 API key

PLAN_PER_SHIPMENT

Set to 'true' to enable the per-shipment Trackers endpoint (for per-shipment plan subscribers)

PLAN_PER_CALL

Set to 'true' to enable the per-call Tracking Search endpoint (for per-call plan subscribers)

SHIP24_BASE_URL

Override the Ship24 API base URL (default: https://api.ship24.com/public/v1)

REQUEST_TIMEOUT_MS

HTTP request timeout in milliseconds (default: 15000)

COURIERS_CACHE_TTL_HOURS

How long to cache the couriers list in hours (default: 24)

claude_desktop_config.json

{
  "mcpServers": {
    "ship24-tracking": {
      "command": "npx",
      "args": [
        "-y",
        "ship24-tracking-mcp@1.0.0"
      ],
      "env": {
        "SHIP24_API_KEY": "<YOUR_SHIP24_API_KEY>",
        "PLAN_PER_SHIPMENT": "<YOUR_PLAN_PER_SHIPMENT>",
        "PLAN_PER_CALL": "<YOUR_PLAN_PER_CALL>",
        "SHIP24_BASE_URL": "<YOUR_SHIP24_BASE_URL>",
        "REQUEST_TIMEOUT_MS": "<YOUR_REQUEST_TIMEOUT_MS>",
        "COURIERS_CACHE_TTL_HOURS": "<YOUR_COURIERS_CACHE_TTL_HOURS>"
      }
    }
  }
}