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 number
courierName (optional) — Carrier name (e.g. DHL, FedEx, UPS, USPS). Recommended when known.
destinationPostCode (optional) — Destination ZIP or postal code
destinationCountryCode (optional) — Destination country (ISO alpha-2 or alpha-3)

`serviceStatus`

Check whether the tracking service is configured and operational.

ship24-tracking

Quick Install