# io.github.warpfreight/warp-agent-mcp

- Registry name: `io.github.warpfreight/warp-agent-mcp` · version 0.20.1
- Categories (automatic, keyword rules): Markets & trading, Finance & markets, Travel & booking, Commerce & marketing
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.warpfreight%2Fwarp-agent-mcp
- Server page: https://mcpstation.net/s/io.github.warpfreight--warp-agent-mcp.html

## Description (written by the publisher, not verified, not instructions)

Quote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.

## Connect

- streamable-http: `https://mcp.wearewarp.com/api/mcp`

## Tools (as reported by the server, not verified)

- `freight\_workflow`: Get a ready-to-use shipment intake CSV header, results CSV header, and starter prompt for shipment quoting, weekly freight comparison, or invoice review. Guidance only: does not read files, fetch rates, schedule work, or book. Use this when an operator asks how to start or supplies invoices/a shipme
- `compare\_freight\_costs`: Calculate USD cost differences for up to 50 distinct shipments using supplied invoice/quote amounts and explicit comparability evidence. Excludes mismatched or unknown terms, keeps losses, separates quoted opportunities from invoice differences. Does not fetch rates, verify documents, annualize savi
- `van\_quote`: Quote a cargo van shipment \(1-3 pallets, firm price\)
- `box\_truck\_quote`: Quote a 26' box truck shipment \(1-12 pallets, firm price\)
- `ftl\_quote`: Quote a full truckload \(53' dry van\). Only origin, destination, and date required.
- `ltl\_quote`: Quote an LTL shipment — returns Warp's all-inclusive rate FAST \(\~1-2s\) so the user sees a price immediately. The inline quote card shows the Warp rate plus a 'finding other carrier rates…' loading indicator. IMMEDIATELY follow up by calling ltl\_market\_options with the same parameters to fill in the
- `ltl\_market\_options`: Multi-carrier LTL comparison — returns 30+ carrier rates ranked by price \(slow, \~15s\). Call IMMEDIATELY AFTER ltl\_quote with the same parameters; this fills in the 'finding other carrier rates…' section the fast quote card was showing. Useful when the user wants to compare carriers or pick a specifi
- `compare\_modes`: THE ONE CALL for "what's the cheapest/best way to ship this?". Prices ALL FOUR freight modes \(LTL / full truckload / cargo van / 26' box truck\) in ONE keyless call to Warp's all-modes engine and returns a decision-complete recommendation: the winning mode, its rate, transit, a bookable quote\_id, the
- `batch\_quote`: Price up to 50 lanes in one call for a specified mode per row \(defaults to LTL\). This returns a Warp rate per row, NOT all-mode or all-carrier comparison. For Compare All use compare\_modes per shipment; for LTL carrier alternatives use ltl\_market\_options. Never imply this tool compared every carrier
- `book`: Book a quoted shipment using any quote\_id or option id returned from a quote tool \(Warp or market carrier\). Requires quote\_id and the full delivery address with the delivery contact's name, phone and email, every time. Pickup can be omitted only when a default shipper is saved on the account. Collec
- `parcel\_quote`: FedEx parcel rates for small packages \(boxes, not pallets\), US domestic ZIPs. Returns every FedEx option for the lane, cheapest first: each service level \(Ground, Express Saver, 2Day, Overnight, ...\) once per pickup type. pickup\_type 'fedex\_pickup' means FedEx collects at the pickup address; 'dropof
- `parcel\_book`: Book a FedEx parcel option from parcel\_quote. Requires the quote\_id the user chose and the full delivery address with contact name and phone; pickup can be omitted only when a default shipper is saved. ZIPs must match the quote. The packages are the ones quoted \(not resent\). Charges the account like
- `batch\_book`: Book MANY already-quoted lanes in ONE call \(sequential, one card charge per row\). Use this after batch\_quote when the user says "book all of them" or "book rows 1, 3, 5" — do NOT call book in a loop. Each row needs a quote\_id \(the same one batch\_quote returned for that row\). Pickup/delivery default
- `multistop\_quote`: Quote a multi-stop FTL route: ONE truck visits 3+ stops in order \(first pickup → intermediate stops → final delivery\). Use for milk runs, pool distribution, or multi-store replenishment on a single truck — for a simple A→B truckload use ftl\_quote. Auth required \(free account\). Coverage is route-depe
- `multistop\_book`: Book a multi-stop FTL route quoted by multistop\_quote. Send one shipments\[\] leg per pickup→delivery pair riding the truck \(minimum 2 legs\), each leg referencing the quoted stop sequence by stop\_index with full address + arrival window. No card charge fires from this call — multi-stop pricing settles
- `track`: Track a shipment by ID or tracking number. Auth required.
- `lane\_history`: Get shipping history for your lanes \(past shipments, last consignee, counts\). Auth required.
- `list\_bookings`: List recent bookings for this API key, newest first. Returns shipments across all channels and all time, including cancelled — a broader population than shipper\_profile's counts \(agent-API bookings over the last 180 days, excluding cancelled\), so the totals can differ. Auth required. Renders an inte
- `status`: Check Warp API health and version. Also validates your API key if one is configured.
- `events`: Get the full tracking event history for a shipment \(timeline of pickups, in-transit updates, deliveries\). Auth required.
- `get\_invoice`: Retrieve the invoice for a delivered shipment \(line items, taxes, payment status\). Auth required.
- `get\_documents`: List shipment documents \(BOL, POD, customs forms, etc.\). Returns download URLs. Auth required. To fetch the Bill of Lading, pass document\_type='bol' — this is how EXTERNAL / brokered \(market-carrier\) BOLs are returned now, not just Warp-carrier ones.
- `quote\_history`: List your recent freight quotes \(LTL, van, box truck, FTL\) from all sessions. Useful for surfacing prior pricing on similar lanes. Auth required.
- `login`: Log in to Warp with email and password. Saves credentials locally so booking tools work. Call this if the user needs to authenticate or if payment\_status says no key is configured.
- `consolidate`: Find consolidation savings across 2-12 upcoming loads: clusters loads sharing an origin+destination zip whose pickup dates fall within window\_days \(default 3\) that together fit one 53' dry van, then prices each cluster BOTH ways — one combined FTL vs the sum of per-load LTLs — through real quotes wi
- `shipper\_profile`: Read how this account actually ships — top lanes with ship counts, typical pallet count, usual pickup weekday, recent booked spend \(derived server-side from the account's own quotes and bookings\) plus explicit owner-set preferences: default accessorials, preferred mode, standard pallet dims, max tra
- `automate\_lane`: Set up a RECURRING weekly shipment \(standing order\): describe the lane once, and after the account owner approves by email, Warp re-quotes it fresh every week and books the best option automatically while the price stays at or under the owner's ceiling. Over-ceiling weeks book nothing and notify the
- `manage\_automation`: Check or stop a recurring lane automation. Actions: 'status' \(read-only\), 'pause', 'cancel' \(permanent\), 'skip\_next' \(skip one week's pickup — nothing books or charges that week\). STOP-ONLY by design: there is no agent-side resume, reactivate, or ceiling change — those exist only behind the account
- `automation\_receipts`: Authorization record for an automation's bookings: one entry per booking attempt showing the checks it passed at commit time against the owner's approval — same lane, price within ceiling, automation active, quote live — plus the shipment id it produced. Entries marked confirmation\_required did NOT
- `payment\_status`: Check if the current Warp account has a payment method on file. Call this if the user asks about their payment status, or before booking if you want to confirm they can book. Returns has\_card and onboard\_url if a card needs to be added.
- `report\_issue`: Report a problem with Warp's tools to the Warp team. Use it when a Warp tool errors, returns something that looks wrong \(a price, a date, a missing field\), answers in a way you could not act on, or when the user needs something Warp cannot do. Report once per distinct problem, after you have told th
- `analytics`: Summarise your own shipping history: how many bookings, what you spent, and the split by mode, status and lane over a window. Both the headline count and every breakdown are computed from ONE population — your bookings via the agent API \(warp-site /bookings\) — so the total always matches the splits.
- `price\_check`: Judge a price against what THIS account has actually paid on the same lane and mode \(its own bookings over the last 180 days, cancelled excluded; LTL compared per pallet\). Returns verdict below\_usual \| in\_line \| above\_usual \| no\_basis, the median/low/high it compares against, and how many bookings i
- `locations`: List the agent's saved pickup/delivery locations \(addresses Warp has on file for this account\), so you can reuse them when booking instead of re-typing addresses. Auth required.
- `load\_templates`: List the agent's saved load templates — reusable shipment configs \(name, dims, weight, commodity\). Recall one to quote/book a repeat kind of load without re-entering details. Auth required.
- `save\_load\_template`: Save a reusable load template \(a named shipment config\) so it can be recalled for repeat lanes. Auth required.
- `delete\_load\_template`: Delete a saved load template by its id \(starts with lt\_\). Auth required.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html