Skip to main content
Glama

Parcel Tracking MCP Server

by iamfiro
npmGitHub
TypeScript
2
2
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Parcel Tracking MCP Server

A Model Context Protocol (MCP) server for tracking parcel deliveries using the 17track.net API.

Features

  • Track parcel deliveries from various carriers

  • Automatic carrier detection

  • Support for manual carrier specification

  • Built with TypeScript and MCP SDK

Prerequisites

  • Node.js (v16 or higher)

  • npm or yarn

  • 17track.net API token

Installation

Install the package via npm:

npm install -g parcel-tracking-mcp-server

Or install locally:

npm install parcel-tracking-mcp-server

Configuration

Create a config.json file in your working directory with your 17track.net API token:

{ "apiToken": "your-17track-api-token-here" }

Note: The server looks for config.json in the current working directory where you run the command.

Getting a 17track.net API Token

  1. Visit 17track.net

  2. Sign up for an account

  3. Navigate to the API section

  4. Generate your API token

  5. Add it to your config.json file

Usage

Running the Server

If installed globally:

parcel-tracking-mcp-server

If installed locally:

npx parcel-tracking-mcp-server

Or if you're using it as a dependency in your project:

node node_modules/parcel-tracking-mcp-server/dist/index.js

MCP Client Configuration

To use this server with MCP clients (like Claude Desktop), add it to your MCP configuration:

{ "mcpServers": { "parcel-tracking": { "command": "npx", "args": ["parcel-tracking-mcp-server"] } } }

Or if installed globally:

{ "mcpServers": { "parcel-tracking": { "command": "parcel-tracking-mcp-server" } } }

Available Tools

tracking-delivery

Track a parcel delivery by providing a tracking number.

Parameters:

  • number (required): The tracking number of the parcel

  • carrier (optional): The carrier of the parcel (defaults to 'auto' for automatic detection)

Example:

// Track with automatic carrier detection await trackingDelivery({ number: "1234567890" }); // Track with specific carrier await trackingDelivery({ number: "1234567890", carrier: "ups" });

Supported Carriers

The server supports automatic carrier detection, but you can also specify carriers manually. Common carriers include:

  • UPS

  • FedEx

  • DHL

  • USPS

  • China Post

  • And many more (check 17track.net documentation for full list)

API Response Format

The server returns tracking information in JSON format, including:

  • Tracking status

  • Delivery progress

  • Timestamps

  • Location updates

  • Carrier information

Error Handling

The server includes comprehensive error handling:

  • API connection errors

  • Invalid tracking numbers

  • Missing configuration

  • Network timeouts

Development

Project Structure

├── index.ts # Main server implementation ├── config.json # Configuration file (create this) ├── package.json # Dependencies and scripts └── README.md # This file

Dependencies

  • @modelcontextprotocol/sdk - MCP SDK for building servers

  • zod - Schema validation

  • node-fetch - HTTP requests (if needed for older Node.js versions)

License

MIT License

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Submit a pull request

Support

For issues related to:

Changelog

v1.0.0

  • Initial release

  • Basic parcel tracking functionality

  • Support for automatic and manual carrier detection

  • Error handling and logging

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Tools

Allows tracking of parcel deliveries across various carriers using the 17track.net API, with automatic or manual carrier detection.

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Getting a 17track.net API Token
        2. Usage
          1. Running the Server
        3. MCP Client Configuration
          1. Available Tools
          2. Supported Carriers
        4. API Response Format
          1. Error Handling
            1. Development
              1. Project Structure
              2. Dependencies
            2. License
              1. Contributing
                1. Support
                  1. Changelog
                    1. v1.0.0

                  Related MCP Servers

                  • Shiplogic MCP Server

                    jlwainwright
                    A
                    security
                    A
                    license
                    A
                    quality
                    An MCP server providing seamless integration with the Shiplogic shipping API to calculate shipping rates, create shipments, track packages, and manage shipping operations programmatically.
                    Last updated -
                    5
                    MIT License

                  • Trackmage MCP Serverofficial

                    trackmage
                    -
                    security
                    A
                    license
                    -
                    quality
                    Provides shipment tracking api and logistics management capabilities through the TrackMage API. Enables creation and monitoring of shipments and orders, carrier detection, tracking checkpoint retrieval, and comprehensive logistics workflow automation.
                    Last updated -
                    1
                    MIT License

                  • ShipEngine API MCP Server

                    ag2-mcp-servers
                    -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server that enables interaction with ShipEngine's shipping API, allowing users to manage shipments, labels, carriers, and other shipping operations through natural language commands.
                    Last updated -

                  • Shipping Service MCP Server

                    WangTingYeYe
                    -
                    security
                    A
                    license
                    -
                    quality
                    Provides a Model Context Protocol server for managing shipping orders and address book functionality with support for connecting to real shipping services via HTTP API.
                    Last updated -
                    MIT License

                  View all related MCP servers

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/iamfiro/parcel-tracking-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server