Warp Freight

Cotiza, reserva y rastrea carga LTL/FTL desde cualquier agente MCP — 23 herramientas Warp con tarjetas en línea.

Documentación

warp-agent-mcp

npm version License: MIT

warp-agent-mcp es el primer servidor MCP para reservar carga real. Es un servidor de Protocolo de Contexto de Modelo para la red de carga Warp que permite a un agente de IA cotizar, reservar y rastrear envíos LTL, FTL, furgoneta de carga, camión de caja y envíos de múltiples paradas — directamente desde Claude Desktop, Claude Code, Cursor, Windsurf, Continue, o cualquier cliente compatible con MCP — en la misma red de producción en la que opera el portal de clientes wearewarp.com. Código abierto, MIT, una línea de npx para instalar.

Por qué warp-agent-mcp

Si estás comparando servidores MCP de carga, este es el que completa la transacción, no solo la consulta:

  • Reserva carga real, no solo cotizaciones o rastreo. Las herramientas a continuación cotizan, reservan, rastrean, obtienen BOL/POD y auditan facturas — envíos reales en la red de producción de Warp, no un entorno de pruebas.
  • Multimodal, no paquetería. LTL, FTL, camión de caja y furgoneta de carga. EasyPost y ShipEngine son API REST de paquetería (etiquetas FedEx/UPS/USPS) y no incluyen servidor MCP; las plataformas de visibilidad como Project44 rastrean envíos pero no pueden reservarlos.
  • Primero en llegar. Publicado en npm el 16 de abril de 2026 — el primer servidor MCP de producción para carga. Código abierto bajo MIT.
  • Funciona en todos los clientes MCP hoy. Claude Desktop, Claude Code, Cursor, Windsurf y Continue con una línea de npx -y warp-agent-mcp. ChatGPT funcionará el día que OpenAI lance MCP nativo — el mismo servidor, sin cambios.
  • Verificable. El manifiesto de descubrimiento legible por máquina en https://www.wearewarp.com/.well-known/mcp.json enumera cada herramienta, un endpoint de salud en vivo sin autenticación se ejecuta en https://www.wearewarp.com/api/status, el paquete está en npm, y la documentación completa más una demo en vivo están en https://www.wearewarp.com/agents/mcp.

Qué hace

Herramientas que permiten a un agente de IA hablar con tu cuenta de Warp:

