关于 Plain Freight
Plain Freight 是面向小型进口商的货运服务,可为中国至美国的货物提供含运费、清关、关税和派送的一口价。其 MCP 服务还支持估价、正式报价、审核判断和货件追踪。
主要功能
- 01门到门运费估价
- 02生成正式报价
- 03检查商品是否需人工审核
- 04查询报价状态
- 05追踪已预订货件
适用场景
- 01估算中国至美国货运成本
- 02为进口货物获取正式报价
- 03确认商品是否需要人工审核
- 04查询已预订货件的运输进度
MCP 相关
托管的 MCP 服务通过 Streamable HTTP 暴露五种工具,包括估价、报价、商品审核判断、报价状态查询和货件追踪。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://plainfreight.com/api/mcpclaude mcp add --transport http com-plainfreight-quotes https://plainfreight.com/api/mcp{"mcpServers":{"com-plainfreight-quotes":{"type":"http","url":"https://plainfreight.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-plainfreight-quotes":{"type":"http","url":"https://plainfreight.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-plainfreight-quotes":{"type":"http","url":"https://plainfreight.com/api/mcp"}}}{"mcpServers":{"com-plainfreight-quotes":{"serverUrl":"https://plainfreight.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product | string | 否 | 所运货物是什么,简要描述(用于设置货物费率) |
| total_cbm | number | 否 | 以立方米为单位的总体积;如果已知,可代替纸箱尺寸提供 |
| weight_kg | number | 是 | 货件的实际总重量,单位为 kg |
| carton_count | integer | 否 | 该尺寸纸箱的数量 |
| carton_width_cm | number | 否 | 单个纸箱的宽度,单位为 cm |
| carton_height_cm | number | 否 | 单个纸箱的高度,单位为 cm |
| carton_length_cm | number | 否 | 单个纸箱的长度,单位为 cm |
详细介绍
Plain Freight MCP 服务
一个托管的 Model Context Protocol 服务,可提供真实的货运报价。询问从中国运送某件物品到美国需要多少费用,它会返回一个含税到门价格,使用的正是向人工客户报价的同一套定价引擎:货运、美国清关、进口关税和送达美国地址的费用,合计为一个数字。
无需 API 密钥。无需注册。无需安装。
https://plainfreight.com/api/mcp
传输方式为 Streamable HTTP,无状态,协议版本为 2025-06-18(也接受 2025-03-26 和 2024-11-05)。
添加到客户端
Claude Code:
claude mcp add --transport http plain-freight https://plainfreight.com/api/mcp
Claude Desktop、Cursor 或任何读取 JSON 配置的应用:
{
"mcpServers": {
"plain-freight": {
"type": "http",
"url": "https://plainfreight.com/api/mcp"
}
}
}
手动检查:
curl -s -X POST https://plainfreight.com/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
工具
共有五个工具。只有 generate_offer 会记录信息;其余四个只读取信息。没有任何工具会预订或收取费用。
| 工具 | 功能 |
|---|---|
estimate_price | 使用同一套定价引擎,粗略估算空运(可计费重量达到 100 kg 时也可估算海运)的门到门美元费用。需要提供 weight_kg;提供 product、纸箱尺寸(carton_length_cm、carton_width_cm、carton_height_cm、carton_count)或 total_cbm 可提高估算准确度。返回所用的计费重量(实际重量与纸箱体积按 cm3 / 6,000 计算所得重量中的较大值)、预计运输时间,以及是否包含美国进口关税。不会记录任何信息、联系任何人,也不需要电子邮箱。需要人工审核的货物不会返回价格。 |
check_goods | 判断某种产品(用用户自己的说法填写 product)是可直接报价,还是需要先由人工审核(例如电池、化学品、食品、化妆品、种子、电子烟或武器),并提供通俗说明以及需准备的文件。它与 generate_offer 使用相同的筛查,因此可预测报价的处理方式。不会记录任何信息。不能作为法律或海关建议。 |
generate_offer | 正式报价。需要提供 product 和 weight_kg(0.1 到 2000);dimensions、origin、destination_zip、urgency、email、name 和 notes 都有助于提高报价准确度。如果知道纸箱尺寸,请一并提供:对于轻质但体积大的货物,价格取决于体积重量,而非秤重。每次调用都会记录一项报价请求;如果提供了 email,第二次检查完成后会将书面报价发送到该地址(每个地址每天最多发送一封报价邮件)。返回可选方案、quote_id,以及一个已预填货运信息的 plainfreight.com 预订表单链接。 |
check_offer_status | 根据 quote_id 查询报价,直到 settled 为 true。每份报价都会进行第二次检查,该检查可能会提出后续问题、更改可选方案,或将状态设为 needs_review。只读。 |
track_shipment | 根据 tracking_link(https://plainfreight.com/track/<token> 或纯令牌)读取已预订货运的实时记录:10 阶段生命周期中的当前阶段、路线和注明日期的事件。只读。 |
预订在聊天之外完成:用户打开已预填的预订表单、回复报价邮件,或发送邮件至 [email protected] 并注明 quote_id。货物在仓库称重前无需付款。
接入前有两点值得注意:
needs_review表示价格是有意暂不提供的。 货物看起来属于受限物品(电池、食品、化学品),需要先由人工审核通过。这种情况下不要向用户报出价格;Plain Freight 会通过邮件跟进。- 跟踪令牌就是凭证。 任何持有链接的人都能查看该货运信息;记录会有意排除费用和利润字段。
速率限制:每个 IP 每小时最多 20 份报价,每个电子邮箱地址最多 4 份,所有 Agent 合计每小时最多 30 份。如需批量或程序化访问,请发送邮件至 [email protected]。
此外,同一报价调用也提供普通 REST 版本:POST https://plainfreight.com/api/v1/offer,详见
openapi.json;人工文档见
plainfreight.com/for-agents。
已发布的参考数据
同一引擎还提供三个可免费引用的页面,并在适用时提供 CSV 和 JSON:
- 中国至美国运费价格指数:按日期记录的门到门价格,涵盖 0.5 kg 至 1,000 kg 的十二种重量,每一行都标注税费状态和运输时间。
- 计费重量参考:十五种真实纸箱的计费重量,以及这些纸箱按三种系数计算的结果。
- 美国进口规则时间线:自 2025 年 5 月以来每项最低免税额和报关规则变更,以及对应的《联邦公报》引文。
价格指数数据也作为数据集发布在 plainfreight-com/china-usa-freight-price-index。
Plain Freight 是什么
一家为小型进口商服务的中国至美国货运代理:承运重量为 100 g 至 2,000 kg 的货物,提供全包 DDP 价格,并在取件前报价。Plain Freight 是 Fisto LLC 的商号,这是一家在怀俄明州注册的有限责任公司。价格不包含货物保险,客户需另行安排。
有问题,或有货件需要人工协助:[email protected]
许可证
本仓库内容采用 MIT 许可证。MCP 服务本身是一项实时商业服务;使用它意味着查询真实货运价格,因此请将这些价格视为真实价格。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。