SMKlog Parcel Shipping Rates

com.smklog由 smklog.com 發布官方發布者v1.5.0更新於 Nov 7, 2026

Live USPS, UPS, FedEx and DHL rates from the US: domestic, Canada, UK, Germany, Australia. No scale.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

從美國寄件地查詢 USPS、UPS、FedEx 與 DHL 的即時包裹運費,並產生預填結帳連結,讓使用者自行購買託運單。

可以做什麼
  • 用自然語言描述物品或提供精確箱體尺寸,查詢即時包裹運費,含結帳總價與業者臨櫃價。
  • 為選定的報價建立預填結帳連結,之後查詢使用者是否付款、託運單是否產生與追蹤號碼,或取消尚未開啟的工作階段。
  • 查詢結帳工作階段的退款狀態,並追蹤在 smklog.com 購買託運單的貨件。
  • 讀取每月運費價格指數,計算計費體積重量並核對包裹尺寸限制。
  • 查詢假日寄件截止日期與禁運、限運規則,包括鋰電池規定。
適用情境
適合需要了解從美國寄送包裹的費用、比較不同業者、取得購買託運單的連結,以及追問付款、退款、追蹤、體積重量或寄送規則的情況。
執行需求
遠端 streamable-HTTP 端點,不需帳號、API 金鑰或 OAuth。對只能啟動本機指令的用戶端提供以 npx 或 Docker 執行的本機 stdio 橋接,可選環境變數 SMKLOG_MCP_URL、SMKLOG_MCP_TIMEOUT_MS 與 SMKLOG_MCP_DEBUG。呼叫工具需要網路連線。
安裝前請注意
報價是真實的業者呼叫,會產生費用且受速率限制,每個貨件只應查詢一次。價格已內含 SMKlog 費用,該費用僅在結帳收據中列出。伺服器本身不會扣款,但會產生由使用者隨後在 Stripe 付款的結帳連結。物品描述、郵遞區號與箱體資訊會傳送給 SMKlog 並記錄 30 天;不會要求街道地址或聯絡方式。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SMKlog Parcel Shipping Rates,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.smklog%2Fparcel-shipping-rates/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "smklog-parcel-shipping-rates": {
      "type": "http",
      "url": "https://quote-api.smklog.com/mcp"
    }
  }
}

README

[SMKlog]

SMKlog Parcel Shipping Rates — MCP Server

Live USPS, UPS, FedEx and DHL Express rates for a parcel sent from the US — domestic, or to Canada, the UK, Germany or Australia — described in plain words.
No scale. No account. No API key.

https://quote-api.smklog.com/mcp · streamable-http · MCP 2026-07-28, 2025-06-18, 2025-03-26

[Glama score] [test] [Listed on Smithery] [In the official MCP registry] [MIT license] [AllMCPs Verified]

[SMKlog on APIs.io: Kin Score by API Evangelist]


Most shipping APIs want a box: length, width, height, weight. People don't have that — they have a thing on the table and a ZIP code to send it to. This server takes the thing.

Describe "a full-size acoustic guitar in its hard case" and it estimates the packed carton, prices it live across three carriers, and hands back services you can actually buy — with the checkout total and, where the carrier publishes one, its own counter price for the same parcel side by side, so you can always show a person both numbers.

What you can ask your assistant

  • "How much to ship a 12 lb box from 07922 to 90011?"
  • "What would it cost to send a full-size acoustic guitar in a hard case from New Jersey to Los Angeles?"
  • "Compare USPS, UPS and FedEx for a 5 lb box, Newark to Chicago — which is cheapest and which is fastest?"
  • "Price a 24 × 18 × 12 in box at 22 lb going to 33101, then give me a link to buy the label."
  • "Where is my package? Tracking 9400111899561234567890."
  • "Did they pay for that label yet? Here is the session id you gave me."
  • "What has a 5 lb box to Denver cost over the last few months?"
  • "Why would a 24 × 18 × 18 in box at 6 lb cost so much to ship?"
  • "When is the last day to mail a gift by USPS for Christmas?"
  • "Can I ship a power bank?"
  • "Was that label refunded?"

Tools

