TrackMage

oficial

API de seguimiento de envíos y capacidades de gestión logística a través de la API de TrackMage

GitHub
2

¿Qué puedes hacer con TrackMage MCP?

  • Crear un envío para seguimiento — Usa create_shipment para registrar un número de seguimiento y, opcionalmente, establecer un transportista y un correo electrónico de notificación.

  • Obtener puntos de control de seguimiento de un envío — Recupera eventos de punto de control detallados de un envío con get_shipment_checkpoints.

  • Detectar un transportista a partir de un número de seguimiento — Usa detect_carrier para encontrar transportistas probables que coincidan con el formato de un número de seguimiento.

  • Listar envíos en un espacio de trabajo — Navega por los envíos con list_shipments, con paginación opcional y filtrado por espacio de trabajo.

  • Volver a rastrear múltiples envíos a la vez — Reactiva el seguimiento de varios números de seguimiento en lote usando retrack_shipments.

  • Gestionar pedidos junto con envíos — Crea, actualiza y lista pedidos mediante create_order, update_order y list_orders.

Documentación

Servidor MCP TrackMage - API de Seguimiento de Envíos e Integración con API de Logística

Un servidor del Protocolo de Contexto de Modelo (MCP) para API de seguimiento de envíos, monitoreo de paquetes y gestión logística utilizando la API de TrackMage. Compatible con seguimiento en más de 1600 transportistas a nivel mundial.

Características

  • Soporte de Transportistas: Realiza seguimiento de paquetes en más de 1600 transportistas a nivel mundial (lista completa)
  • Recursos: Espacios de trabajo, envíos, pedidos, transportistas, estados de seguimiento
  • Herramientas: Crear envíos/pedidos, obtener puntos de control de envíos, detección de transportistas
  • Autenticación: OAuth con credenciales de cliente

⚠️ Aviso de Privacidad de Datos

Compartición de datos con tu proveedor de LLM: Este servidor MCP proporciona datos a cualquier LLM que estés utilizando (Claude, ChatGPT, etc.). Si bien este es el comportamiento esperado para los servidores MCP, por favor asegúrate de sentirte cómodo compartiendo datos logísticos, incluidos números de seguimiento, correos electrónicos de clientes, direcciones y detalles de envíos, con el proveedor de LLM que hayas elegido.

Mejores prácticas:

  • Utiliza solo con datos no sensibles o de prueba si tienes preocupaciones de privacidad
  • Revisa las políticas de manejo de datos de tu proveedor de LLM
  • Considera optar por no participar en programas de datos de entrenamiento si están disponibles
  • Asegura el cumplimiento con las políticas de datos de tu organización

Requisitos Previos

  • Node.js v18+
  • Cuenta de TrackMage

Obtención de Credenciales

  1. Regístrate e inicia sesión en TrackMage.
  2. Ve a Configuración > API KEYS.
  3. Ingresa un Nombre de App (ej., "MCP") y una URL de App (ej., http://localhost:3000).
  4. Haz clic en Generar y copia tu Client ID y Client Secret.
  5. Anota tu Workspace ID desde la URL del panel de control.

Instalación

Opción 1: Configuración Local

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

Configuración

Edita .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Uso

Ejecuta el servidor:

npm start

y luego usa

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

o usando el proceso de archivo:

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

  }
}

Recursos MCP

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

Herramientas MCP

Gestión de Envíos

  • create_shipment: Crear un nuevo envío

    • Parámetros: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Retorna: Objeto de envío creado

  • update_shipment: Actualizar un envío existente

    • Parámetros: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Retorna: Objeto de envío actualizado

  • list_shipments: Listar envíos del espacio de trabajo

    • Parámetros: { workspaceId?, page?, itemsPerPage? }
    • Retorna: Arreglo de objetos de envío

  • get_shipment_checkpoints: Obtener puntos de control de seguimiento para un envío

    • Parámetros: { shipmentId }
    • Retorna: Arreglo de eventos de puntos de control de seguimiento

  • retrack_shipments: Re-ejecutar seguimiento de múltiples envíos por números de seguimiento

    • Parámetros: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Retorna: Resultados del re-seguimiento

Gestión de Pedidos

  • create_order: Crear un nuevo pedido

    • Parámetros: { orderNumber, email?, workspaceId? }
    • Retorna: Objeto de pedido creado

  • update_order: Actualizar un pedido existente

    • Parámetros: { orderId, orderNumber?, email?, status? }
    • Retorna: Objeto de pedido actualizado

  • list_orders: Listar pedidos del espacio de trabajo

    • Parámetros: { workspaceId?, page?, itemsPerPage? }
    • Retorna: Arreglo de objetos de pedido

Gestión de Transportistas

  • list_carriers: Listar transportistas disponibles

    • Parámetros: { page?, itemsPerPage? }
    • Retorna: Arreglo de objetos de transportista con códigos y nombres

  • detect_carrier: Detectar posibles transportistas para un número de seguimiento

    • Parámetros: { trackingNumber }
    • Retorna: Arreglo de posibles coincidencias de transportistas

Pruebas

npm test