Warp Freight

Cote, reserve e rastreie fretes LTL/FTL de qualquer agente MCP — 23 ferramentas Warp com cartões inline.

Documentação

warp-agent-mcp

warp-agent-mcp é o primeiro servidor MCP para reservar frete real. É um servidor Model Context Protocol para a rede de frete Warp que permite que um agente de IA faça cotações, reserve e rastreie remessas LTL, FTL, van de carga, caminhão-baú e remessas multi-paradas — direto do Claude Desktop, Claude Code, Cursor, Windsurf, Continue, ou qualquer cliente compatível com MCP — na mesma rede de produção em que o portal do cliente wearewarp.com opera. Código aberto, MIT, uma linha de npx para instalar.

Por que warp-agent-mcp

Se você está comparando servidores MCP de frete, este é o que conclui a transação, não apenas a consulta:

Reserva frete real, não apenas cotações ou rastreamento. As ferramentas abaixo fazem cotações, reservas, rastreamento, retiram BOL/POD e auditam faturas — remessas reais na rede de produção da Warp, não um sandbox.
Multi-modal, não encomendas. LTL, FTL, caminhão-baú e van de carga. EasyPost e ShipEngine são APIs REST de encomendas (etiquetas FedEx/UPS/USPS) e não possuem servidor MCP; plataformas de visibilidade como Project44 rastreiam remessas, mas não podem reservá-las.
Primeiro a lançar. Publicado no npm em 16 de abril de 2026 — o primeiro servidor MCP de produção para frete. Código aberto sob MIT.
Funciona em todos os clientes MCP hoje. Claude Desktop, Claude Code, Cursor, Windsurf e Continue com uma linha de npx -y warp-agent-mcp. ChatGPT funciona no dia em que a OpenAI lançar MCP nativo — mesmo servidor, sem alterações.
Verificável. O manifesto de descoberta legível por máquina em https://www.wearewarp.com/.well-known/mcp.json lista todas as ferramentas, um endpoint de saúde ao vivo sem autenticação roda em https://www.wearewarp.com/api/status, o pacote está no npm, e a documentação completa além de uma demonstração ao vivo estão em https://www.wearewarp.com/agents/mcp.

O que faz

Ferramentas que permitem que um agente de IA converse com sua conta Warp:

