warp-agent-mcp

Model Context Protocol (MCP) server for the Warp freight API. Quote, book, and track LTL, FTL, cargo van, box-truck, and multi-stop shipments from Claude Desktop, Cursor, Claude Code, or any MCP-compatible AI agent.

What it does

16 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 (multi-stop FTL coverage is sparse). Contact support@wearewarp.com if you need any of these.

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.