TrackMage

officiel

API de suivi des expéditions et fonctionnalités de gestion logistique via l'API TrackMage

GitHub
2

Que pouvez-vous faire avec Track Mage MCP ?

  • Create a shipment for tracking — Use create_shipment to register a tracking number and optionally set a carrier and notification email.

  • Get shipment tracking checkpoints — Retrieve detailed checkpoint events for a shipment with get_shipment_checkpoints.

  • Detect a carrier from a tracking number — Use detect_carrier to find likely carriers matching a tracking number format.

  • List shipments in a workspace — Browse shipments with list_shipments, with optional pagination and workspace filtering.

  • Retrack multiple shipments at once — Re-trigger tracking for several tracking numbers in bulk using retrack_shipments.

  • Manage orders alongside shipments — Create, update, and list orders via create_order, update_order, and list_orders.

Documentation

Serveur MCP TrackMage – API de suivi d’expéditions & intégration d’API logistique

Un serveur Model Context Protocol (MCP) pour l’API de suivi d’expéditions, la surveillance de colis et la gestion logistique via l’API TrackMage. Compatible avec plus de 1600 transporteurs dans le monde.

Fonctionnalités

  • Prise en charge des transporteurs : Suivez vos colis auprès de plus de 1600 transporteurs dans le monde (liste complète)
  • Ressources : Espaces de travail, expéditions, commandes, transporteurs, statuts de suivi
  • Outils : Créer des expéditions/commandes, obtenir les points de contrôle d’une expédition, détection du transporteur
  • Authentification : OAuth avec identifiants client

⚠️ Avis de confidentialité des données

Partage de données avec votre fournisseur de LLM : Ce serveur MCP fournit des données au LLM que vous utilisez (Claude, ChatGPT, etc.). Bien qu’il s’agisse du comportement attendu pour les serveurs MCP, veuillez vous assurer que vous êtes à l’aise avec le partage de données logistiques (numéros de suivi, e-mails clients, adresses et détails d’expédition) avec le fournisseur de LLM choisi.

Bonnes pratiques :

  • Utilisez uniquement des données non sensibles ou de test si vous avez des préoccupations en matière de confidentialité
  • Vérifiez les politiques de traitement des données de votre fournisseur de LLM
  • Envisagez de vous désinscrire des programmes d’entraînement sur les données si disponibles
  • Assurez la conformité avec les politiques de données de votre organisation

Prérequis

  • Node.js v18+
  • Compte TrackMage

Obtention des identifiants

  1. Inscrivez-vous et connectez-vous à TrackMage.
  2. Allez dans Paramètres > API KEYS.
  3. Saisissez un Nom d’application (ex. : « MCP ») et une URL d’application (ex. : http://localhost:3000).
  4. Cliquez sur Generate et copiez votre Client ID et votre Client Secret.
  5. Notez votre Workspace ID depuis l’URL du tableau de bord.

Installation

Option 1 : Configuration locale

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

Modifiez .env :

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Utilisation

Lancez le serveur :

npm start

puis utilisez

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

ou via un processus fichier :

{
  "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"
      }
    }

  }
}

Ressources MCP

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

Outils MCP

Gestion des expéditions

  • create_shipment : Créer une nouvelle expédition

    • Paramètres : { trackingNumber, originCarrier?, email?, workspaceId? }
    • Retourne : L’objet expédition créé

  • update_shipment : Mettre à jour une expédition existante

    • Paramètres : { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Retourne : L’objet expédition mis à jour

  • list_shipments : Lister les expéditions d’un espace de travail

    • Paramètres : { workspaceId?, page?, itemsPerPage? }
    • Retourne : Tableau d’objets expédition

  • get_shipment_checkpoints : Obtenir les points de contrôle de suivi d’une expédition

    • Paramètres : { shipmentId }
    • Retourne : Tableau d’événements de points de contrôle de suivi

  • retrack_shipments : Relancer le suivi de plusieurs expéditions par numéros de suivi

    • Paramètres : { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Retourne : Résultats de la relance de suivi

Gestion des commandes

  • create_order : Créer une nouvelle commande

    • Paramètres : { orderNumber, email?, workspaceId? }
    • Retourne : L’objet commande créé

  • update_order : Mettre à jour une commande existante

    • Paramètres : { orderId, orderNumber?, email?, status? }
    • Retourne : L’objet commande mis à jour

  • list_orders : Lister les commandes d’un espace de travail

    • Paramètres : { workspaceId?, page?, itemsPerPage? }
    • Retourne : Tableau d’objets commande

Gestion des transporteurs

  • list_carriers : Lister les transporteurs disponibles

    • Paramètres : { page?, itemsPerPage? }
    • Retourne : Tableau d’objets transporteur avec codes et noms

  • detect_carrier : Détecter les transporteurs possibles pour un numéro de suivi

    • Paramètres : { trackingNumber }
    • Retourne : Tableau de correspondances de transporteurs possibles

Tests

npm test