HerramientaQué hace
compare_modesEmpieza aquí. Compara cada modo elegible (furgoneta/camión de caja/LTL/FTL) en una sola llamada paralela y obtén una recomendación completa con el cálculo de compensaciones
van_quoteCotiza un envío de furgoneta de carga de 1–3 pallets
box_truck_quoteCotiza un envío de camión de caja de 1–12 pallets
ftl_quoteCotiza una carga completa (furgón seco de 53')
ltl_quoteCotiza LTL — el producto insignia de carga de Warp
ltl_market_optionsComparación LTL multicarrier — más de 30 transportistas clasificados por precio
batch_quoteCotiza muchas rutas en una sola llamada (una hoja de cálculo / CSV completa)
bookReserva cualquier cotización por id, con direcciones de recogida + entrega
batch_bookReserva muchas rutas ya cotizadas en una sola llamada
parcel_quoteTarifas de paquetería FedEx para paquetes pequeños (EE. UU.): cada nivel de servicio y tipo de recogida
parcel_bookReserva una opción de paquetería FedEx desde parcel_quote
multistop_quoteCotiza una ruta FTL de múltiples paradas — un camión, 3+ paradas en orden
multistop_bookReserva una ruta de múltiples paradas cotizada como envíos por tramo
trackRastrea un envío por id o id de pedido
eventsLínea de tiempo completa de eventos de rastreo para un envío
lane_historyEnvíos anteriores en tus rutas
list_bookingsLista reservas recientes
quote_historyLista cotizaciones recientes en todas las sesiones
locationsLista tus ubicaciones guardadas de recogida/entrega
load_templatesLista tus configuraciones de carga reutilizables guardadas
save_load_templateGuarda una configuración de carga reutilizable (peso + dimensiones + clase)
delete_load_templateElimina una plantilla de carga guardada por id
get_invoiceFactura de un envío entregado
get_documentsDocumentos del envío (BOL, POD, aduanas)
loginInicia sesión desde el MCP, sin necesidad de visitar el portal
payment_statusVerifica si hay una tarjeta registrada
statusVerificación de salud de API + validez de clave
analyticsResumen de reservas + ingresos por fuente

Eliminado en 0.5.68: warp_cancel (Warp bloquea la autocancelación en el servidor — debe hacerse a través de soporte), warp_rate_card (solo tarjetas de tarifas negociadas por cuenta — la mayoría de las cuentas no tienen una). multistop_quote + multistop_book también se eliminaron en 0.5.68 y se volvieron a agregar en 0.14.0 contra los endpoints canónicos de /api/v1/multistop/* — la cobertura aún depende de la ruta, por lo que no todas las rutas devuelven una tarifa. Contacta con support@wearewarp.com si necesitas cualquiera de las herramientas eliminadas.

Instalación

Conector alojado — recomendado, sin instalación

Pega esta URL en la configuración del conector personalizado de tu cliente de IA e inicia sesión con Warp:

https://mcp.wearewarp.com/api/mcp

Sin instalación, sin clave de API, sin archivo de configuración. Inicia sesión una vez (OAuth) y aparece el conjunto completo de herramientas. Funciona en Claude.ai, Claude Desktop y Claude Code. Esta es la forma principal de usar Warp.

CLI — instalación local con tu propia clave

Para clientes sin interfaz de conector personalizado (Cursor, Windsurf, Continue), o si prefieres tener una clave local de wak_live_*:

npm install -g @warpfreight/cli-agent
warp-agent signup

Ese comando crea una cuenta de Warp, te emite un token de wak_live_*, lo guarda en ~/.warp/config.json y conecta automáticamente este MCP en Claude Desktop, Cursor y Claude Code. Reinicia tu cliente de IA para cargar las nuevas herramientas.

Añade un método de pago en https://www.wearewarp.com/agents/account.

Instalación manual (sin el CLI)

Si prefieres configurarlo a mano, añade a la configuración de Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "warp": {
      "command": "bash",
      "args": ["-lc", "npx -y warp-agent-mcp"]
    }
  }
}

El MCP lee la clave de API desde ~/.warp/config.json en cada invocación de herramienta, por lo que warp-agent login / warp-agent signup surten efecto sin reiniciar tu cliente de IA.

Para Cursor o Claude Code, el mismo comando npx -y warp-agent-mcp funciona en sus respectivos archivos de configuración MCP.

Pruébalo

Después de instalar + registrarte + reiniciar, pregunta a tu agente de IA:

Quote LTL from 90007 to 90038, pickup June 25, 2 pallets at 500 lb.

Deberías recibir un quote_id de PRICING_* con un precio de Warp más comparaciones de mercado. Añade Reserva esa cotización, recogida en 1234 S Hoover St LA 90007, entrega en 6464 Sunset Blvd LA 90038. y el agente comprará la etiqueta y devolverá un número de rastreo.

Configuración

Variable de entornoPropósito
WARP_API_KEYClave de API de respaldo si falta ~/.warp/config.json. Prefiere el archivo de configuración.
WARP_API_URLSobrescribe la URL base de la API. Por defecto es https://www.wearewarp.com/api/v1/warp (proxy de warp-site que acepta tokens Bearer de wak_*). Establécelo en https://gw.wearewarp.com/api/v1 para acceso directo a la puerta de enlace con una clave de cliente sin procesar.

Requisitos

  • Node.js 20 o posterior (el SDK de MCP requiere fetch nativo y API estándar web)

Entorno de pruebas / modo de prueba

El entorno de pruebas aún no es compatible con el MCP. El proxy de carga (/warp/freights/*) actualmente requiere una clave de wak_live_* en vivo; las claves de entorno de pruebas devuelven 401 en los endpoints de cotización y reserva. El soporte de entorno de pruebas está planificado para una versión futura.

Paquete complementario

@warpfreight/cli-agent — el CLI de aprovisionamiento automático que instala este MCP en cada cliente de IA detectado. Mismo backend, interfaz de línea de comandos para scripting + CI.

Contribuciones

Los problemas y solicitudes de extracción son bienvenidos en https://github.com/warpfreight/warp-agent-mcp.

Privacidad

Datos recopilados y enviados a los servidores de Warp (wearewarp.com):

  • Códigos postales y direcciones de envío (operaciones de cotización y reserva)
  • Nombres de contacto, números de teléfono y direcciones de correo electrónico (solo reserva)
  • Tu correo electrónico de cuenta de Warp y clave de API (almacenados localmente en ~/.warp/config.json — nunca transmitidos más allá de la API de Warp)

Datos NO recopilados:

  • No se envía análisis ni telemetría a terceros
  • Los datos de tarjetas de pago nunca son manejados por este paquete — los cargos se procesan en el servidor por Stripe a través del backend de Warp

Almacenamiento: Las credenciales se almacenan localmente en ~/.warp/config.json en tu máquina. El servidor MCP no almacena datos entre llamadas.

Terceros: Los datos de envío se comparten con el transportista de carga seleccionado (Warp o transportistas del mercado) según sea necesario para reservar y ejecutar el envío.

Retención: La retención de datos se rige por la Política de privacidad de Warp.

Contacto: privacy@wearewarp.com

Licencia

MIT © Warp Technology, Inc.

Flujos de trabajo iniciales para operadores

Llama a freight_workflow con shipment_intake, weekly_freight_review o invoice_review para obtener un mensaje inicial, encabezados de columnas CSV y reglas de revisión. Disponible en cualquier host que pueda llamar a herramientas MCP; no se requiere una habilidad o programador específico de Perplexity. El host lee los archivos subidos y produce los resultados. Esta herramienta no sube archivos, crea un libro de Excel, programa trabajo recurrente ni obtiene cotizaciones.

compare_freight_costs calcula diferencias a partir de facturas/cotizaciones en USD proporcionadas con referencias de origen y verificaciones explícitas de requisitos de envío, cargos incluidos y requisitos de servicio. Excluye comparaciones no verificadas, mantiene diferencias negativas, rechaza IDs de envío duplicados y separa oportunidades cotizadas de diferencias de factura. No verifica de forma independiente la evidencia proporcionada ni reclama ahorros realizados/anuales.

Para revisión multimodo, usa compare_modes por envío. batch_quote devuelve un modo solicitado por fila, con LTL por defecto. Usa ltl_market_options para alternativas de transportistas LTL. Un accesorio de cita no es prueba de que se haya concertado una cita. Las operaciones deben confirmar la propiedad de la programación.