Freight Visibility from Your Code Editor

Why Cursor + Warp MCP

Cursor is an AI code editor. The Warp MCP server gives it freight visibility capabilities. Together, you can build freight integrations while testing against live data in the same conversation. Ask Cursor to pull your shipments, see the real response shapes, and write the code that handles them. No switching between an API playground and your editor.

For teams building supply chain software, this collapses the build and test cycle. Your developer describes a freight feature in natural language. Cursor writes the code and validates it against live Warp data. Real tracking responses, real document formats, real invoice structures.

What you need

• -Cursor installed. Get it at cursor.com.
• -Node.js 18 or later. Run node --version to check.
• -That's it. No API key to paste, no Warp account to create in advance -- warp-agent login will do it.

Step 1: Install the CLI and log in

warp-agent loginprompts for email and password. If the account doesn't exist, it creates one -- no sales call, no approval wait. Your API key is saved to ~/.warp/config.json and read automatically by both the CLI and the MCP server.

# Step 1: Install the CLI and log in
npm install -g @warpfreight/cli-agent
warp-agent login

# Step 2: Install the MCP server
npm install -g warp-agent-mcp

Step 2: Add the MCP server in Cursor

Create .cursor/mcp.json in your project root (recommended for team projects) or add via Cursor Settings > MCP for user-wide access. No API key in the config -- the server reads from ~/.warp/config.json at startup.

// .cursor/mcp.json (or Cursor Settings > MCP > Add Server)
{
  "mcpServers": {
    "warp": {
      "command": "warp-agent-mcp"
    }
  }
}

Step 3: Verify and start shipping

Open a new Cursor AI chat (Cmd+L or Ctrl+L) and ask about Warp tools. You should see freight tools available. Then start shipping.

Cursor AI Chat:

You: "Quote LTL from 90007 to 60601 -- 2 pallets, 600 lbs, 48x40x48, pickup May 5."

Cursor calls warp_ltl_quote.

Returns Warp rate at $955.93 (5-day transit, quote_id PRICING_abc-123)
plus 20+ market carriers sorted by price.

You: "Book the Warp option. Pickup Acme, 1330 Main St LA 90007. Drop Client Co,
     456 Oak Chicago 60601. Use the default contact I saved."

Cursor calls warp_book with PRICING_abc-123 + address flags.

Returns:
  trackingNumber: S-80215-2616
  orderNumber: ORD-12345
  pickup_date: 2026-05-05

You: "Pull the POD."

Cursor calls warp_get_documents with order_id.

Returns POD photo URLs + BOL PDF.

You: "Now build a React component that renders the booking response."

Cursor writes the component using the real field names from the
warp_book response -- trackingNumber, orderNumber, pickup_date, etc.

The build + test workflow

This is the real power of MCP in Cursor. Your AI assistant writes code in the editor and tests it against the live Warp network in the same conversation. No Postman. No curl. No switching tabs.

You: "Build a shipment tracking dashboard component
      for React. Test it against my live shipment data."

Cursor:
1. Calls warp_list_bookings(limit: 10) -- sees real pickup/delivery
   addresses, contacts, time windows, status
2. Calls warp_events(shipment_id) for one active booking -- sees the
   real event shape: type, location, timestamp
3. Calls warp_track(shipment_id) -- sees status + last_event + eta
4. Writes the React component matching those field names

Real field names. Real types. No guessing.

What teams build with this

• -Shipment tracking dashboards that display real time status and event timelines.
• -Document management interfaces that pull BOLs, PODs, and delivery photos.
• -Invoice audit tools that compare costs across shipments.
• -Internal tools for operations teams to search and filter shipment history.
• -Exception monitoring dashboards that flag late or problematic shipments.
• -Reporting tools that aggregate shipment data by date range or reference number.
• -AI agents that monitor freight visibility and surface issues proactively.

Frequently asked questions

Related

• -Warp MCP Server Overview
• -Connect Warp MCP to Claude Code
• -Vibe Coding Freight
• -Build a Shipping App in 10 Minutes
• -Programmable Freight Infrastructure