MCP Server

io.github.ship24-official/ship24-tracking MCP Server

Name: io.github.ship24-official/ship24-tracking MCP Server
Author: io.github.ship24-official

io.github.ship24-official/ship24-tracking

Repository Registry

What is the io.github.ship24-official/ship24-tracking MCP server?

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

How to install io.github.ship24-official/ship24-tracking

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ship24-tracking": {
      "command": "npx",
      "args": [
        "-y",
        "ship24-tracking-mcp"
      ],
      "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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "ship24-tracking": {
      "command": "npx",
      "args": [
        "-y",
        "ship24-tracking-mcp"
      ],
      "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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ship24-tracking": {
      "command": "npx",
      "args": [
        "-y",
        "ship24-tracking-mcp"
      ],
      "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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "ship24-tracking": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ship24-tracking-mcp"
      ],
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add ship24-tracking --env SHIP24_API_KEY=<YOUR_SHIP24_API_KEY> --env PLAN_PER_SHIPMENT=<YOUR_PLAN_PER_SHIPMENT> --env PLAN_PER_CALL=<YOUR_PLAN_PER_CALL> --env SHIP24_BASE_URL=<YOUR_SHIP24_BASE_URL> --env REQUEST_TIMEOUT_MS=<YOUR_REQUEST_TIMEOUT_MS> --env COURIERS_CACHE_TTL_HOURS=<YOUR_COURIERS_CACHE_TTL_HOURS> -- npx -y ship24-tracking-mcp