ToolWhat it does
get_parcel_quoteLive rates for one parcel from a US origin, domestic or to Canada, the UK, Germany or Australia, across USPS, UPS and FedEx, plus DHL Express to Germany and Australia. Plain-words description → estimated packed box; or pass exact dimensions and weight to skip the estimate. Returns up to five purchasable services with the checkout total (SMKlog fee inside), the carrier's counter price beside it where one is published, and the delivery window.
create_checkout_linkPrices the shipment and returns a payment session: the amount, a handoff URL that opens the SMKlog checkout prefilled with this shipment, and a session_id. The human confirms the contents certification and the carrier-adjustment consent there and pays on Stripe.
get_checkout_statusWhere a payment session stands: awaiting_checkout, checkout_started, paid, label_ready (with the tracking number), delivered or refunded. Read from the order record, so it costs no carrier call and never carries names, addresses or emails. Sessions answer for 30 days.
track_parcelDelivery status, scan events and the carrier's estimated delivery date for a shipment whose label was bought on smklog.com. Not a universal tracker for arbitrary numbers.
get_price_indexThe monthly SMKlog parcel price index: six common boxes (1–20 lb) from Newark, NJ to five US cities, repriced through the same live pipeline that prices real shipments. Reading it spends no quote allowance.
get_refund_statusWhether the payment behind a checkout session was refunded, how much and why: not_paid, none, requested, under_review, declined, partially_refunded or refunded. Unused USPS labels are refunded automatically; this tool only reads and never starts a refund.
cancel_checkout_linkCancels a checkout session the human has not opened yet, so its link stops binding a checkout. Nothing has been paid at that stage, so nothing is refunded; once the human opens checkout the call is refused with session_in_checkout and the checkout stands.
calculate_billable_weightThe weight USPS, UPS and FedEx bill for a box: dimensional weight (L × W × H ÷ 139) against actual weight, rounded as each carrier rounds, and the parcel limits it meets. A calculation only: no carrier call, no quote allowance.
get_holiday_shipping_deadlinesThe carriers' own send-by dates for delivery by the 2026 winter holidays (USPS by Dec 25, FedEx by Dec 24), each marked on_track or too_late for today, with the page each date was read from. UPS publishes no fixed dates. Never a guarantee.
get_shipping_restrictionsWhat SMKlog will not ship and what ships only with conditions, including the lithium battery rules the checkout applies. A policy reference, not a verdict on one item: the quote and the checkout check each item by name.

Things worth knowing before you wire it in

A quote is a real carrier call and costs real money to produce. Call get_parcel_quote once per shipment, not once per variation you are curious about. The server is rate limited per client and will say so plainly rather than silently degrading.

Origin is the United States. Domestic lanes and US-origin exports. A lane that starts somewhere else is out of scope, and the server will tell you instead of inventing a number.

Prices are checkout totals with the SMKlog fee inside. The fee is itemized only on the checkout receipt; what comes back beside a rate is the carrier's own counter price for the same parcel, where one is published — what the person would pay walking into the carrier's counter instead. The total is what they pay.

Parcels only, one label per box. A shipment past parcel limits or described as a pallet or freight load comes back as mode: not_a_parcel with no rates: SMKlog sells parcel labels and does not arrange pallet or freight shipments. quantity counts units of the item: units that fit one box are priced as that box, while units that need more than one box — or a quantity above 1 sent with exact dimensions, which describe one box — come back as mode: multiple_boxes with no rates, so quote each box on its own.

Nothing here buys a label on its own. create_checkout_link produces a URL; a human completes the purchase, certifies the contents and consents to carrier adjustments. An agent cannot spend someone's money through this server.

Connect

json
{  "mcpServers": {    "smklog": {      "type": "http",      "url": "https://quote-api.smklog.com/mcp"    }  }}

No key, no OAuth, no signup. All ten tools are open.

Over stdio

For a client that only launches local commands — Claude Desktop, Cursor, an MCP inspector, a Docker-based runner — this repository is a thin stdio bridge to the same endpoint. No dependencies, no build step, no keys:

json
{  "mcpServers": {    "smklog": {      "command": "npx",      "args": ["-y", "github:smklog/parcel-shipping-rates-mcp"]    }  }}

Or with Docker:

sh
docker build -t smklog-parcel-shipping-rates-mcp https://github.com/smklog/parcel-shipping-rates-mcp.gitdocker run -i --rm smklog-parcel-shipping-rates-mcp

The bridge forwards every JSON-RPC message to https://quote-api.smklog.com/mcp and writes the answer back, one JSON object per line. It also mirrors the 2026-07-28 routing envelope into HTTP headers (MCP-Protocol-Version, Mcp-Method, Mcp-Name) and, on the legacy path, sends the version initialize negotiated, so both protocol eras work through it. If the endpoint cannot be reached it still answers initialize and tools/list from the snapshot shipped here (initialize.json, tools.json), so you can see what is offered; tool calls need the network. npm test drives it end to end.

Configuration

The bridge reads three optional environment variables and nothing else:

