Plain Freight

com.plainfreight由 plainfreight.com 发布官方发布者v1.0.0更新于 Oct 24, 2026

All-in DDP quotes for China to USA shipments, 100 g to 2,000 kg, from a live rate card

已验证Streamable HTTP可网页运行位置与生活商业与电商

概览

AI 生成的概览

托管型 MCP 服务器,提供中国到美国全包运费报价,并让助手查询可运性、轮询报价和追踪货运。

可以做什么
  • 按重量、产品和纸箱尺寸估算美元门到门运费
  • 判断产品能否承运以及需要哪些单证
  • 生成正式报价,返回 quote_id 和预填的订舱链接
  • 按 quote_id 轮询报价的二次审核结果与追加问题
  • 根据追踪链接读取已订舱货运的阶段和事件记录
适用场景
适合需要快速了解中国到美国运费、确认某产品能否寄运,或跟进已有 Plain Freight 货运的场景。适合小型进口商,以及无需注册即可回答货运问题的助手。
运行要求
远程 Streamable HTTP 端点 plainfreight.com/api/mcp,无需安装。不需要 API 密钥、注册或环境变量。需要能访问 plainfreight.com 的网络。
安装前请注意
generate_offer 会记录报价请求,若提供邮箱还会向其发送报价邮件(每个地址每天最多一封);没有工具会订舱或收费。追踪令牌相当于凭证,持有链接者均可读取该货运记录。价格不含货物保险,needs_review 时会有意不给出价格。存在按 IP 和邮箱的速率限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Plain Freight,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.plainfreight%2Fquotes/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "plain-freight": {
      "type": "http",
      "url": "https://plainfreight.com/api/mcp"
    }
  }
}

README

Plain Freight MCP server

A hosted Model Context Protocol server that quotes real freight. Ask it what it costs to ship something from China to the United States and it returns an all-in delivered-duty-paid price from the same pricing engine a human customer is quoted from: freight, US customs clearance, import duty and delivery to a US door, in one number.

No API key. No signup. Nothing to install.

https://plainfreight.com/api/mcp

Transport is Streamable HTTP, stateless, protocol version 2025-06-18 (also accepts 2025-03-26 and 2024-11-05).

Add it to a client

Claude Code:

bash
claude mcp add --transport http plain-freight https://plainfreight.com/api/mcp

Claude Desktop, Cursor, or anything reading a JSON config:

json
{  "mcpServers": {    "plain-freight": {      "type": "http",      "url": "https://plainfreight.com/api/mcp"    }  }}

Check it by hand:

bash
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"}'

Tools

Five tools. Only generate_offer records anything; the other four only read. No tool books or charges anything.

