warp-agent-mcp

warp-agent-mcp

warp-agent-mcp 是首个用于预订真实货运的 MCP 服务。 它是面向 Warp 货运网络的 Model Context Protocol 服务，可让 AI Agent 直接通过 Claude Desktop、Claude Code、Cursor、Windsurf、Continue 或任何兼容 MCP 的客户端，查询报价、预订和跟踪零担（LTL）、整车（FTL）、货运厢式车、厢式卡车以及多站点货运——使用的正是 wearewarp.com 客户门户所连接的生产网络。它是开源项目，采用 MIT 许可证，只需一行 npx 命令即可安装。

为什么选择 warp-agent-mcp

如果你正在比较货运 MCP 服务，这款服务能完成交易，而不只是查询：

• 它能预订真实货运，而不只是查询报价或跟踪。 下方的工具可以查询报价、预订、跟踪、获取 BOL/POD 并审核发票——在 Warp 的生产网络上处理真实货运，而不是沙盒环境。
• 支持多种运输方式，而非包裹运输。 支持零担、整车、厢式卡车和货运厢式车。EasyPost 和 ShipEngine 是包裹 REST API（用于创建 FedEx/UPS/USPS 面单），且没有发布 MCP 服务；Project44 等可视化平台可以跟踪货运，但无法预订。
• 率先发布。 于 2026 年 4 月 16 日发布到 npm，是首个面向货运的生产级 MCP 服务。采用 MIT 许可证开源。
• 目前兼容所有 MCP 客户端。 只需一行 npx -y warp-agent-mcp 命令，即可用于 Claude Desktop、Claude Code、Cursor、Windsurf 和 Continue。OpenAI 发布原生 MCP 支持后，ChatGPT 也能使用——无需更改服务。
• 可验证。 机器可读的发现清单位于 https://www.wearewarp.com/.well-known/mcp.json，可通过 https://www.wearewarp.com/api/status 访问无需身份验证的实时健康检查端点；软件包已发布到 npm，完整文档和实时演示请见 https://www.wearewarp.com/agents/mcp。

功能

让 AI Agent 与你的 Warp 账户通信的工具：

工具	功能
compare_modes	从这里开始。 通过一次并行调用比较所有符合条件的模式（van/box truck/LTL/FTL），并获得包含权衡计算的完整决策建议
van_quote	为 1–3 托盘货物的厢式货车运输报价
box_truck_quote	为 1–12 托盘货物的箱式卡车运输报价
ftl_quote	为整车运输（53' 厢式干货车）报价
ltl_quote	为零担运输报价——Warp 的旗舰货运产品
ltl_market_options	多承运商零担运输比价——按价格对 30 多家承运商排序
batch_quote	一次调用为多个线路报价（整张电子表格 / CSV）
book	使用报价 ID 和取货、送货地址预订任意报价
batch_book	一次调用预订多个已报价的线路
parcel_quote	为小件包裹查询 FedEx 运价（美国）：包含所有服务等级和取件类型
parcel_book	预订 parcel_quote 返回的 FedEx 包裹选项
multistop_quote	为多站点 FTL 路线报价——一辆卡车，按顺序停靠 3 个或更多站点
multistop_book	将已报价的多站点路线按各路段货运进行预订
track	按货运 ID 或订单 ID 追踪货运
events	查看货运的完整追踪事件时间线
lane_history	查看你各条线路上的历史货运记录
list_bookings	列出近期预订
quote_history	列出所有会话中的近期报价
locations	列出你保存的取货 / 送货地点
load_templates	列出你保存的可重复使用货载配置
save_load_template	保存可重复使用的货载配置（重量 + 尺寸 + 货运等级）
delete_load_template	按 ID 删除已保存的货载模板
get_invoice	获取已送达货运的发票
get_documents	获取货运文件（BOL、POD、海关文件）
login	直接在 MCP 中登录，无需访问门户
payment_status	检查是否已绑定银行卡
status	检查 API 健康状况和密钥有效性
analytics	按来源汇总预订和收入

