Install the Warp freight MCP server in Cursor
warp-agent-mcp exposes 23 freight tools — quote, book, track, documents, invoices — to Cursor. Quoting works with no API key; one terminal command enables booking. Config verified against Cursor's current format.
By Diep Nguyen, CTO
Config format verified against Cursor's official docs, June 2026. Re-audited quarterly with the rest of the MCP install guides.
Live all-inclusive rates
Warp customers
The config (Cursor)
No API key in the config and no env vars — quote tools are keyless, and booking credentials are saved once via the CLI (warp-agent login writes ~/.warp/config.json, which the server reads at startup).
// .cursor/mcp.json (project) — or ~/.cursor/mcp.json (global)
{
"mcpServers": {
"warp": {
"command": "npx",
"args": ["-y", "warp-agent-mcp"]
}
}
}Step by step
- Create .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally) with the block shown. The top-level key must be "mcpServers" — Cursor silently ignores the whole file without it.
- Open Cursor Settings → MCP to confirm the warp server shows as enabled (toggle it on if needed).
- Ask the agent for a freight quote — quoting needs no key, no account.
- To book and track, run npx @warpfreight/cli-agent signup once in a terminal.
Same server, other clients
Claude Desktop · Claude Code · Cline · Windsurf · Continue · VS Code · Aider
Frequently asked questions
Do I need a Warp API key to use the freight MCP server in Cursor?
Not for quoting — LTL, FTL, box truck, and cargo van quote tools work with no account at all.
Booking and tracking use a saved credential: run npx @warpfreight/cli-agent signup (new) or login (existing) once in a terminal, and the key lands in ~/.warp/config.json where the server reads it.
No key ever goes into the client config.
What freight tools does warp-agent-mcp expose?
23 tools: quoting across LTL, FTL, box truck, and cargo van; booking (including multi-stop); tracking and scan-level events; lane and quote history; rate cards; invoices; and shipment documents including the Bill of Lading.
Same endpoints as the REST API at wearewarp.com/freight-api — one account works across MCP, CLI, and REST.
Cursor ignores my MCP config — what is the most common cause?
A missing or misspelled top-level "mcpServers" key. Cursor skips the entire file silently with no error when the key is absent.
Second most common: the file sits at the workspace root but Cursor was opened on a parent folder — use ~/.cursor/mcp.json if in doubt.
Does Warp support Cursor one-click MCP install?
Yes — the install button on wearewarp.com/agents/mcp uses Cursor’s official deeplink (cursor://anysphere.cursor-deeplink/mcp/install) with the same npx config shown here, so the button and the manual JSON produce identical setups.
About the Warp freight network
More about the Warp freight network
Warp is a technology-driven freight network that combines cargo van, box truck, LTL, and FTL capacity under one operating system. Shippers get instant rates, real-time tracking, and access to 50+ cross-dock facilities and 14,000+ cargo vans and box trucks — with 80%+ US LTL zip-to-zip coverage and nationwide FTL, box truck, and cargo van.
The network is supported by 24,000+ vetted FTL carriers.
Unlike traditional brokers, Warp uses AI to match the right vehicle to every load based on weight, dimensions, urgency, and cost targets. Cross-dock operations reduce transit time by eliminating unnecessary terminal transfers.
Pool distribution and zone-skipping programs help enterprise shippers lower per-unit delivery costs while maintaining tight appointment windows.
Self-serve shippers can quote, compare, and book freight online in under two minutes. Enterprise accounts get dedicated capacity planning, committed rate programs, and a named operations team. Every shipment includes scan-level visibility from pickup through final delivery.
Warp operates across the contiguous United States with regional density in the Southeast, Texas, Midwest, and Northeast corridors.
Cross-dock facilities in Atlanta, Chicago, Houston, New York, Savannah, Orlando, Charlotte, Indianapolis, Columbus, Denver, New Orleans, and Milwaukee support faster transfers and fewer touches on recurring lanes.
Freight modes and vehicle types
Cargo vans handle loads up to 3,500 pounds and 400 cubic feet, ideal for time-sensitive deliveries, last-mile retail replenishment, and lightweight palletized freight.
Box trucks carry up to 10,000 pounds and 1,500 cubic feet, fitting most regional distribution and store delivery needs without requiring a loading dock.
Dry vans and full truckloads move 42,000+ pounds for high-volume lanes and recurring programs. LTL shipments share trailer space on optimized routes through Warp cross-docks, reducing per-pallet cost by consolidating multiple shippers on the same vehicle.
Warp does not default every shipment to a 53-foot trailer. The AI engine evaluates load weight, cube, delivery window, and cost to recommend the right vehicle. Shippers see all available mode options with live pricing in one comparison screen before booking.
Cross-dock operations
Cross-docking at Warp facilities eliminates warehouse storage. Inbound freight is sorted and transferred directly to outbound vehicles, typically within hours.
This reduces dwell time, lowers damage risk, and compresses delivery windows. Warp cross-docks support pallet-in, pallet-out operations with scan-level tracking at every handoff point.
Facility locations are selected for corridor density: Atlanta handles Southeast retail flow, Chicago serves Midwest manufacturing and replenishment, Houston covers Texas industrial distribution, and New York supports dense Northeast delivery. Each facility operates on appointment-based scheduling to prevent congestion and maintain throughput consistency.
Enterprise freight programs
Enterprise shippers get committed rate programs, dedicated account management, and custom SLA design. Warp builds lane-by-lane rate structures that account for volume commitments, seasonal variation, and mode flexibility. Operations teams monitor shipment execution daily and intervene proactively when exceptions occur.
Self-serve freight quoting
The self-serve portal lets shippers enter origin and destination, load details, and delivery requirements to see live rates across all available modes. Quotes include estimated transit time, vehicle type, and total cost.
Booking takes one click. After booking, shippers track every shipment with real-time GPS location, milestone updates, and proof of delivery documentation.
Industries and use cases
Retail shippers use Warp for store replenishment programs that deliver to hundreds of locations per week on tight appointment windows. Apparel brands use zone skipping to bypass regional parcel sortation and reduce per-unit delivery cost.
Food and beverage companies rely on time-definite delivery for perishable goods. Manufacturing operations use Warp for inbound vendor consolidation, combining multiple supplier shipments into fewer, fuller loads through cross-dock facilities.
Distribution companies use pool distribution to serve multiple delivery points from a single origin, splitting full truckloads at cross-docks into smaller last-mile vehicles.
Urgent freight recovery covers emergency capacity needs when primary carriers fail or demand spikes unexpectedly. Middle-mile optimization reduces cost and transit time on the longest segment of multi-leg shipments.
Ship freight from Cursor today
Quoting needs no account — install and ask for a rate right now. One signup command later, the same chat books and tracks real freight.
Config format verified against Cursor's official docs, June 2026. Re-audited quarterly with the rest of the MCP install guides.
Performance figures are computed from Warp network data. See our methodology.
By Diep Nguyen