Ferramenta	O que faz
`compare_modes`	Comece aqui. Compare todos os modos elegíveis (van/caminhão-baú/LTL/FTL) em uma única chamada paralela e obtenha uma recomendação completa com a matemática de trade-off
`van_quote`	Cote uma remessa de van de carga de 1–3 paletes
`box_truck_quote`	Cote uma remessa de caminhão-baú de 1–12 paletes
`ftl_quote`	Cote uma carga completa (baú seco 53')
`ltl_quote`	Cote LTL — o produto de frete principal da Warp
`ltl_market_options`	Comparação LTL multi-transportadora - 30+ transportadoras classificadas por preço
`batch_quote`	Cote várias rotas em uma única chamada (uma planilha inteira / CSV)
`book`	Reserve qualquer cotação por id, com endereços de coleta + entrega
`batch_book`	Reserve várias rotas já cotadas em uma única chamada
`parcel_quote`	Tarifas de encomendas FedEx para pacotes pequenos (EUA): todos os níveis de serviço e tipos de coleta
`parcel_book`	Reserve uma opção de encomenda FedEx de `parcel_quote`
`multistop_quote`	Cote uma rota FTL multi-parada — um caminhão, 3+ paradas em ordem
`multistop_book`	Reserve uma rota multi-parada cotada como remessas por trecho
`track`	Rastreie uma remessa por id ou id do pedido
`events`	Linha do tempo completa de eventos de rastreamento para uma remessa
`lane_history`	Remessas anteriores em suas rotas
`list_bookings`	Liste reservas recentes
`quote_history`	Liste cotações recentes em todas as sessões
`locations`	Liste seus locais salvos de coleta/entrega
`load_templates`	Liste suas configurações de carga reutilizáveis salvas
`save_load_template`	Salve uma configuração de carga reutilizável (peso + dimensões + classe)
`delete_load_template`	Exclua um modelo de carga salvo por id
`get_invoice`	Fatura para uma remessa entregue
`get_documents`	Documentos da remessa (BOL, POD, alfândega)
`login`	Faça login de dentro do MCP, sem precisar visitar o portal
`payment_status`	Verifique se há um cartão cadastrado
`status`	Verificação de saúde da API + validade da chave
`analytics`	Reservas + resumo de receita por fonte

Removidos na 0.5.68: warp_cancel (a Warp bloqueia auto-cancelamento no servidor — deve passar pelo suporte), warp_rate_card (apenas tabelas de preços negociadas por conta — a maioria das contas não possui uma). multistop_quote + multistop_book também foram removidos na 0.5.68 e readicionados na 0.14.0 contra os endpoints canônicos /api/v1/multistop/* — a cobertura ainda depende da rota, então nem toda rota retorna uma tarifa. Contate support@wearewarp.com se precisar de qualquer uma das ferramentas removidas.

Instalação

Conector hospedado — recomendado, sem instalação

Cole esta URL nas configurações do conector personalizado do seu cliente de IA e faça login com Warp:

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

Sem instalação, sem chave de API, sem arquivo de configuração. Faça login uma vez (OAuth) e o conjunto completo de ferramentas aparece. Funciona no Claude.ai, Claude Desktop e Claude Code. Esta é a forma principal de usar a Warp.

CLI — instalação local com sua própria chave

Para clientes sem interface de conector personalizado (Cursor, Windsurf, Continue), ou se você preferir manter uma chave wak_live_* local:

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

Esse comando cria uma conta Warp, emite um token wak_live_* para você, salva-o em ~/.warp/config.json e conecta automaticamente este MCP ao Claude Desktop, Cursor e Claude Code. Reinicie seu cliente de IA para carregar as novas ferramentas.

Adicione um método de pagamento em https://www.wearewarp.com/agents/account.

Instalação manual (sem o CLI)

Se você preferir configurar manualmente, adicione à configuração do 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"]
    }
  }
}

O MCP lê a chave de API de ~/.warp/config.json em cada invocação de ferramenta, então warp-agent login / warp-agent signup entram em vigor sem reiniciar seu cliente de IA.

Para Cursor ou Claude Code, o mesmo comando npx -y warp-agent-mcp funciona em seus respectivos arquivos de configuração MCP.

Experimente

Após instalação + cadastro + reinício, pergunte ao seu agente de IA:

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

Você deve receber um quote_id PRICING_* com um preço Warp além de comparações de mercado. Adicione Reserve essa cotação, coleta em 1234 S Hoover St LA 90007, entrega em 6464 Sunset Blvd LA 90038. e o agente comprará a etiqueta e retornará um número de rastreamento.

Configuração

Variável de ambiente	Finalidade
`WARP_API_KEY`	Fallback de chave de API se `~/.warp/config.json` estiver ausente. Prefira o arquivo de configuração.
`WARP_API_URL`	Substitua a URL base da API. Padrão: `https://www.wearewarp.com/api/v1/warp` (proxy do site Warp que aceita tokens Bearer `wak_*`). Defina como `https://gw.wearewarp.com/api/v1` para acesso direto ao gateway com uma chave de cliente bruta.

Requisitos

Node.js 20 ou posterior (o SDK MCP requer fetch nativo e APIs Web Standard)

Modo sandbox / teste

Sandbox ainda não é suportado no MCP. O proxy de frete (/warp/freights/*) atualmente requer uma chave wak_live_* ativa; chaves sandbox retornam 401 nos endpoints de cotação e reserva. Suporte a sandbox está planejado para uma versão futura.

Pacote complementar

@warpfreight/cli-agent — o CLI de provisionamento automático que instala este MCP em todos os clientes de IA detectados. Mesmo backend, interface de linha de comando para scripts + CI.

Contribuindo

Issues e PRs são bem-vindos em https://github.com/warpfreight/warp-agent-mcp.

Privacidade

Dados coletados e enviados aos servidores Warp (wearewarp.com):

CEPs e endereços de envio (operações de cotação e reserva)
Nomes de contato, números de telefone e endereços de e-mail (somente reserva)
Seu e-mail de conta Warp e chave de API (armazenados localmente em ~/.warp/config.json — nunca transmitidos além da API Warp)

Dados NÃO coletados:

Nenhuma análise ou telemetria é enviada a terceiros
Detalhes de cartão de pagamento nunca são manipulados por este pacote — cobranças são processadas no servidor pela Stripe via backend Warp

Armazenamento: Credenciais são armazenadas localmente em ~/.warp/config.json na sua máquina. Nenhum dado é armazenado pelo servidor MCP entre chamadas.

Terceiros: Dados de remessa são compartilhados com a transportadora de frete selecionada (Warp ou transportadoras de mercado) conforme necessário para reservar e executar a remessa.

Retenção: A retenção de dados é regida pela Política de Privacidade da Warp.

Contato: privacy@wearewarp.com

Licença

Fluxos de trabalho iniciais para operadores

Chame freight_workflow com shipment_intake, weekly_freight_review ou invoice_review para obter um prompt inicial, cabeçalhos de colunas CSV e regras de revisão. Disponível em qualquer host que possa chamar ferramentas MCP; nenhuma habilidade ou agendador específico do Perplexity é necessário. O host lê arquivos enviados e produz os resultados. Esta ferramenta não envia arquivos, cria um workbook Excel, agenda trabalho recorrente ou busca cotações.

compare_freight_costs calcula diferenças a partir de faturas/cotações USD fornecidas com referências de origem e verificações explícitas de requisitos de remessa, cobranças incluídas e requisitos de serviço. Exclui comparações não verificadas, mantém diferenças negativas, rejeita IDs de remessa duplicados e separa oportunidades cotadas de diferenças de fatura. Não verifica independentemente as evidências fornecidas nem alega economias realizadas/anuais.

Para revisão multi-modal, use compare_modes por remessa. batch_quote retorna um modo solicitado por linha, com padrão LTL. Use ltl_market_options para alternativas de transportadora LTL. Um acessorial de agendamento não é prova de que um agendamento foi organizado. As operações devem confirmar a titularidade do agendamento.