VariableDefaultWhat it does
SMKLOG_MCP_URLhttps://quote-api.smklog.com/mcpEndpoint the bridge forwards to.
SMKLOG_MCP_TIMEOUT_MS90000 (minimum 1000)Per-request timeout. A quote is a live carrier call and can take half a minute.
SMKLOG_MCP_DEBUGunset1 writes traffic summaries to stderr; stdout stays clean JSON-RPC.
json
{  "mcpServers": {    "smklog": {      "command": "npx",      "args": ["-y", "github:smklog/parcel-shipping-rates-mcp"],      "env": { "SMKLOG_MCP_TIMEOUT_MS": "120000" }    }  }}

Secrets and keys

There are none to configure. The server takes no API key, token or account, and the bridge reads no credentials. Do not put carrier, payment or other API keys into the client config for this server: nothing reads them, and a config file is the wrong place to keep a secret. Carrier and payment credentials live only on the server side.

Data and privacy

  • Quote tools take an item description, postal codes and, optionally, box size and weight. They never ask for street addresses, names, emails or phone numbers. Names, addresses and payment are entered by the person on the smklog.com checkout, not through this server.
  • The description and the box are used to price the parcel with the carriers. A recognized item is kept in our product catalog so the next quote for the same item comes out the same.
  • Each tool call is logged for 30 days: the tool, the item description, the first three characters of each postal code, the destination country, the client software family, the request's country and the outcome. No IP address, full user agent, street address or contact details are stored for this.
  • Rate limits count requests in hourly windows keyed by a one-way SHA-256 hash of the connecting IP (and of IP plus user agent); the address itself is not written.
  • Full policy: https://smklog.com/privacy.

Rated Exemplar on APIs.io (Kin Score by Kin Lane, the API Evangelist): 95.9/100, first of 36,405 rated providers and one of 705 in the Exemplar band, about the top 2% (as of November 1, 2026; the card above shows the live score).

Listed on Smithery and listed in the official MCP registry as com.smklog/parcel-shipping-rates.

Other ways in, if MCP is not your transport: OpenAPI · A2A agent card · API docs · llms.txt

Who runs it

SMKlog sells US shipping labels. The same pricing pipeline that answers this server answers the website — there is no separate "API rate". People who are not using an assistant price and buy the same labels in the shipping calculator. Questions, bugs and odd results: [email protected]. Security reports: see SECURITY.md. Changes: CHANGELOG.md.

來源:README.md,提交 748954a

工具

10

get_parcel_quote

Get live parcel shipping rates from a US origin

Live parcel rates from a US origin: USPS, UPS, FedEx; DHL Express to DE and AU. Describe the item to estimate the box, or give exact dimensions and weight. Up to five services, each a total with the SMKlog fee inside (itemized only on the checkout receipt). To buy on smklog.com: quote_id to create_checkout_link. Typical prices: get_price_index (free). Parameter rules: - weight_lb, length_in, width_in, height_in count only as a set of four above zero, else the box is estimated. - One label per box: units that fit one box are priced as that box; more boxes or a quantity above 1 sent with exact dimensions: multiple_boxes. - Over 150 lb, 108 in longest side or 165 in length plus girth, or pallet or freight: mode not_a_parcel. - product: the item, up to 200 characters; a bare route, weight or question: product_not_recognized. - from_zip: a real 5-digit US ZIP, else invalid_us_zip. - to_country: US, CA, GB, DE or AU, else international_unsupported_online; to_zip follows it. - 80 calls an hour per client.

輸入參數to_zip必填product必填from_zip必填quantitywidth_inheight_inlength_inweight_lbto_country

track_parcel

Track a SMKlog shipment

Track a shipment whose label was bought on smklog.com, by carrier tracking number: the current status, the latest scan events (newest first, up to eight) and the estimated delivery date when the carrier gives one. SMKlog labels only: not a universal tracker, so another seller's number answers not-found. Spends no quote allowance. Once a create_checkout_link session reaches label_ready, get_checkout_status hands back this number. Parameter rules: - tracking_number is the only key; no order id or email. - It is matched after removing spaces and hyphens, ignoring case. - Typical shapes: USPS 20 to 22 digits (13 characters ending in US for international), UPS 1Z plus 16 characters, FedEx 12 to 22 digits. - Under 6 characters after cleanup: tracking_number_required. A number SMKlog never sold: 404 tracking_not_found.

輸入參數tracking_number必填

get_price_index

US parcel shipping price index

The SMKlog parcel shipping price index: a monthly repriced basket of six common boxes (1 to 20 lb) shipped from Newark, NJ to five US cities, quoted through the same live USPS, UPS and FedEx pipeline that prices real shipments. Returns the cheapest purchasable service per box and lane with every rate behind it, plus basket averages. Reference data for questions like "what does shipping a shoebox cost in the US right now" — reading it spends no quote allowance. For a price on a specific shipment, call get_parcel_quote instead. Parameter rules: month names one published issue as YYYY-MM; issues exist from 2026-07 onward, one per month, and omitting month returns the newest. A month with no issue answers issue_not_found together with available_months, so one miss lists every valid value; anything not shaped YYYY-MM answers invalid_month. Every issue prices the same boxes and lanes, so two months compare cell for cell.

