freight-pulse (ocean & multimodal freight intelligence, 47 tools)

freight-pulse 🚢

面向 AI Agent 的海运与多式联运情报套件。 一个 MCP 服务，回答进口商、CFO 或供应链 Agent 实际会问的 任何 运输问题——从 “上海 → 洛杉矶的现货运价是多少？” 到 “加上关税后，我的总到岸成本是多少？” 再到 “我应该现在订这条航线，还是再等等？”——通过 47 个工具 覆盖运价、总到岸成本、运输可靠性、海关、风险、排放，以及统一的 运输决策。

提供航线、HS 编码和货值——即可获得 一个可信且经过交叉验证的答案，并附上置信度评估，而非某家供应商的报价。运价引擎、港口标准化、海关逻辑以及持续积累的逐航线历史数据都在 服务端 运行（这正是竞争壁垒）；npm 包只是一个轻量客户端。

托管端点： https://freight-pulse-mcp.vercel.app/mcp · 可流式传输的 HTTP，免费套餐无需注册。

---

为什么 Agent 会选择它

单一货运 API 只返回 一家供应商的价格，没有其他数据作参考，而且到运价为止。freight-pulse 则覆盖了进口商所需的整个流程：

• 经过交叉验证的运价。 在服务端读取 Drewry 的 World Container Index (WCI) 和 Freightos Baltic Index (FBX)（如果你提供 SeaRates 密钥，也会读取你自己的数据），并将其整合为 一个标准化的美元数值，附带 置信度评分（各数据源是否一致？）和市场趋势（上涨 / 下跌 / 稳定）。
• 完整决策，而不只是价格。 将含 HS 编码关税的到岸成本、门到门全包价、运输时间与可靠性（p90）、空运与海运的权衡、海关、风险和 CO₂ 汇总为单一的 ship_decision 结论：立即订舱 / 等待 / 更换运输方式。
• 持续积累自身历史数据。 每条查询过的航线都会连同时间戳一起缓存；趋势工具可提供持续数周的标准化数据序列，没有任何单一指数会免费提供给 Agent。
• 公开且非敏感的输入。 港口、HS 编码、申报货值——没有任何机密信息。Agent 可安全调用，无需提供凭证。

---

示例 — 上海 → 洛杉矶，40 英尺，货值 18 万美元

💲 get_spot_rate     → $5,442 / 40ft · confidence 🟢 80/100 · cross-validated from Drewry + FBX (spread 11%)
🧾 get_all_in_rate   → $6,910 all-in (BAF, THC, doc, ISF, drayage folded in)
📦 get_landed_cost   → $193,180 delivered  (rate + 3.4% duty on HS 8516 + MPF/HMF + insurance)
🚢 ship_decision     → BOOK NOW  ·  rate stable-to-rising, equipment available, transit p90 within SLA

一次 Agent 调用链，一个决策结论。这就是货运 API 与货运 Agent 的区别。

---

功能一览 — 47 个工具

领域	工具
运价与趋势	get_spot_rate（免费）、get_lane_trend、get_all_in_rate、rate_benchmark（我是否付贵了？）
总成本	get_landed_cost、total_cost_ownership、customs_valuation、customs_optimization
决策	ship_decision、simulate_scenario、compare_modes（空运与海运）、sourcing_analysis（中国+1 / 近岸外包）
运输与风险	get_port_intel（拥堵情况）、lane_risk_index、disruption、contingency_plan、get_scorecard
采购	procurement_strategy、build_tender、evaluate_bids、select_provider（货运代理 / 3PL）、record_performance
海关与单证	required_documents、incoterm_responsibility、qualify_fta_origin、export_compliance、check_lc_documents
承运人与设备	carrier_recommendation、equipment_availability、booking_strategy、appointment_plan、dnd_strategy（滞期费与滞箱费）
内陆运输与装载	door_to_door、load_plan、pallet_plan、optimize_network、cold_chain
财务与风险	payment_terms、fx_exposure、insurance_recommendation、inventory_optimization
可持续性	carbon_footprint（GLEC/ISO 14083）、decarbonization_roadmap、reverse_logistics
监控	create_watch、check_watches、market_report、special_cargo

get_spot_rate 免费（引流工具）。深度分析工具为 高级功能。

---

快速开始（MCP）

{
  "mcpServers": {
    "freight-pulse": {
      "command": "npx",
      "args": ["-y", "freight-pulse-mcp"],
      "env": {
        // optional: unlock premium tools with a prepaid key
        "FREIGHT_PULSE_KEY": "fp_…",
        // optional: your own SeaRates key — cross-validated as a THIRD source, RAISES confidence
        "SEARATES_API_KEY": "…"
      }
    }
  }
}

或者通过 HTTP 连接至 POST https://freight-pulse-mcp.vercel.app/mcp（支持流式传输）。

---

Free 与 Pro

	Free	Pro
get_spot_rate（经交叉验证的费率 + 置信度 + 方向）	✅	✅
全部 40 多种分析工具（到岸成本、ship_decision、海关、风险、趋势，……）	升级预览	✅ 完整结果
累积的各航线趋势历史记录	—	✅
支付方式	—	🪙 x402（Base 上的 USDC） 按次付费 — Agent 自动付款，无需注册 · 或通过 Stripe 结账使用 💳 银行卡 预付密钥

付费调用有两种方式：

• 🪙 x402（Base 上的 USDC） — 支持 x402 的 Agent 会自动按次付款，无需注册。
• 💳 银行卡（Stripe） — 购买预付 API 密钥，并将其作为 Authorization: Bearer <key> 发送 （或设置 FREIGHT_PULSE_KEY）。

---

关于数据

freight-pulse 是根据公开货运指数和海关参考数据交叉验证得出的参考性市场情报，并非承运商报价或预订信息。做出承诺前，请务必向货运代理核实。Drewry WCI 和 Freightos FBX 每周发布评估数据；SeaRates 是可选数据源，需自带密钥（它只会提高置信度，并非必需）。

分析引擎 — 包括指数获取、港口/HS 标准化、交叉验证、置信度模型、海关/关税逻辑以及各航线历史记录缓存 — 均在服务端运行。npm 包是一个轻量客户端，会将请求转发至托管服务。

MIT · github.com/Baneado98/freight-pulse · 托管于 freight-pulse-mcp.vercel.app