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 分