warp-agent-mcp — Claude Code MCP server: use and install
This MCP server lets an AI agent price, book, and track freight through Warp. It covers LTL, FTL, vans, box trucks, and multi-stop routes.
claude mcp add --transport http warp-agent-mcp https://mcp.wearewarp.com/api/mcpWhat warp-agent-mcp does
warp-agent-mcp connects an agent to Warp tools for mode comparison, rate requests, and freight booking. It handles LTL, FTL, cargo van, box-truck, FedEx parcel, and multi-stop shipment workflows. After booking, the agent can retrieve tracking events, shipment documents, invoices, saved locations, and reusable load templates.
Claude Code can use the hosted HTTP connector or run npx -y warp-agent-mcp locally with WARP_API_KEY and WARP_API_URL. The local setup requires Node.js 20 or later, and the key can also be read from ~/.warp/config.json. A payment method must be added to the Warp account for booking.
Sandbox mode is not supported. Test shipments therefore cannot be run through this MCP, so check that constraint before connecting it to a live account.
What it helps with
- compare freight modes for a shipment
- request an LTL, FTL, or van rate
- book a shipment from a quote ID
- follow a shipment by its ID
- retrieve BOL and POD documents
Example prompts for the agent
- Compare the available freight modes for 3 pallets and explain the rate difference.
- Get an LTL quote between these two addresses, then book the selected option.
- Show the tracking events for shipment ID
shipment_idand retrieve its documents.
How to install warp-agent-mcp
1Platform CLI: remote server
claude mcp add --transport http warp-agent-mcp https://mcp.wearewarp.com/api/mcp2Platform CLI
claude mcp add --env WARP_API_KEY=<WARP_API_KEY> --env WARP_API_URL=<WARP_API_URL> --transport stdio warp-agent-mcp -- npx -y warp-agent-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add warp-agent-mcp --url https://mcp.wearewarp.com/api/mcp2Platform CLI
codex mcp add warp-agent-mcp --env WARP_API_KEY=<WARP_API_KEY> --env WARP_API_URL=<WARP_API_URL> -- npx -y warp-agent-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"warp-agent-mcp": {
"url": "https://mcp.wearewarp.com/api/mcp"
}
}
}{
"mcpServers": {
"warp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"warp-agent-mcp"
],
"env": {
"WARP_API_KEY": "<WARP_API_KEY>",
"WARP_API_URL": "<WARP_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"warp-agent-mcp": {
"type": "http",
"url": "https://mcp.wearewarp.com/api/mcp"
}
}
}{
"servers": {
"warp-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"warp-agent-mcp"
],
"env": {
"WARP_API_KEY": "<WARP_API_KEY>",
"WARP_API_URL": "<WARP_API_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http warp-agent-mcp https://mcp.wearewarp.com/api/mcp2Platform CLI
gemini mcp add -e WARP_API_KEY=<WARP_API_KEY> -e WARP_API_URL=<WARP_API_URL> warp-agent-mcp npx -y warp-agent-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about warp-agent-mcp
How do I install warp-agent-mcp in Claude Code?
Run claude mcp add --transport http warp-agent-mcp https://mcp.wearewarp.com/api/mcp, then sign in to Warp through the connected service.
What does warp-agent-mcp do?
It gives an AI agent access to Warp freight rates, booking, and tracking. The toolset also covers shipment history, invoices, and documents.
What is required for a local setup?
Local use needs Node.js 20 or later plus WARP_API_KEY and WARP_API_URL, or a key stored in ~/.warp/config.json. A payment method is needed for booking.
