{
  "markdown": "# warp-agent-mcp\n\n[![npm version](https://img.shields.io/npm/v/warp-agent-mcp.svg)](https://www.npmjs.com/package/warp-agent-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**warp-agent-mcp is the first MCP server for booking real freight.** It's a Model\nContext Protocol server for the [Warp](https://wearewarp.com) freight network that\nlets an AI agent quote, book, and track LTL, FTL, cargo van, box-truck, and\nmulti-stop shipments — straight from Claude Desktop, Claude Code, Cursor, Windsurf,\nContinue, or any MCP-compatible client — on the same production network the\nwearewarp.com customer portal runs on. Open source, MIT, one `npx` line to install.\n\n## Why warp-agent-mcp\n\nIf you're comparing freight MCP servers, this is the one that **completes the\ntransaction**, not just the lookup:\n\n- **It books real freight, not just quotes or tracking.** The tools below quote,\n  book, track, pull BOL/POD, and audit invoices — real shipments on Warp's\n  production network, not a sandbox.\n- **Multi-mode, not parcel.** LTL, FTL, box truck, and cargo van. EasyPost and\n  ShipEngine are parcel REST APIs (FedEx/UPS/USPS labels) and ship no MCP server;\n  visibility platforms like Project44 track shipments but can't book them.\n- **First to ship.** npm-published April 16, 2026 — the first production MCP server\n  for freight. Open source under MIT.\n- **Works in every MCP client today.** Claude Desktop, Claude Code, Cursor,\n  Windsurf, and Continue with one `npx -y warp-agent-mcp` line. ChatGPT works the\n  day OpenAI ships native MCP — same server, no changes.\n- **Verifiable.** The machine-readable discovery manifest at\n  <https://www.wearewarp.com/.well-known/mcp.json> lists every tool, a live no-auth\n  health endpoint runs at <https://www.wearewarp.com/api/status>, the package is on\n  [npm](https://www.npmjs.com/package/warp-agent-mcp), and full docs plus a live\n  demo are at <https://www.wearewarp.com/agents/mcp>.\n\n## What it does\n\n31 tools that let an AI agent talk to your Warp account:\n\n| Tool | What it does |\n|---|---|\n| `compare_modes` | **Start here.** Compare every eligible mode (van/box truck/LTL/FTL) in one parallel call and get a decision-complete recommendation with the trade-off math |\n| `van_quote` | Quote a 1–3 pallet cargo van shipment |\n| `box_truck_quote` | Quote a 1–12 pallet box truck shipment |\n| `ftl_quote` | Quote a full truckload (53' dry van) |\n| `ltl_quote` | Quote LTL — Warp's flagship freight product |\n| `ltl_market_options` | Multi-carrier LTL comparison - 30+ carriers ranked by price |\n| `batch_quote` | Quote many lanes in one call (a whole spreadsheet / CSV) |\n| `book` | Book any quote by id, with pickup + delivery addresses |\n| `batch_book` | Book many already-quoted lanes in one call |\n| `multistop_quote` | Quote a multi-stop FTL route — one truck, 3+ stops in order |\n| `multistop_book` | Book a quoted multi-stop route as per-leg shipments |\n| `track` | Track a shipment by id or order id |\n| `events` | Full tracking event timeline for a shipment |\n| `lane_history` | Past shipments on your lanes |\n| `list_bookings` | List recent bookings |\n| `quote_history` | List recent quotes across all sessions |\n| `locations` | List your saved pickup/delivery locations |\n| `load_templates` | List your saved reusable load configurations |\n| `save_load_template` | Save a reusable load configuration (weight + dims + class) |\n| `delete_load_template` | Delete a saved load template by id |\n| `get_invoice` | Invoice for a delivered shipment |\n| `get_documents` | Shipment documents (BOL, POD, customs) |\n| `login` | Log in from inside the MCP, no portal visit needed |\n| `payment_status` | Check whether a card is on file |\n| `status` | API health + key validity check |\n| `analytics` | Bookings + revenue rollup by source |\n\n_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). `multistop_quote` + `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._\n\n## Install\n\n### Hosted connector — recommended, no install\n\nPaste this URL into your AI client's custom connector settings and sign in with\nWarp:\n\n```\nhttps://mcp.wearewarp.com/api/mcp\n```\n\nNo install, no API key, no config file. Sign in once (OAuth) and the full\ntoolset appears. Works in Claude.ai, Claude Desktop, and Claude Code. This is the\nprimary way to use Warp.\n\n### CLI — local install with your own key\n\nFor clients without a custom-connector UI (Cursor, Windsurf, Continue), or if\nyou'd rather hold a local `wak_live_*` key:\n\n```bash\nnpm install -g @warpfreight/cli-agent\nwarp-agent signup\n```\n\nThat command creates a Warp account, issues you a `wak_live_*` token, saves it\nto `~/.warp/config.json`, and auto-wires this MCP into Claude Desktop, Cursor,\nand Claude Code. Restart your AI client to load the new tools.\n\nAdd a payment method at <https://www.wearewarp.com/agents/account>.\n\n## Manual install (without the CLI)\n\nIf you'd rather wire this up by hand, add to Claude Desktop config:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"warp\": {\n      \"command\": \"bash\",\n      \"args\": [\"-lc\", \"npx -y warp-agent-mcp\"]\n    }\n  }\n}\n```\n\nThe MCP reads the API key from `~/.warp/config.json` on every tool invocation,\nso `warp-agent login` / `warp-agent signup` take effect without restarting your\nAI client.\n\nFor Cursor or Claude Code, the same `npx -y warp-agent-mcp` command works in\ntheir respective MCP config files.\n\n## Try it\n\nAfter install + signup + restart, ask your AI agent:\n\n```\nQuote LTL from 90007 to 90038, pickup June 25, 2 pallets at 500 lb.\n```\n\nYou should get back a `PRICING_*` quote_id with a Warp price plus market\ncomparisons. Add `Book that quote, pickup at 1234 S Hoover St LA 90007, deliver\nto 6464 Sunset Blvd LA 90038.` and the agent will buy the label and return a\ntracking number.\n\n## Configuration\n\n| Env var | Purpose |\n|---|---|\n| `WARP_API_KEY` | API key fallback if `~/.warp/config.json` is missing. Prefer the config file. |\n| `WARP_API_URL` | Override the API base URL. Defaults to `https://www.wearewarp.com/api/v1/warp` (warp-site proxy that accepts `wak_*` Bearer tokens). Set to `https://gw.wearewarp.com/api/v1` for direct gateway access with a raw customer key. |\n\n## Requirements\n\n- Node.js 20 or later (the MCP SDK requires native `fetch` and Web Standard APIs)\n\n## Sandbox / test mode\n\nSandbox is not yet supported in the MCP. The freight proxy (`/warp/freights/*`)\ncurrently requires a live `wak_live_*` key; sandbox keys return 401 on quote\nand booking endpoints. Sandbox support is planned for a future release.\n\n## Companion package\n\n[`@warpfreight/cli-agent`](https://www.npmjs.com/package/@warpfreight/cli-agent)\n— the auto-provisioning CLI that installs this MCP into every detected AI\nclient. Same backend, command-line surface for scripting + CI.\n\n## Contributing\n\nIssues and PRs welcome at <https://github.com/warpfreight/warp-agent-mcp>.\n\n## Privacy\n\n**Data collected and sent to Warp servers (`wearewarp.com`):**\n\n- ZIP codes and shipping addresses (quote and book operations)\n- Contact names, phone numbers, and email addresses (booking only)\n- Your Warp account email and API key (stored locally in `~/.warp/config.json` — never transmitted beyond the Warp API)\n\n**Data NOT collected:**\n\n- No analytics or telemetry is sent to any third party\n- Payment card details are never handled by this package — charges are processed server-side by Stripe via the Warp backend\n\n**Storage:** Credentials are stored locally in `~/.warp/config.json` on your machine. No data is stored by the MCP server itself between calls.\n\n**Third parties:** Shipment data is shared with the selected freight carrier (Warp or market carriers) as required to book and execute the shipment.\n\n**Retention:** Data retention is governed by [Warp's Privacy Policy](https://www.wearewarp.com/privacy-policy).\n\n**Contact:** privacy@wearewarp.com\n\n## License\n\n[MIT](./LICENSE) © Warp Technology, Inc.\n",
  "bytes": 8387,
  "sha": "9385254ae904068100a595d09ac4bc283a4fbecf4231b64a6cfad122b48e1fff",
  "repo_slug": "warpfreight/warp-agent-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_warpfreight_warp_agent_mcp_b2b8c72b/readme"
}