Model Context Protocol (MCP) server for TrackMage API integration, with support for 1600+ carriers worldwide. Enables AI assistants to track shipments, manage logistics, create orders, and monitor package delivery statuses. Features OAuth authentication, carrier detection, and real-time tracking updates.
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.
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:
http://localhost:3000
).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
Edit .env
:
TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here
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"
}
}
}
}
trackmage:///workspaces/{id}
trackmage:///shipments/{id}
trackmage:///orders/{id}
trackmage:///carriers/{id}
trackmage:///tracking_statuses/{id}
create_shipment
: Create a new shipment
{ trackingNumber, originCarrier?, email?, workspaceId? }
update_shipment
: Update an existing shipment
{ shipmentId, trackingNumber?, originCarrier?, email?, status? }
list_shipments
: List shipments from workspace
{ workspaceId?, page?, itemsPerPage? }
get_shipment_checkpoints
: Get tracking checkpoints for a shipment
{ shipmentId }
retrack_shipments
: Retrack multiple shipments by tracking numbers
{ trackingNumbers: [{ number, originCarrier? }], workspaceId? }
create_order
: Create a new order
{ orderNumber, email?, workspaceId? }
update_order
: Update an existing order
{ orderId, orderNumber?, email?, status? }
list_orders
: List orders from workspace
{ workspaceId?, page?, itemsPerPage? }
list_carriers
: List available carriers
{ page?, itemsPerPage? }
detect_carrier
: Detect possible carriers for a tracking number
{ trackingNumber }
npm test
A Model Context Protocol (MCP) server implementation for Gumroad API
GraphQL MCP server for AI assistants
Official MCP Server for AIStor
This MCP server exposes the WeatherXM PRO APIs as MCP tools, allowing clients to access weather station data, observations, and forecasts through the MCP protocol.