TrackMage MCP Server

TrackMage MCP Server

Shipment and logistics tracking MCP server with multi-carrier support.

1
Stars
4
Forks
1
Watchers
2
Issues
TrackMage MCP Server implements the Model Context Protocol (MCP) to provide shipment tracking, logistics management, and API integration for over 1,600 carriers worldwide. It allows integration with major LLMs, supports resources such as workspaces, shipments, orders, carriers, and tracking statuses, and offers tools to create, update, and monitor shipments and orders. The server supports OAuth-based authentication, flexible configuration via environment variables, and can be deployed locally for customized logistics operations.

Key Features

Supports tracking across 1600+ carriers worldwide
Implements Model Context Protocol (MCP)
Provides resources for workspaces, shipments, orders, carriers, and statuses
Enables creation, update, and listing of shipments and orders
Returns shipment checkpoint events and tracking statuses
Carrier detection and shipment retracking tools
OAuth client credentials authentication
Local deployment with environment variable configuration
Integration-ready for LLMs like ChatGPT and Claude
Serves both HTTP and process-based connections for MCP servers

Use Cases

Automated shipment tracking integration for e-commerce platforms
Unified logistics data access for large language models
Order and shipment management in warehouse operations
Developing logistics dashboards for customer support teams
Tracking and reporting across global carrier networks
Building workflow automations using real-time shipment status
Evaluating and updating order fulfillment pipelines
Monitoring logistics data for predictive analytics
Providing logistics management capabilities in SaaS applications
Enhancing custom AI-powered assistants with logistics data

README

TrackMage MCP Server - Shipment Tracking API & Logistics API Integration

A Model Context Protocol (MCP) server for shipment tracking api, package monitoring, and logistics management using the TrackMage API. Supports tracking across 1600+ carriers worldwide.

Features

  • Carrier Support: Track packages across 1600+ carriers worldwide (full list)
  • Resources: Workspaces, shipments, orders, carriers, tracking statuses
  • Tools: Create shipments/orders, get shipment checkpoints, carrier detection
  • Authentication: OAuth with client credentials

⚠️ Data Privacy Notice

Data sharing with your LLM provider: This MCP server provides data to whichever LLM you're using (Claude, ChatGPT, etc.). While this is the expected behavior for MCP servers, please ensure you're comfortable sharing logistics data including tracking numbers, customer emails, addresses, and shipment details with your chosen LLM provider.

Best practices:

  • Only use with non-sensitive or test data if you have privacy concerns
  • Check your LLM provider's data handling policies
  • Consider opting out of training data programs if available
  • Ensure compliance with your organization's data policies

Prerequisites

  • Node.js v18+
  • TrackMage account

Getting Credentials

  1. Register and log into TrackMage.
  2. Go to Settings > API KEYS.
  3. Enter an App Name (e.g., "MCP") and App URL (e.g., http://localhost:3000).
  4. Click Generate and copy your Client ID and Client Secret.
  5. Note your Workspace ID from the dashboard URL.

Installation

Option 1: Local Setup

bash
git clone https://github.com/yourusername/trackmage-mcp-server.git
cd trackmage-mcp-server
npm install
cp .env.example .env
# Edit .env with your credentials
npm start

Configuration

Edit .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Usage

Run the server:

bash
npm start

and then use

{
  "mcpServers": {
    "trackmage": {
      "transport": {
        "type": "http",
        "host": "localhost",
        "port": 3000
      }
    }
  }
}

or using file process:

{
  "mcpServers": {

    "trackmage": {
      "command": "node",
      "args": ["/path/to/trackmage-mcp-server/index.js"],
      "env": {
        "TRACKMAGE_CLIENT_ID": "your_client_id_here",
        "TRACKMAGE_CLIENT_SECRET": "your_client_secret_here",
        "TRACKMAGE_WORKSPACE_ID": "your_workspace_id_here"
      }
    }

  }
}

MCP Resources

  • trackmage:///workspaces/{id}
  • trackmage:///shipments/{id}
  • trackmage:///orders/{id}
  • trackmage:///carriers/{id}
  • trackmage:///tracking_statuses/{id}

MCP Tools

Shipment Management

  • create_shipment: Create a new shipment

    • Parameters: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Returns: Created shipment object
  • update_shipment: Update an existing shipment

    • Parameters: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Returns: Updated shipment object
  • list_shipments: List shipments from workspace

    • Parameters: { workspaceId?, page?, itemsPerPage? }
    • Returns: Array of shipment objects
  • get_shipment_checkpoints: Get tracking checkpoints for a shipment

    • Parameters: { shipmentId }
    • Returns: Array of tracking checkpoint events
  • retrack_shipments: Retrack multiple shipments by tracking numbers

    • Parameters: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Returns: Retracking results

Order Management

  • create_order: Create a new order

    • Parameters: { orderNumber, email?, workspaceId? }
    • Returns: Created order object
  • update_order: Update an existing order

    • Parameters: { orderId, orderNumber?, email?, status? }
    • Returns: Updated order object
  • list_orders: List orders from workspace

    • Parameters: { workspaceId?, page?, itemsPerPage? }
    • Returns: Array of order objects

Carrier Management

  • list_carriers: List available carriers

    • Parameters: { page?, itemsPerPage? }
    • Returns: Array of carrier objects with codes and names
  • detect_carrier: Detect possible carriers for a tracking number

    • Parameters: { trackingNumber }
    • Returns: Array of possible carrier matches

Testing

bash
npm test

Star History

Star History Chart

Repository Owner

trackmage
trackmage

Organization

Repository Details

Language JavaScript
Default Branch main
Size 9 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
99.48%
Dockerfile
0.52%

Tags

Topics

mcp mcp-server model-context-protocol package-tracking shipment-tracking tracking-api trackmage

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Teamwork MCP Server

    Teamwork MCP Server

    Seamless Teamwork.com integration for Large Language Models via the Model Context Protocol

    Teamwork MCP Server is an implementation of the Model Context Protocol (MCP) that enables Large Language Models to interact securely and programmatically with Teamwork.com. It offers standardized interfaces, including HTTP and STDIO, allowing AI agents to perform various project management operations. The server supports multiple authentication methods, an extensible toolset architecture, and is designed for production deployments. It provides read-only capability for safe integrations and robust observability features.

    • 11
    • MCP
    • Teamwork/mcp
  • TeslaMate MCP Server

    TeslaMate MCP Server

    Query your TeslaMate data using the Model Context Protocol

    TeslaMate MCP Server implements the Model Context Protocol to enable AI assistants and clients to securely access and query Tesla vehicle data, statistics, and analytics from a TeslaMate PostgreSQL database. The server exposes a suite of tools for retrieving vehicle status, driving history, charging sessions, battery health, and more using standardized MCP endpoints. It supports local and Docker deployments, includes bearer token authentication, and is intended for integration with MCP-compatible AI systems like Claude Desktop.

    • 106
    • MCP
    • cobanov/teslamate-mcp
  • Yandex Tracker MCP Server

    Yandex Tracker MCP Server

    A Model Context Protocol server for secure and flexible integration with Yandex Tracker APIs.

    Yandex Tracker MCP Server enables AI assistants to securely interact with Yandex Tracker APIs by providing authenticated access to issues, queues, comments, worklogs, and more. It supports advanced query capabilities, optional Redis caching for enhanced performance, and multiple transport options including HTTP and stdio. The server features OAuth 2.0 authentication, granular security controls, and can be seamlessly integrated as an extension in various AI clients, such as Claude Desktop.

    • 28
    • MCP
    • aikts/yandex-tracker-mcp
  • Klavis

    Klavis

    One MCP server for AI agents to handle thousands of tools.

    Klavis provides an MCP (Model Context Protocol) server with over 100 prebuilt integrations for AI agents, enabling seamless connectivity with various tools and services. It offers both cloud-hosted and self-hosted deployment options and includes out-of-the-box OAuth support for secure authentication. Klavis is designed to act as an intelligent connector, streamlining workflow automation and enhancing agent capability through standardized context management.

    • 5,447
    • MCP
    • Klavis-AI/klavis
  • Google Workspace MCP Server

    Google Workspace MCP Server

    Full natural language control of Google Workspace through the Model Context Protocol.

    Google Workspace MCP Server enables comprehensive natural language interaction with Google services such as Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, and Chat via any MCP-compatible client or AI assistant. It supports both single-user and secure multi-user OAuth 2.1 authentication, providing a production-ready backend for custom apps. Built on FastMCP, it delivers high performance and advanced context handling, offering deep integration with the entire Google Workspace suite.

    • 890
    • MCP
    • taylorwilsdon/google_workspace_mcp
  • @dealx/mcp-server

    @dealx/mcp-server

    MCP server enabling LLMs to search and interact with the DealX platform.

    Implements the Model Context Protocol, providing a standardized interface for large language models to interact with the DealX platform. Supports searching for ads through structured prompts and is designed for easy integration with tools like Claude and VS Code extensions. Flexible configuration options are available for environment variables, logging, and deployment. Extensible architecture supports future feature additions beyond ad search.

    • 0
    • MCP
    • DealExpress/mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results