MCP Server 17TRACK

A Model Context Protocol server for package tracking using the 17TRACK API.

1. Register for 17TRACK Developer Account

Introduction

The 17TRACK API is a logistics tracking interface that allows you to query shipping information from 2,927 supported carriers. The API is HTTP-based, language-independent, and uses WEBHOOK mechanisms for information delivery (register tracking numbers first, then receive push notifications). It automatically tracks logistics information throughout the entire process. View supported carriers at: https://www.17track.net/en/carriers

Please ensure you have successfully registered for an API account. If not, visit: https://api.17track.net

You get 100 free tracking numbers per month.

Getting Your API Key

After logging in with your API account, visit the Settings page to obtain your API key.

Changing Your API Key

On the Settings page, click the "Change Key" button. The new key will take effect within 5 minutes, and the old key will become invalid immediately after the new one is activated.

Important Notes

• Not recommended for web frontend use due to API key exposure risks
• Each API endpoint has a rate limit of 3 requests/second; exceeding this will return a 429 error
• All timestamps in API responses are in UTC format
• All APIs may be extended while maintaining compatibility
• All response data shows null when attributes have no information
• Tracking number + carrier code combination forms the unique data identifier
• For data transmission security, upgrade all services to TLSv1.2 or higher. HTTP, TLSv1.0, or TLSv1.1 connections will be rejected

2. Configure MCP Server

2.1 Claude Desktop Example

Add the following configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "mcp-server-17track": {
      "command": "npx",
      "args": ["-y", "mcp-server-17track@latest"],
      "env": {
        "API_TOKEN_17TRACK": "your_17track_api_token"
      }
    }
  }
}

Replace your_17track_api_token with your actual 17TRACK API token obtained from the Settings page.

Features

• Track packages from 2,927+ supported carriers
• Real-time tracking information
• Automatic carrier detection
• Detailed delivery status updates

Usage

Once configured, you can use the MCP server to track packages by providing tracking numbers. The server will automatically query the 17TRACK API and return detailed tracking information.