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
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:
| Herramienta | Qué hace |
|---|---|
compare_modes | Empieza 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_quote | Cotiza un envío de furgoneta de carga de 1–3 pallets |
box_truck_quote | Cotiza un envío de camión de caja de 1–12 pallets |
ftl_quote | Cotiza una carga completa (furgón seco de 53') |
ltl_quote | Cotiza LTL — el producto insignia de carga de Warp |
ltl_market_options | Comparación LTL multicarrier — más de 30 transportistas clasificados por precio |
batch_quote | Cotiza muchas rutas en una sola llamada (una hoja de cálculo / CSV completa) |
book | Reserva cualquier cotización por id, con direcciones de recogida + entrega |
batch_book | Reserva muchas rutas ya cotizadas en una sola llamada |
parcel_quote | Tarifas de paquetería FedEx para paquetes pequeños (EE. UU.): cada nivel de servicio y tipo de recogida |
parcel_book | Reserva una opción de paquetería FedEx desde parcel_quote |
multistop_quote | Cotiza una ruta FTL de múltiples paradas — un camión, 3+ paradas en orden |
multistop_book | Reserva una ruta de múltiples paradas cotizada como envíos por tramo |
track | Rastrea un envío por id o id de pedido |
events | Línea de tiempo completa de eventos de rastreo para un envío |
lane_history | Envíos anteriores en tus rutas |
list_bookings | Lista reservas recientes |
quote_history | Lista cotizaciones recientes en todas las sesiones |
locations | Lista tus ubicaciones guardadas de recogida/entrega |
load_templates | Lista tus configuraciones de carga reutilizables guardadas |
save_load_template | Guarda una configuración de carga reutilizable (peso + dimensiones + clase) |
delete_load_template | Elimina una plantilla de carga guardada por id |
get_invoice | Factura de un envío entregado |
get_documents | Documentos del envío (BOL, POD, aduanas) |
login | Inicia sesión desde el MCP, sin necesidad de visitar el portal |
payment_status | Verifica si hay una tarjeta registrada |
status | Verificación de salud de API + validez de clave |
analytics | Resumen 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 entorno | Propósito |
|---|---|
WARP_API_KEY | Clave de API de respaldo si falta ~/.warp/config.json. Prefiere el archivo de configuración. |
WARP_API_URL | Sobrescribe 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
fetchnativo 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.