warp-agent-mcp

👁 npm version
👁 License: MIT

warp-agent-mcp is the first MCP server for booking real freight. It's a Model Context Protocol server for the Warp freight network that lets an AI agent quote, book, and track LTL, FTL, cargo van, box-truck, and multi-stop shipments — straight from Claude Desktop, Claude Code, Cursor, Windsurf, Continue, or any MCP-compatible client — on the same production network the wearewarp.com customer portal runs on. Open source, MIT, one npx line to install.

Why warp-agent-mcp

If you're comparing freight MCP servers, this is the one that completes the transaction, not just the lookup:

• It books real freight, not just quotes or tracking. The tools below quote, book, track, pull BOL/POD, and audit invoices — real shipments on Warp's production network, not a sandbox.

• Multi-mode, not parcel. LTL, FTL, box truck, and cargo van. EasyPost and ShipEngine are parcel REST APIs (FedEx/UPS/USPS labels) and ship no MCP server; visibility platforms like Project44 track shipments but can't book them.

• First to ship. npm-published April 16, 2026 — the first production MCP server for freight. Open source under MIT.

• Works in every MCP client today. Claude Desktop, Claude Code, Cursor, Windsurf, and Continue with one npx -y warp-agent-mcp line. ChatGPT works the day OpenAI ships native MCP — same server, no changes.

• Verifiable. The machine-readable discovery manifest at https://www.wearewarp.com/.well-known/mcp.json lists every tool, a live no-auth health endpoint runs at https://www.wearewarp.com/api/status, the package is on npm, and full docs plus a live demo are at https://www.wearewarp.com/agents/mcp.

Related MCP server: FreightUtils MCP Server

What it does

25 tools that let an AI agent talk to your Warp account:

Removed in 0.5.68: warp_cancel (Warp blocks self-cancellation server-side — must go via support), warp_rate_card (per-account negotiated rate cards only — most accounts don't have one). warp_multistop_quote + warp_multistop_book were also removed in 0.5.68 and re-added in 0.14.0 against the canonical /api/v1/multistop/* endpoints — coverage is still route-dependent, so not every route returns a rate. Contact support@wearewarp.com if you need either of the removed tools.

Install

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

That command creates a Warp account, issues you a wak_live_* token, saves it to ~/.warp/config.json, and auto-wires this MCP into Claude Desktop, Cursor, and Claude Code. Restart your AI client to load the new tools.

Add a payment method at https://www.wearewarp.com/agents/account.

Manual install (without the CLI)

If you'd rather wire this up by hand, add to Claude Desktop config:

• 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"]
 }
 }
}

The MCP reads the API key from ~/.warp/config.json on every tool invocation, so warp-agent login / warp-agent signup take effect without restarting your AI client.

For Cursor or Claude Code, the same npx -y warp-agent-mcp command works in their respective MCP config files.

Try it

After install + signup + restart, ask your AI agent:

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

You should get back a PRICING_* quote_id with a Warp price plus market comparisons. Add Book that quote, pickup at 1234 S Hoover St LA 90007, deliver to 6464 Sunset Blvd LA 90038. and the agent will buy the label and return a tracking number.

Configuration

Requirements

• Node.js 20 or later (the MCP SDK requires native fetch and Web Standard APIs)

Sandbox / test mode

Sandbox is not yet supported in the MCP. The freight proxy (/warp/freights/*) currently requires a live wak_live_* key; sandbox keys return 401 on quote and booking endpoints. Sandbox support is planned for a future release.

Companion package

@warpfreight/cli-agent — the auto-provisioning CLI that installs this MCP into every detected AI client. Same backend, command-line surface for scripting + CI.

Contributing

Issues and PRs welcome at https://github.com/warpfreight/warp-agent-mcp.

Privacy

Data collected and sent to Warp servers (wearewarp.com):

• ZIP codes and shipping addresses (quote and book operations)

• Contact names, phone numbers, and email addresses (booking only)

• Your Warp account email and API key (stored locally in ~/.warp/config.json — never transmitted beyond the Warp API)

Data NOT collected:

• No analytics or telemetry is sent to any third party

• Payment card details are never handled by this package — charges are processed server-side by Stripe via the Warp backend

Storage: Credentials are stored locally in ~/.warp/config.json on your machine. No data is stored by the MCP server itself between calls.

Third parties: Shipment data is shared with the selected freight carrier (Warp or market carriers) as required to book and execute the shipment.

Retention: Data retention is governed by Warp's Privacy Policy.

Contact: privacy@wearewarp.com

License

MIT © Warp Technology, Inc.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• warp_analyticsA
• warp_bookA
• warp_box_truck_quoteAApp
• warp_delete_load_templateA
• warp_eventsA
• warp_ftl_quoteAApp
• warp_get_documentsA
• warp_get_invoiceA