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.
• -A Warp API key. Get one at customer.wearewarp.com under Settings > API Keys.
• -Node.js 18+ (only needed for the stdio method).

Step 1: Get your Warp API key

Go to customer.wearewarp.comand navigate to Settings > API Keys. Click "Create API Key" and copy it.

Step 2: Add the MCP server in Cursor

Open Cursor Settings (Cmd+, on Mac, Ctrl+, on Windows/Linux). Navigate to the MCP section. Add a new MCP server.

// Cursor Settings > MCP > Add Server
{
  "mcpServers": {
    "warp": {
      "disabled": false,
      "headers": {
        "x-api-key": "YOUR_WARP_API_KEY"
      },
      "serverUrl": "https://server-mcp.wearewarp.com/sse"
    }
  }
}

// Cursor Settings > MCP > Add Server
{
  "mcpServers": {
    "warp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wearewarp-nodejs-mcp"
      ],
      "env": {
        "WARP_API_KEY": "YOUR_WARP_API_KEY"
      }
    }
  }
}

Replace YOUR_WARP_API_KEY with the key you copied in Step 1.

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: "Check the status of my last 5 shipments."

Cursor calls warp.get-shipments with page: 1, pageSize: 5

  1. WARP-5192847 | IN TRANSIT  | LA → Portland
  2. WARP-5192840 | DELIVERED   | Dallas → Phoenix
  3. WARP-5192831 | DELIVERED   | ATL → Chicago
  4. WARP-5192825 | INVOICED    | NYC → Boston
  5. WARP-5192819 | COMPLETE    | Houston → Denver

You: "Pull the POD for the Portland shipment."

Cursor calls warp.get-documents with orderId, type: "pod"

  POD: Signature captured + 2 delivery photos
  Downloaded: WARP-POD-5192847.pdf

You: "Now use this response format to build a
      shipment status component for our dashboard."

Cursor writes the React component using real data shapes.

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.get-shipments to get real data shapes
2. Writes the React component in your editor
3. Calls warp.get-shipment-events for timeline data
4. Adjusts the component to match actual API schemas

Real data. Real code. No mocking.

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