輸入參數month

get_checkout_status

Check a checkout session

Reports where a create_checkout_link session stands: whether the human opened checkout, paid, and whether the label exists, with the tracking number once it does. Reads SMKlog's own records only: no carrier call, no quote allowance, nothing changes. Poll minutes apart: nothing moves until the human acts. Statuses, in order: awaiting_checkout, checkout_started, paid (label not bought yet), label_ready (tracking_number present; pass it to track_parcel), delivered, refunded. Parameter rules: - session_id is the as_ plus UUID id from create_checkout_link; no order id, email or quote_id works. - A session lives 30 days; an unknown, malformed or expired id answers session_not_found. - The answer never carries names, addresses or emails; whoever holds the session_id can read the tracking number. - A manual-review request is not a checkout: the status stays awaiting_checkout. - 60 checks an hour per client.

輸入參數session_id必填

get_refund_status

Refund status of a checkout session

Says whether the payment behind a create_checkout_link session was refunded, how much and why. Status: not_paid (nothing to refund), none (paid, not refunded), requested (a refund is under way), under_review (an unused non-USPS label, decided by an operator), declined (the label was scanned, so the carrier refused the refund), partially_refunded or refunded; with amount_paid, amount_refunded, reason (unused_label: the automatic refund of a never-scanned label; other) and the refund policy in force. Unused USPS labels are refunded automatically; this tool only reads, it never starts a refund. SMKlog records only: no carrier call, no quote allowance. Parameter rules: - session_id is the as_ plus UUID id from create_checkout_link; no order id or email works. - An unknown, malformed or expired id answers session_not_found. - It reports on the checkout get_checkout_status reports. - No names, addresses, emails or card details. - 60 checks an hour per client, shared with get_checkout_status.

輸入參數session_id必填

calculate_billable_weight

Billable weight of a box

The weight USPS, UPS and FedEx bill for a box: dimensional weight (L x W x H / 139) against actual weight, rounded as each carrier rounds, and the parcel and USPS limits it meets. Explains why a big light box costs more and how small a box would bill at its real weight. A calculation only: no carrier call, no quote allowance, nothing stored; get_parcel_quote prices the box live. Parameter rules: - length_in, width_in, height_in, weight_lb: all required, above 0, at most 1000. - USPS: sides rounded up, 139 only above 1728 cubic inches; UPS and FedEx: nearest inch, every box. - Weights round up to a whole pound; USPS prices under 1 lb by the ounce. - Limits: parcel 150 lb, 108 in longest side, 165 in length plus girth; USPS 70 lb, 130 in (Ground Advantage) or 108 in (Priority Mail).

輸入參數width_in必填height_in必填length_in必填weight_lb必填

get_holiday_shipping_deadlines

Holiday shipping deadlines

The carriers’ own send-by dates for delivery by the 2026 winter holidays: USPS (Ground Advantage, Priority Mail, Priority Mail Express; delivery by Dec 25) and FedEx (Ground Economy, Ground and Home Delivery by days in transit, Express Saver, 2Day, Overnight; delivery by Dec 24), each marked on_track or too_late for today in New York, with the page each date was read from. UPS publishes no fixed dates, and the answer says so. Contiguous US only; never a guarantee and never an SMKlog estimate. No carrier call, no quote allowance. Parameter rules: - No parameters. - After Dec 24, 2026 the answer says the season is over and lists no dates. - For a real lane and service, get_parcel_quote returns each service’s delivery estimate.

無需輸入參數。

get_shipping_restrictions

Shipping restrictions and battery rules

What SMKlog will not ship and what ships only with conditions: prohibited categories (weapons, drugs, counterfeit goods, money and valuables, living and perishable contents, dangerous goods, controlled exports), restricted ones (batteries, medicine, chemicals and aerosols, regulated natural products, age-restricted goods), the lithium battery rules the checkout applies (installed: UN3481 mark, ground; power banks: UN3480, ground only, up to 100 Wh and 5 lb; larger or lithium-metal batteries reviewed by hand), how to describe an item, and the international rules. The policy published at smklog.com/shipping-restrictions. No carrier call, no quote allowance. Parameter rules: - No parameters. - A policy reference, not a verdict on one item: get_parcel_quote and the checkout check each item, by name too. - The lists are examples, not complete; carrier and destination rules can be stricter.

無需輸入參數。

版本歷史

2
  1. v1.5.0最新Nov 7, 2026
  2. v1.4.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分