# 24htrack-mcp

Universal package tracking for AI agents. Track packages across 30+ carriers including USPS, UPS, FedEx, DHL, Evri, Yanwen, 4PX, and more. Register tracking numbers, get real-time status updates, and…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ngkienmkqn-wsy8/track24h-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list ngkienmkqn-wsy8/track24h-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ngkienmkqn-wsy8/track24h-mcp track_package

# Call a tool
npx -y @smithery/cli@latest tool call ngkienmkqn-wsy8/track24h-mcp track_package '{}'
```

## Direct MCP Connection

Endpoint: `https://track24h-mcp--ngkienmkqn-wsy8.run.tools`

**Required config:**
- `TRACK24H_API_KEY` (query) — Your 24hTrack API key. Get one at https://www.24htrack.com

## Tools (6)

- `track_package` — Get tracking status and events for one or more packages.
- `register_tracking` — Register tracking numbers for monitoring. Auto-detects carrier.
- `list_tracking` — List all registered tracking numbers with current status. Paginated.
- `realtime_track` — Force real-time re-check. Results update in 2-5 min.
- `delete_tracking` — Archive tracking numbers (soft-delete).
- `get_carriers` — List all supported carriers.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ngkienmkqn-wsy8/track24h-mcp <tool-name>
```