Warp Agent MCP logo

Warp Agent MCP

by warpfreight

Quotes, compares, books, tracks, and reviews LTL, FTL, van, and box-truck freight through Warp.

Install Warp Agent MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "warpfreight-warp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "warp-agent-mcp"
      ],
      "env": {
        "WARP_API_KEY": "YOUR_VALUE_HERE",
        "WARP_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

warpfreight/warp-agent-mcp MCP server connects MCP clients to the Warp freight network for quoting, comparing, booking, tracking, and reviewing shipments. It supports LTL, FTL, cargo van, box truck, and multi-stop routes, with tools for market comparisons, batch operations, documents, invoices, and account history. Use it when an agent needs to move beyond rate lookup into authenticated booking and shipment operations. Quotes and bookings use Warp's live network; sandbox mode is not supported.

Use cases

  • Compare all freight modes for a shipment
  • Quote multiple lanes from a spreadsheet
  • Book confirmed freight quotes
  • Track shipments and retrieve delivery documents
  • Review shipping spend and lane history

Key features

  • Multi-mode freight quoting
  • 30+ carrier LTL comparisons
  • Single and batch booking
  • Shipment tracking and documents
  • Lane analytics and history
  • Recurring lane automation

Tools33

What Warp Agent MCP lets your agent do. Expand a tool for its parameters.

Verified live~11.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/18 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · warp-agent-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
npm downloads2.1kPackage downloads in the last 30 days.
Last commit10d agoMost recent push to the default branch.
Tools exposed33Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Warp Agent MCP works

What warpfreight/warp-agent-mcp MCP server does

warpfreight/warp-agent-mcp MCP server exposes Warp freight operations as MCP tools. Agents can price LTL, full truckload, cargo van, 26-foot box truck, and eligible multi-stop FTL shipments. They can also compare all four modes, compare LTL market options from more than 30 carriers, quote multiple lanes, and consolidate compatible upcoming loads.

The booking tools turn returned quote IDs or market option IDs into shipments after the user provides pickup and delivery addresses. Batch booking handles several already-quoted rows in one call. Tracking and post-booking tools cover shipment status, event timelines, invoices, documents such as BOL and POD files, saved locations, lane history, booking lists, quote history, and shipping analytics.

How it works

The server communicates with Warp's API through MCP. Quote-only calls can return prices, transit information, unavailable modes, and bookable quote IDs without creating a shipment. compare_modes is intended for questions about the best or least expensive shipping method because it evaluates LTL, FTL, van, and box truck together and explains the runner-up trade-off. LTL workflows can first call ltl_quote for a fast Warp price, then call ltl_market_options with the same inputs for carrier alternatives.

Authentication is required for booking, tracking, account history, invoices, documents, and most profile operations. The login tool can save credentials locally, while payment_status reports whether a payment method is available. Recurring lane automation requires owner approval by email; the automation tool proposes the standing order rather than booking immediately.

Setup and configuration

The warpfreight/warp-agent-mcp MCP server requires Node.js 20 or later. A local installation can run with npx -y warp-agent-mcp from an MCP client configuration. The companion CLI can create a Warp account, issue a wak_live_* token, save it in ~/.warp/config.json, and wire the server into supported clients. Manual configuration can also read the key from that file on each invocation.

WARP_API_KEY provides an environment-variable fallback when the config file is absent. A payment method must be added through Warp before chargeable bookings can proceed.

Tools and capabilities

  • Quote individual shipments or up to 50 lanes in a batch.
  • Compare modes, LTL carriers, invoice or quote amounts, and consolidation candidates.
  • Book one shipment or multiple quoted rows.
  • Quote and book multi-stop FTL routes where coverage exists.
  • Track shipments and retrieve events, invoices, and documents.
  • Read account-derived shipping context, preferences, locations, history, and analytics.
  • Propose, inspect, pause, skip, or cancel recurring lane automations.
  • Generate workflow guidance and CSV headers for intake, freight review, and invoice review.

Limitations and notes

Live freight credentials are required for quote and booking endpoints; sandbox keys currently return authorization errors, and sandbox mode is not supported. Multi-stop pricing depends on route coverage. Quote tools do not automatically fetch files, verify shipment documents, schedule work, or book unless a booking tool is called.

The MCP stores credentials locally in ~/.warp/config.json; shipment and contact data is sent to Warp and, when required, the selected carrier. Payment card details are handled server-side by Stripe rather than by the package. The server does not store data between calls or send third-party analytics. Cancellation through a self-service tool is not available; Warp support handles cancellation requests.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Warp Agent MCP

warpfreight/warp-agent-mcp is an MCP server that connects AI clients to the Warp freight network. Its main tools quote and compare LTL, FTL, cargo van, and box-truck shipments, then support authenticated booking, tracking, invoices, documents, and shipping history through Warp's API.

Install it by running `npx -y warp-agent-mcp` in your MCP client configuration, or use Warp's companion CLI to provision an account and wire the server into supported clients. Node.js 20 or later is required.

Yes, warpfreight/warp-agent-mcp works with Cursor. Add the same `npx -y warp-agent-mcp` command to Cursor's MCP configuration, or use the Warp CLI, which can auto-wire the server into Cursor.

Yes, it can book freight after a quote or market option is returned and the required pickup and delivery addresses are supplied. Booking requires authentication and a usable payment method; quote-only tools do not create shipments.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewWarp Agent MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/warpfreight-warp-agent-mcp?style=directory)](https://allmcps.com/mcp/warpfreight-warp-agent-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/warpfreight-warp-agent-mcp"><img src="https://allmcps.com/api/badge/warpfreight-warp-agent-mcp?style=directory" alt="Warp Agent MCP on AllMCPs" /></a>