TrackMage

You set up and run an MCP server that sits between your applications and the TrackMage shipment tracking ecosystem. This server exposes resources for workspaces, shipments, orders, carriers, and tracking statuses, and it includes tools to create and manage shipments and orders, detect carriers, and fetch tracking checkpoints. It can connect over HTTP to a local or remote MCP endpoint and can also run as a local stdio process for direct integration.

How to use

You will run the MCP server locally or remotely and connect to it from your MCP client. Start the server using the standard command, then configure your client to reach the server through HTTP or by launching the local process. Use the tracked endpoints to create and manage shipments, orders, and carriers, and to retrieve shipment checkpoints and tracking statuses. If you start the local process, ensure your environment variables provide the required credentials so your client can authenticate with TrackMage.

Typical use cases include creating a shipment and checking its checkpoints, listing all shipments in a workspace, detecting the most likely carrier for a given tracking number, and retracking multiple shipments. Access to these features is governed by your OAuth credentials, so keep your Client ID and Client Secret secure.

How to install

Prerequisites you need before installing:

• Node.js v18+

• TrackMage account

Step by step 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

Additional configuration and startup options

Configure the server to expose an HTTP transport or run as a local stdio process. Use the provided configuration examples to connect your MCP client.

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

Security and credentials

Keep your TrackMage Client ID, Client Secret, and Workspace ID secure. These credentials are required for OAuth authentication and to access workspace-scoped data.

Available tools

create_shipment

Create a new shipment with details such as tracking number and origin carrier, returning the created shipment object.

update_shipment

Update an existing shipment by ID with new tracking numbers, origin carrier, email, or status, returning the updated object.

list_shipments

List shipments within a workspace with optional paging parameters, returning an array of shipment objects.

get_shipment_checkpoints

Fetch the tracking checkpoint events for a specific shipment by ID.

retrack_shipments

Retrack multiple shipments by providing tracking numbers and optional workspace context, returning retracking results.

create_order

Create a new order with an order number and optional email and workspace context, returning the created order object.

update_order

Update an existing order by ID with new order number, email, or status, returning the updated object.

list_orders

List orders within a workspace with paging options, returning an array of order objects.

list_carriers

List available carriers with codes and names, supporting paging.

detect_carrier

Detect possible carriers for a given tracking number and return potential matches.