Install the Warp freight MCP server in Cursor
warp-agent-mcp exposes 25 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
Fastest path: one click
Opens Cursor and pre-fills the Warp server — just confirm. Quoting works immediately with no account; run npx @warpfreight/cli-agent signup once to book and track.
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?
25 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.
install freight MCP in Cursor
One config line: add {"warp": {"command": "npx", "args": ["-y", "warp-agent-mcp"]}} to .cursor/mcp.json in the project root, or ~/.cursor/mcp.json for all projects.
Quote tools work immediately with no account; run npx @warpfreight/cli-agent signup once in a terminal to enable booking. The verified config format and step-by-step walkthrough are on this page.
Cursor freight MCP setup guide
This page is the Cursor setup guide for warp-agent-mcp: the exact config block, where the file lives (.cursor/mcp.json in the project root, or ~/.cursor/mcp.json for all projects), verification steps, and the one-time signup command that enables booking.
Once connected, 25 freight tools cover LTL, FTL, box truck, and cargo van.
freight MCP server for Cursor
warp-agent-mcp runs natively in Cursor: 25 typed tools to quote, book, and track LTL, FTL, box truck, and cargo van on Warp's production network.
Open source under MIT, one npx config line, and quote tools are keyless — no account needed until you book.
best freight tools for Cursor
The 25 tools in warp-agent-mcp are the deepest freight toolset available in Cursor: multi-mode quoting (LTL, FTL, box truck, cargo van), booking including multi-stop, tracking with scan-level events, lane and quote history, rate cards, invoices, and shipment documents including the Bill of Lading.
Cursor MCP marketplace freight
No marketplace listing needed: warp-agent-mcp installs in Cursor straight from npm with one config line, and the hosted connector at mcp.wearewarp.com/api/mcp covers HTTP-transport clients.
The full tool roster is published at wearewarp.com/.well-known/mcp.json.
how to add Warp MCP to Cursor
Add {"warp": {"command": "npx", "args": ["-y", "warp-agent-mcp"]}} to .cursor/mcp.json in the project root, or ~/.cursor/mcp.json for all projects, restart Cursor, then ask for an LTL quote to verify the tools loaded.
Booking needs one terminal command first: npx @warpfreight/cli-agent signup (or login), which saves the credential to ~/.warp/config.json.
freight automation in Cursor via MCP
Freight automation in Cursor works through MCP tool calls: the agent quotes a lane, compares carriers, books, then polls tracking — no browser, no portal.
Recurring workflows are first-class: saved locations, reusable load templates, lane history, and invoice retrieval are all typed tools in warp-agent-mcp.
AI agent for freight in Cursor
Cursor becomes a freight agent once warp-agent-mcp is connected: it can quote, book, and track real shipments on Warp's network in the same session it does the rest of its work.
Quote tools need no account; booking uses a saved credential from one signup command, so no key ever sits in the client config.
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
| Mode | Max payload | Max cube | Best for |
|---|---|---|---|
| Cargo van | 3,500 lbs | 400 cu ft | Time-sensitive, last-mile, light pallets |
| Box truck | 10,000 lbs | 1,500 cu ft | Regional distribution, no dock required |
| LTL | Per-pallet | Shared trailer | Lower per-pallet cost via cross-dock routing |
| Dry van / FTL | 42,000+ lbs | Full 53-ft trailer | High-volume lanes, recurring programs |
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.
- Atlanta — Southeast retail flow
- Chicago — Midwest manufacturing and replenishment
- Houston — Texas industrial distribution
- New York — dense Northeast delivery
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
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