ToolWhat it does
estimate_priceA rough door to door cost in USD for air (and sea from 100 kg chargeable weight), from the same pricing engine. Needs weight_kg; product, carton sizes (carton_length_cm, carton_width_cm, carton_height_cm, carton_count) or total_cbm sharpen it. Returns the chargeable weight used (the greater of actual weight and carton volume in cm3 / 6,000), transit estimates and whether US import duty is included. Records nothing, contacts no one, needs no email. Goods that need a person to review them get no figure.
check_goodsSays whether a product (product, in the user's words) is priced at once or reviewed by a person first (for example batteries, chemicals, food, cosmetics, seeds, vapes or weapons), with a plain explanation and what documents to have ready. Same screen as generate_offer, so it predicts what an offer will do. Records nothing. Not legal or customs advice.
generate_offerThe firm offer. Needs product and weight_kg (0.1 to 2000); dimensions, origin, destination_zip, urgency, email, name and notes all improve the answer. Pass carton sizes when you have them: for light bulky cargo the volumetric weight sets the price, not the scale weight. Each call records a quote request, and if an email is given the written offer is mailed there once the second check settles (at most one offer email per address per day). Returns the options, a quote_id and a link to a booking form on plainfreight.com prefilled with the shipment.
check_offer_statusPolls an offer by quote_id until settled is true. Every quote gets a second check, which can add follow-up questions, change the options, or set needs_review. Read-only.
track_shipmentReads the live record for a booked shipment from its tracking_link (https://plainfreight.com/track/<token>, or the bare token): current stage on the 10-stage lifecycle, route and dated events. Read-only.

Booking happens outside the chat: the user opens the prefilled booking form, replies to the offer email, or writes to [email protected] quoting the quote_id. Nothing is paid before the goods are weighed at the warehouse.

Two behaviours worth knowing before you build on it:

  • needs_review means the prices are withheld on purpose. The goods look restricted (batteries, food, chemicals) and a person has to clear them first. Do not present a number to the user in that case; Plain Freight follows up by email.
  • The tracking token is the credential. Anyone holding the link can read that shipment, and the record deliberately excludes cost and margin fields.

Rate limits: 20 offers per hour per IP, 4 per email address, 30 across all agents per hour. For bulk or programmatic access, email [email protected].

There is also a plain REST version of the same pricing call at POST https://plainfreight.com/api/v1/offer, described in openapi.json, and human documentation at plainfreight.com/for-agents.

Published reference data

The same engine feeds three pages that are free to cite, with CSV and JSON where it makes sense:

The price-index data is also published as a dataset at plainfreight-com/china-usa-freight-price-index.

What Plain Freight is

A China to USA freight agency for small importers: one all-in DDP price on shipments from 100 g to 2,000 kg, quoted before pickup. Plain Freight is a trading name of Fisto LLC, a Wyoming limited liability company. The price does not include cargo insurance, which the customer arranges separately.

Questions, or a shipment that needs a human: [email protected]

Licence

MIT for the contents of this repository. The MCP server itself is a live commercial service; using it means quoting real freight, so treat the prices as real.

来源:README.md,提交 13bebb3

工具

5

estimate_price

Estimate China to USA shipping cost

Rough price estimate for shipping goods from China to a US address, 100 g to 2,000 kg. Records nothing, contacts no one and needs no email. Inputs: total weight, and optionally the product and carton sizes or total volume. Returns estimated door to door prices in USD for air (and sea from 10 kg chargeable weight), the chargeable weight used (the greater of actual weight and carton volume in cm3 / 6,000), transit estimates, and whether US import duty is included. Figures come from Plain Freight's pricing engine for densely packed goods, priced on the applicable rate; goods that need a review get no figure. The exact ZIP code, pickup city and cartons can move the price, so the result is an estimate, not an offer.

输入参数producttotal_cbmweight_kg必填carton_countcarton_width_cmcarton_height_cmcarton_length_cm

check_goods

Check if goods can be shipped

Checks whether Plain Freight can ship a product from China to the US, and which documents it needs. Records nothing. Input: the product description. Returns a verdict: instant_offer or branded_rate (priced at once, each on its applicable rate) or person_checks_first (for example batteries, chemicals, food, cosmetics, seeds, vapes or weapons: a person reviews the goods before any price), with a plain explanation and the documents or details to have ready. It applies the same goods screen as Plain Freight's offers; it is not legal or customs advice.

输入参数product必填

generate_offer

Quote a China to USA shipment

Prices a real shipment from China to a US address, 100 g to 2,000 kg, on Plain Freight's live pricing engine. Returns door to door prices in USD: each option covers freight, US customs clearance and delivery, and says whether US import duty is included (DDP) or paid at import. Carton dimensions affect the price: for light, bulky cargo the volumetric weight sets it. Side effects: each call records a separate quote request with Plain Freight, and if an email is given the written offer is emailed to that address once a second check settles (at most one offer email per address per day). Nothing is booked or charged. The result carries a quote_id, by which the second check's verdict can be read.

输入参数nameemailnotesoriginproduct必填urgencyweight_kg必填dimensionsdestination_zip

check_offer_status

Check an offer's second review

Reads the result of the second check on a Plain Freight offer, by the offer's quote_id. Read-only. Returns settled (true once the check finished), possibly updated options and summary, follow-up questions whose answers change the price or customs channel, the offer email status, and needs_review. When needs_review is true, prices are withheld until a person at Plain Freight reviews the goods (for example batteries, food or chemicals), and Plain Freight follows up by email.

输入参数quote_id必填

track_shipment

Track an existing shipment

Reads a booked Plain Freight shipment from its tracking link. Input: the tracking link from the booking email (https://plainfreight.com/track/<token>) or the bare token; the token is the credential, so only someone the customer shared the link with can read the record. Returns the shipment reference, the current stage on the 10-stage lifecycle (Booking through Delivered), shipment details and the dated event log. Read-only; changes to a booking go by email to [email protected] with the shipment reference.

输入参数tracking_link必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分