io.github.warpfreight/warp-agent-mcp
io.github.warpfreight/warp-agent-mcpQuote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.
Tools · 31
Quote a cargo van shipment (1-3 pallets, firm price)
Quote a 26' box truck shipment (1-12 pallets, firm price)
Quote a full truckload (53' dry van). Only origin, destination, and date required.
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 ind…
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…' secti…
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 retur…
Price MANY lanes in ONE call (parallel, ~1-3s for typical spreadsheets). Use this WHENEVER the user gives you a spreadsheet, CSV, or list of multiple lanes to quote — do NOT call warp_*_quote in a loo…
Book a quoted shipment using any quote_id or option id returned from a quote tool (Warp or market carrier). Requires quote_id + pickup and delivery addresses. Auth required.
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. …
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 tr…
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 …
Track a shipment by ID or tracking number. Auth required.
Get shipping history for your lanes (past shipments, last consignee, counts). Auth required.
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 ov…
Check Warp API health and version. Also validates your API key if one is configured.
Get the full tracking event history for a shipment (timeline of pickups, in-transit updates, deliveries). Auth required.
Retrieve the invoice for a delivered shipment (line items, taxes, payment status). Auth required.
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) …
List your recent freight quotes (LTL, van, box truck, FTL) from all sessions. Useful for surfacing prior pricing on similar lanes. Auth required.
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.
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 p…
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…
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 w…
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:…
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 …
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 onbo…
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 populati…
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.
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 a reusable load template (a named shipment config) so it can be recalled for repeat lanes. Auth required.
Delete a saved load template by its id (starts with lt_). Auth required.
Resources · 8
Inline quote card after van_quote / box_truck_quote / ftl_quote / ltl_quote.
ui://warp/quote-card
Inline quote card (MCP Apps) after van_quote / box_truck_quote / ftl_quote / ltl_quote.
ui://warp/quote-card.mcp
Inline shipments card after list_bookings.
ui://warp/bookings-card
Inline shipments card (MCP Apps) after list_bookings.
ui://warp/bookings-card.mcp
Inline batch-quote card after batch_quote.
ui://warp/batch-quote-card
Inline batch-quote card (MCP Apps) after batch_quote.
ui://warp/batch-quote-card.mcp
Inline batch-book progress card after batch_book.
ui://warp/batch-book-card
Inline batch-book progress card (MCP Apps) after batch_book.
ui://warp/batch-book-card.mcp
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"io.github.warpfreight/warp-agent-mcp": {
"url": "https://mcp.wearewarp.com/api/mcp",
"transport": "streamable-http"
}
}
}