Skip to main content
Glama

0523 Public — Taiwan Logistics & Customs

好運器集運運費試算

lucky_freight_quote
Read-onlyIdempotent

試算好運器(0523.tw)中國→台灣集運運費,與官方試算機 https://0523.tw/c/ 同一份後端實作。金額一律新台幣 TWD。method 可選 sea 海快(預設)、air 空運、lcl 海雜櫃。規則:海快 計費重=max(實重, 材積重) 無條件進位至整數公斤,材積重=長×寬×高(cm)÷10000,計費單位未滿 10 加收 NT$100 小包派件費;空運「只計實重」(不計材積),計費重=實重無條件進位,實重未滿 10 kg 加收 NT$120;海雜櫃只回起價(每公斤 NT$25 起或每材積 NT$150 起,材積=長×寬×高(cm)÷28316),運費依商品不同、需由客服報價,本工具不提供海雜櫃的確定金額。不帶任何參數=回傳現行費率表;海快帶 weight(kg)或 length/width/height(cm,三者齊)、空運帶 weight =實際試算;method=lcl 一律回海雜櫃起價與報價前要準備的資料(有給尺寸時附材積數;尺寸須三者齊),不論有沒有帶 weight 或尺寸。成功回應都帶 continue_url(接續網址):費率表與海快/空運試算結果指向官方試算機(試算結果的網址會預填已提供的重量與尺寸;試算機要填齊長、寬、高與重量才會顯示金額),海雜櫃指向客服聯絡頁 https://0523.tw/contact。試算僅供參考,實際以入倉丈量後帳單為準。

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "lucky_freight_quote"
  }
}

Input Schema

NameRequiredDescriptionDefault
widthNo包裹寬(公分)。
heightNo包裹高(公分)。
lengthNo包裹長(公分,三個尺寸要一起給;海快計材積重、海雜櫃算材積數用,空運不採計)。
methodNo運送方式:sea 海快(預設)/ air 空運(只計實重,必帶 weight)/ lcl 海雜櫃(只回起價、需客服報價,不提供確定金額)。
weightNo包裹實際重量(公斤)。海快、海雜櫃可與尺寸擇一;空運必填。

Output Schema

NameRequiredDescriptionDefault
dataYes完整結構化結果。欄位依工具而異,與 content[0].text 內附的 JSON 完全相同。
sourceYes資料來源,固定為 0523.tw。引用時請註明。
summaryYes一行白話結論,已把關鍵數字算好,可直接引用回覆使用者;無摘要時為空字串。

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / length / description
      Previous value: -"包裹長(公分,三個尺寸要一起給;僅海快計材積用,空運不採計)。"New value: +"包裹長(公分,三個尺寸要一起給;海快計材積重、海雜櫃算材積數用,空運不採計)。"
    • changedInput schema / properties / method / description
      Previous value: -"運送方式:sea 海快(預設)/ air 空運(只計實重,必帶 weight)。"New value: +"運送方式:sea 海快(預設)/ air 空運(只計實重,必帶 weight)/ lcl 海雜櫃(只回起價、需客服報價,不提供確定金額)。"
    • changedInput schema / properties / method / enum
      Previous value: -[
      -  "sea",
      -  "air"
      -]New value: +[
      +  "sea",
      +  "air",
      +  "lcl"
      +]
    • changedInput schema / properties / weight / description
      Previous value: -"包裹實際重量(公斤)。海快可與尺寸擇一;空運必填。"New value: +"包裹實際重量(公斤)。海快、海雜櫃可與尺寸擇一;空運必填。"
  2. First observed

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, and the description goes well beyond them: billing-weight formulas, rounding rules, NT$100/120 small-parcel surcharges, the lcl pricing basis, the continue_url returned on every success, and the caveat that quotes are indicative pending warehouse measurement. That is substantive behavioral context an agent could not infer.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and the no-parameter behavior are front-loaded, and most sentences carry real information about pricing rules. It is dense and repeats some schema-provided detail (method enum meanings, weight requirements), which keeps it from being a model of concision, but little is truly wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-mode pricing tool with five optional parameters, the description covers rate-table mode, all three shipping modes, the rounding and surcharge rules, and the reference-only disclaimer. An output schema exists, yet the description still usefully explains continue_url, leaving nothing an agent needs to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description nevertheless adds meaning by giving the volumetric divisors (÷10000 vs ÷28316), the requirement that all three dimensions be supplied together, and the default of sea. It mostly restates the method enum semantics that the schema already documents, so it stops short of a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — 試算 (calculate) 中國→台灣集運運費 for 好運器 (0523.tw) — and adds that it shares the same backend as the official calculator. This is unmistakably distinct from siblings like lucky_import_tax_estimate or lucky_hct_oversize_fee.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly maps inputs to behaviors: no parameters returns the current rate table; sea with weight or all three dimensions produces a quote; air requires weight; method=lcl always returns only a starting price plus the info needed for a customer-service quote. It even states the exclusion that lcl never returns a definite amount, so the agent knows when not to rely on it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources