Trackmage MCP Server

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

Prerequisites

Node.js v18+
TrackMage account

Getting Credentials

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

Installation

Option 1: Local Setup

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:

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

npm test

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

Related MCP Servers

Retail Supply Chain Analysis MCP
jaydrage
-
security
F
license
-
quality
Enables users to upload retail data, analyze trends, optimize inventory, and forecast sales using AI-powered insights, acting as a senior supply chain expert.
Last updated -
JavaScript
ShipStation API MCP Server
mattcoatsworth
A
security
F
license
A
quality
A comprehensive Model Context Protocol server that enables users to interact with the ShipStation API for managing orders, shipments, carriers, warehouses, products, customers, stores, webhooks, and fulfillments through structured tools.
Last updated -
39
JavaScript
ShipHero MCP Server
mattcoatsworth
A
security
F
license
A
quality
A comprehensive server that enables interaction with the ShipHero API through the Model Context Protocol, providing tools for managing orders, products, inventory, shipping, warehouses, vendors, and webhooks.
Last updated -
29
JavaScript
Mailtrap Email Sending
railsware
A
security
A
license
A
quality
Integrates with Mailtrap Email Platform to enable sending transactional emails via API.
Last updated -
1
81
28
TypeScript
MIT License

View all related MCP servers

Trackmage MCP Server