24hTrack — package tracking across 3,200+ carriers (npm stdio)
LocalAbout 24hTrack — package tracking across 3,200+ carriers (npm stdio)
24hTrack MCP Server lets AI agents track and manage shipments through 24hTrack. It detects carriers from tracking numbers and provides tracking history and monitoring tools across more than 3,200 carriers.
Key features
- 01Automatic carrier detection
- 02Package status and event history
- 03Register and list tracked packages
- 04Request real-time rechecks
- 05Archive tracking numbers
- 06List supported carriers
Use cases
- 01Checking a shipment's latest status
- 02Registering multiple packages for monitoring
- 03Reviewing all tracked shipments
- 04Identifying supported carriers
MCP support
It exposes 24hTrack shipment tracking and management tools to MCP clients, including status lookup, registration, listing, rechecks, archiving, and carrier lookup.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y 24htrack-mcpTRACK24H_API_KEYSecret24hTrack API key — create one free at https://www.24htrack.com (Developer Settings). Optional at startup: the server boots and exposes its tool list without it (so keyless registry health-checks pass); tool CALLS return a guided auth error until it is set.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| tracking_numbers | array | Yes | Array of tracking numbers to look up (max 40) |
Details
From the project README24hTrack MCP Server
Universal package tracking for AI agents via Model Context Protocol. Track packages across 3,200+ carriers including USPS, UPS, FedEx, DHL, China Post, Yanwen, YunExpress, UniUni, SpeedX, Evri, 4PX, and more — with automatic carrier detection, so agents can paste any tracking number and get a real-time event timeline.
Quick Setup
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"24htrack": {
"command": "npx",
"args": ["-y", "24htrack-mcp"],
"env": {
"TRACK24H_API_KEY": "your-api-key-here"
}
}
}
}
Claude Code
claude mcp add 24htrack -- npx -y 24htrack-mcp
Then set the env variable:
export TRACK24H_API_KEY=your-api-key-here
Cursor / Windsurf
Add to MCP settings:
{
"24htrack": {
"command": "npx",
"args": ["-y", "24htrack-mcp"],
"env": {
"TRACK24H_API_KEY": "your-api-key-here"
}
}
}
Get Your API Key
- Register at 24htrack.com
- Go to Developer Settings
- Create an API key
Available Tools
| Tool | Description |
|---|---|
track_package | Get tracking status and full event history for up to 40 packages |
register_tracking | Register new tracking numbers for monitoring |
list_tracking | List all your registered tracking numbers with status |
realtime_track | Force a real-time re-check (results in 2-5 min) |
delete_tracking | Archive tracking numbers |
get_carriers | List all supported carriers |
Example Usage
Once connected, just ask your AI:
"Track my package 1Z999AA10123456784"
"Register these tracking numbers and check their status: 9400111899223456789012, 1Z999AA10123456784"
"Show me all my tracked packages"
"What carriers does 24hTrack support?"
Supported Carriers
USPS, UPS, FedEx, DHL, YunExpress, Yanwen Express, 4PX, Evri, Canada Post, Royal Mail, Australia Post, DPD, UniUni, SpeedX, and 25+ more via aggregator routing.
Links
- Website: 24htrack.com
- API Docs: 24htrack.com/api
- Pricing: 24htrack.com/pricing
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.