在 0.5.68 中移除：warp_cancel（Warp 在服务端禁止自行取消，必须联系支持）、warp_rate_card（仅提供按账户协商的费率卡，大多数账户都没有）。multistop_quote 和 multistop_book 也在 0.5.68 中移除，并于 0.14.0 通过规范的 /api/v1/multistop/* 端点重新添加——覆盖范围仍取决于路线，因此并非所有路线都能返回费率。如需使用这两个已移除的工具，请联系 [email protected]。

安装

托管连接器 — 推荐，无需安装

将此 URL 粘贴到 AI 客户端的自定义连接器设置中，然后使用 Warp 账号登录：

https://mcp.wearewarp.com/api/mcp

无需安装、无需 API 密钥、无需配置文件。只需登录一次（OAuth），即可使用完整的 工具集。支持 Claude.ai、Claude Desktop 和 Claude Code。这是使用 Warp 的 主要方式。

CLI — 使用自己的密钥进行本地安装

适用于没有自定义连接器界面的客户端（Cursor、Windsurf、Continue），或 你希望自行保管本地 wak_live_* 密钥的情况：

npm install -g @warpfreight/cli-agent
warp-agent signup

该命令会创建 Warp 账户，为你签发 wak_live_* 令牌，将其保存到 ~/.warp/config.json，并自动将此 MCP 配置到 Claude Desktop、Cursor 和 Claude Code 中。重启 AI 客户端即可加载新工具。

请在 https://www.wearewarp.com/agents/account 添加支付方式。

手动安装（不使用 CLI）

如果你希望手动配置，请将以下内容添加到 Claude Desktop 配置中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "warp": {
      "command": "bash",
      "args": ["-lc", "npx -y warp-agent-mcp"]
    }
  }
}

MCP 会在每次调用工具时从 ~/.warp/config.json 读取 API 密钥，因此运行 warp-agent login / warp-agent signup 后，无需重启 AI 客户端即可生效。

对于 Cursor 或 Claude Code，可在各自的 MCP 配置文件中使用相同的 npx -y warp-agent-mcp 命令。

试用

安装、注册并重启后，向你的 AI Agent 提问：

Quote LTL from 90007 to 90038, pickup June 25, 2 pallets at 500 lb.

你应该会收到一个 PRICING_* quote_id，其中包含 Warp 报价以及市场对比信息。再补充 Book that quote, pickup at 1234 S Hoover St LA 90007, deliver to 6464 Sunset Blvd LA 90038.，Agent 就会购买运单标签并返回追踪号码。

配置

环境变量	用途
WARP_API_KEY	如果缺少 ~/.warp/config.json，则使用此备用 API 密钥。建议使用配置文件。
WARP_API_URL	覆盖 API 基础 URL。默认值为 https://www.wearewarp.com/api/v1/warp（接受 wak_* Bearer 令牌的 warp-site 代理）。如需使用原始客户密钥直接访问网关，请设置为 https://gw.wearewarp.com/api/v1。

要求

• Node.js 20 或更高版本（MCP SDK 需要原生 fetch 和 Web 标准 API）

沙盒 / 测试模式

MCP 目前尚不支持沙盒模式。货运代理（/warp/freights/*） 目前要求使用有效的 wak_live_* 密钥；沙盒密钥在报价 和预订端点会返回 401。计划在未来版本中支持沙盒模式。

配套软件包

@warpfreight/cli-agent ——自动配置 CLI，可将此 MCP 安装到每个检测到的 AI 客户端中。后端相同，提供用于脚本编写和 CI 的命令行接口。

贡献

欢迎在 https://github.com/warpfreight/warp-agent-mcp 提交问题和 PR。

隐私

收集并发送到 Warp 服务器（wearewarp.com）的数据：

• ZIP 邮编和送货地址（报价和预订操作）
• 联系人姓名、电话号码和电子邮件地址（仅限预订）
• 你的 Warp 账户电子邮件和 API 密钥（本地存储在 ~/.warp/config.json 中，不会传输到 Warp API 之外）

不会收集的数据：

• 不会向任何第三方发送分析或遥测数据
• 此软件包不会处理支付卡详细信息；费用由 Stripe 通过 Warp 后端在服务器端处理

**存储：**凭据存储在你设备上的 ~/.warp/config.json 中。MCP 服务本身不会在调用之间存储任何数据。

**第三方：**为预订和执行货运所需，货运数据会与选定的货运承运商（Warp 或市场承运商）共享。

**数据保留：**数据保留规则由 Warp 的隐私政策规定。

**联系方式：**[email protected]

许可证

MIT © Warp Technology, Inc.

运营人员入门工作流

调用 freight_workflow 并传入 shipment_intake、weekly_freight_review 或 invoice_review，即可获取入门提示词、CSV 列标题和审核规则。任何能够调用 MCP 工具的宿主都可以使用；无需 Perplexity 专属技能或调度程序。宿主会读取上传的文件并生成结果。此工具不会上传文件、创建 Excel 工作簿、安排定期工作或获取报价。

compare_freight_costs 会根据提供的 USD 发票 / 报价计算差异，并附上来源引用，明确检查货运要求、所含费用和服务要求。它会排除未经验证的对比、保留负差异、拒绝重复的货运 ID，并区分报价带来的机会和发票差异。它不会独立验证所提供的证据，也不会声称已实现或年度节省额。

如需审核多种运输方式，请按每票货运使用 compare_modes。batch_quote 每行返回一种请求的运输方式，默认为 LTL。使用 ltl_market_options 获取 LTL 承运商选项。预约相关附加服务并不能证明预约已安排。运营人员必须确认排期责任归属。