warp-agent-mcp 是一个面向 Warp 货运网络的 Model Context Protocol（MCP）服务器，让任何 MCP 兼容的 AI 智能体可以直接完成真实货运的报价、预订与追踪，而不只是查询。它运行在与 wearewarp.com 客户门户相同的生产网络上，属于开源项目，采用 MIT 许可。
主要用途 该服务器面向需要通过 AI 智能体处理真实货运交易的场景。与其它的货运 MCP 服务器相比，它的特点在于完成交易，而不仅仅是查价或追踪。
主要能力 支持多模式运输：LTL（零担）、FTL（整车）、厢式货车、货运面包车以及多站点运输，而不是仅限包裹。工具集覆盖报价、预订、追踪、拉取 BOL/POD 以及审核发票。注意以下工具的情况：warp_cancel 在 0.5.68 中被移除（Warp 在服务端阻止自助取消，必须走支持渠道）；warp_rate_card 也被移除（仅限每账户协商的费率卡，多数账户没有）；multistop_quote 和 multistop_book 在 0.5.68 移除后于 0.14.0 重新加入，对接规范的 /api/v1/multistop/* 端点，但覆盖率取决于路线，并非所有路线都会返回费率。如需已移除的工具，可联系 support@wearewarp.com。
使用方式 托管连接器（推荐，无需安装）：把连接器 URL 粘贴到 AI 客户端的自定义连接器设置中，并用 Warp 登录。无需安装、无需 API 密钥、无需配置文件，登录一次（OAuth）后全部工具集即可使用，支持 Claude.ai、Claude Desktop 和 Claude Code。 CLI（本地安装，使用自己的密钥）：适用于没有自定义连接器界面的客户端（Cursor、Windsurf、Continue），或希望本地保存 wak_live_* 密钥的用户。该命令会创建 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。MCP 在每次工具调用时从 ~/.warp/config.json 读取 API 密钥，因此 warp-agent login / warp-agent signup 无需重启 AI 客户端即可生效。Cursor 或 Claude Code 使用相同的 npx -y warp-agent-mcp 命令。 安装并注册、重启后，可让 AI 智能体进行报价：应返回带 Warp 价格和市场比价的 PRICING_* quote_id；然后让智能体预订该报价并提供取货和送货地址，智能体将购买标签并返回追踪号。
环境要求与限制 需要 Node.js 20 或更高版本（MCP SDK 需要原生 fetch 和 Web Standard API）。沙箱/测试模式尚不支持：货运代理（/warp/freights/）当前要求有效的 wak_live_ 密钥，沙箱密钥在报价和预订端点返回 401，沙箱支持计划在未来版本中提供。
配套包 @warpfreight/cli-agent 是自动配置 CLI，可将该 MCP 安装到所有检测到的 AI 客户端中，使用相同后端，提供命令行界面用于脚本和 CI。
数据与隐私 发送到 Warp 服务器的数据包括：邮编和收货地址（报价和预订操作）、联系人姓名、电话和邮箱（仅预订）、你的 Warp 账户邮箱和 API 密钥（本地存储于 ~/.warp/config.json，除 Warp API 外不会传输）。不收集的数据：不向任何第三方发送分析或遥测；支付卡信息从不经该包处理，扣款由 Stripe 在 Warp 后端服务端处理。凭据本地存储于 ~/.warp/config.json，MCP 服务器本身在调用之间不存储数据。货运数据会按预订和执行需要与所选承运商共享。数据保留受 Warp 隐私政策约束。联系邮箱 privacy@wearewarp.com。
运营者起始工作流 调用 freight_workflow 并传入 shipment_intake、weekly_freight_review 或 invoice_review，可获得起始提示词、CSV 列标题和审核规则。任何能调用 MCP 工具的主机均可使用，无需特定技能或调度器；由主机读取上传文件并产生结果。该工具本身不上传文件、不创建 Excel 工作簿、不安排周期任务、也不获取报价。 compare_freight_costs 根据提供的美元发票/报价计算差异，附来源引用并明确检查货物要求、包含费用和服务要求。它会排除未经验证的比较、保留负差异、拒绝重复货运 ID，并将已报价机会与发票差异分开。它不会独立验证所提供证据，也不声称已实现或年度节省。 多模式审核可对每次货运使用 compare_modes。batch_quote 每行返回一个请求模式，默认 LTL。ltl_market_options 用于 LTL 承运商备选方案。预约附加费不证明已安排预约，运营方必须确认调度归属。
