Skip to main content
Glama

出口单 chukoudan

FOB/CIF/CFR 报价

baojia
Read-onlyIdempotent

FOB/CIF/CFR 报价(FOB/CIF/CFR quotes):由成本算三种术语报价和利润。 Quotes and profit on all three terms, from your cost. 输入为精确的十进制字符串 / Inputs are exact decimal strings. 正算反算都能做:mode=forward(默认)由含税采购单价、数量、征税率、退税率、汇率和目标利润率,算出 FOB 报价和利润;给了海运费就有 CFR,再给保险费率就有 CIF,佣金另算含佣价。mode=reverse 由已经报出的价格(term 和 quotedPrice)反算利润、利润率和保本价,同样给出出口退税额和含佣价。必填:含税采购单价 price、数量 quantity、征税率 taxRate、退税率 refundRate、汇率 fxRate(正算还要目标利润率 margin);汇率和退税率要用户给,不会自动取。出口退税按外贸企业(取得增值税专用发票采购)计算;生产企业的免抵退请用 tuishui。 / Works both ways: mode=forward (the default) takes the VAT-inclusive purchase price, quantity, VAT rate, refund rate, exchange rate and target margin to the FOB quote and profit, with CFR when sea freight is given and CIF when an insurance rate is given, and the commission-inclusive price on top. mode=reverse takes a price already quoted (term and quotedPrice) and gives the profit, margin and break-even price, with the export tax refund and the commission-inclusive price. Required: price, quantity, taxRate, refundRate, fxRate (forward also needs margin); the user gives the exchange rate and the refund rate, neither is looked up for you. The refund is worked as a trading company’s (goods bought on a special VAT invoice); for a manufacturer’s 免抵退 use tuishui. 用户给了海关编码,先调用 lookup_refund_rate 查退税率;要发给买方的报价单,调用 make_quote(不填汇率就用当天的中间价)。 / For a customs code call lookup_refund_rate for the refund rate first; for a quote to send to a buyer call make_quote (leave the rate out there to use the day’s central parity). 用户没有给的数字和日期不要自己编:必填的先问用户,选填的不填。 / Never make up a figure or a date the user did not give: ask for a required one, leave an optional one out. 回复时引用回答里的 provenance.source_line / Quote provenance.source_line in your reply. 结果仅供计算参考,不是税务、法律或投资意见;回答时请带上返回的说明和来源行。 / The result is for calculation and reference only, not tax, legal or investment advice; when you answer, pass on the returned notice and source line.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "mode": "forward",
      "term": "FOB",
      "price": "50",
      "fxRate": "7.0850",
      "margin": "10",
      "freight": "1800",
      "taxRate": "13",
      "currency": "USD",
      "quantity": "4500",
      "containers": "1",
      "refundRate": "13",
      "marginBasis": "quote",
      "quotedPrice": "7.50",
      "freightBasis": "container"
    },
    "name": "baojia"
  }
}

Input Schema

NameRequiredDescriptionDefault
modeNo计算方向。可选值:forward = 正算:成本 → 报价;reverse = 反算:报价 → 利润 / Direction. options: forward = Quote from cost; reverse = Profit from a quote
portNo起运港(选填) / Port of loading (optional)
termNo你报的术语。可选值:FOB = FOB;CFR = CFR;CIF = CIF / Your quote is on. options: FOB = FOB; CFR = CFR; CIF = CIF
unitNo数量单位。可选值:pcs = 件;sets = 套;cartons = 箱;kg = 千克 / Unit. options: pcs = pcs; sets = sets; cartons = cartons; kg = kg
fxPerNo汇率单位。可选值:1 = 每 1 外币;100 = 每 100 外币 / Rate quoted per. options: 1 = per 1 unit; 100 = per 100 units
priceYes含税采购单价(CNY) / Purchase price per unit, VAT included (CNY)
fxRateYes汇率 / Exchange rate
marginNo目标利润率(%) / Target margin (%)
markupNo投保加成(%) / Insured at (% of CIF)
volumeNo总体积(m3) / Total volume (m3)
freightNo海运费 / Sea freight
taxRateYes征税率(%) / VAT rate on the purchase (%)
currencyNo报价币种 / Quote currency
domesticNo国内费用(CNY) / Domestic costs (CNY)
quantityYes数量 / Quantity
commissionNo佣金率(%) / Commission rate (%)
containersNo柜数 / Containers
refundRateYes退税率(%) / Refund rate (%)
marginBasisNo利润率按。可选值:quote = 报价;cost = 成本 / Margin on. options: quote = the quote; cost = cost
quotedPriceNo你的报价单价 / Your unit price
freightBasisNo运费计价方式。可选值:container = 每柜;cbm = 每立方米;total = 合计 / Freight is charged. options: container = per container; cbm = per m³; total = for the whole order
domesticBasisNo国内费用按。可选值:total = 合计;perUnit = 每件 / Domestic costs are given. options: total = for the whole order; perUnit = per unit
insuranceRateNo保险费率(%) / Insurance rate (%)

Output Schema

NameRequiredDescriptionDefault
toolYes
linksYes
stepsYes
outputsYes
warningsYes
normalizedNo
provenanceYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / description
      Previous value: -"数字最好写成字符串(十进制,如 \"12.5\"),JSON 数字也行;千位逗号只认 1,234,567 这种写法,小数点用英文句点,不要带货币符号或单位。币种可写 USD、usd 或 美元,单位可写 cm 或 厘米,日期可写 2026-05-01、2026/05/01 或 20260501。读不准的一律拒绝并说明原因,绝不猜;回答里的 normalized 列出实际采用的值。 / Figures are best sent as decimal strings such as \"12.5\"; a JSON number is accepted too. A thousands comma only as 1,234,567; the decimal point is a dot; no currency symbols or units. A currency may be USD, usd or 美元, a unit cm or 厘米, a date 2026-05-01, 2026/05/01 or 20260501. Anything that cannot be read in exactly one way is refused with a reason, never guessed; `normalized` in the answer lists what was used."New value: +"数字最好写成字符串(十进制,如 \"12.5\"),JSON 数字也行;千位逗号只认 1,234,567 这种写法,小数点用英文句点,不要带货币符号或单位。币种可写 USD、usd 或 美元,单位可写 cm 或 厘米,日期可写 2026-05-01、2026/05/01 或 20260501。读不准的一律拒绝并说明原因,绝不猜;回答里的 normalized 列出实际采用的值。 / Figures should be sent as decimal strings such as \"12.5\"; a JSON number is accepted too. A thousands comma only as 1,234,567; the decimal point is a dot; no currency symbols or units. A currency may be USD, usd or 美元, a unit cm or 厘米, a date 2026-05-01, 2026/05/01 or 20260501. Anything that cannot be read in exactly one way is refused with a reason, never guessed; `normalized` in the answer lists what was used."
  2. Changed1 schema field changed
    • changedOutput schema / $defs / PlainValue / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "amount": {
      -        "type": "string"
      -      },
      -      "currency": {
      -        "description": "An ISO 4217 code.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "const": "money"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "amount",
      -      "currency"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "quantity"
      -      },
      -      "places": {
      -        "description": "How many decimal places the rounding rule keeps; pad to it, never round.",
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "unit": {
      -        "type": "string"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value",
      -      "unit"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "ratio"
      -      },
      -      "value": {
      -        "description": "A fraction: 0.13 is 13 %.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "type": "string"
      -      },
      -      "kind": {
      -        "const": "rate"
      -      },
      -      "per": {
      -        "description": "`per` units of `base` cost `value` units of `quote`.",
      -        "type": "string"
      -      },
      -      "quote": {
      -        "type": "string"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value",
      -      "base",
      -      "quote",
      -      "per"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "fractional": {
      -        "const": true
      -      },
      -      "grouping": {
      -        "const": false
      -      },
      -      "kind": {
      -        "const": "count"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "code"
      -      },
      -      "value": {
      -        "description": "A token from a fixed list the tool exports; the words for it are the copy key `<tool>.code.<value>`.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "date"
      -      },
      -      "value": {
      -        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "type": "string"
      +      },
      +      "currency": {
      +        "description": "An ISO 4217 code.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "money"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "amount",
      +      "currency"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "quantity"
      +      },
      +      "places": {
      +        "description": "How many decimal places the rounding rule keeps; pad to it, never round.",
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "unit": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value",
      +      "unit"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "ratio"
      +      },
      +      "places": {
      +        "description": "How many decimal places of the fraction the rounding rule keeps; write the percentage padded to two fewer (0.2820 is 28.20 %), never round.",
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "value": {
      +        "description": "A fraction: 0.13 is 13 %.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "rate"
      +      },
      +      "per": {
      +        "description": "`per` units of `base` cost `value` units of `quote`.",
      +        "type": "string"
      +      },
      +      "quote": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value",
      +      "base",
      +      "quote",
      +      "per"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "fractional": {
      +        "const": true
      +      },
      +      "grouping": {
      +        "const": false
      +      },
      +      "kind": {
      +        "const": "count"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "code"
      +      },
      +      "value": {
      +        "description": "A token from a fixed list the tool exports; the words for it are the copy key `<tool>.code.<value>`.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "date"
      +      },
      +      "value": {
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "identifier"
      +      },
      +      "value": {
      +        "description": "A number that is data, such as a barcode number: write it as it is, keep its leading zeros, never group it.",
      +        "pattern": "^[A-Za-z0-9]{1,32}$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed3 schema fields changed
    • changedOutput schema / $defs / PlainValue / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "amount": {
      -        "type": "string"
      -      },
      -      "currency": {
      -        "description": "An ISO 4217 code.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "const": "money"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "amount",
      -      "currency"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "quantity"
      -      },
      -      "places": {
      -        "description": "How many decimal places the rounding rule keeps; pad to it, never round.",
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "unit": {
      -        "type": "string"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value",
      -      "unit"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "ratio"
      -      },
      -      "value": {
      -        "description": "A fraction: 0.13 is 13 %.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "type": "string"
      -      },
      -      "kind": {
      -        "const": "rate"
      -      },
      -      "per": {
      -        "description": "`per` units of `base` cost `value` units of `quote`.",
      -        "type": "string"
      -      },
      -      "quote": {
      -        "type": "string"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value",
      -      "base",
      -      "quote",
      -      "per"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "grouping": {
      -        "const": false
      -      },
      -      "kind": {
      -        "const": "count"
      -      },
      -      "value": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "code"
      -      },
      -      "value": {
      -        "description": "A token from a fixed list the tool exports; the words for it are the copy key `<tool>.code.<value>`.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "date"
      -      },
      -      "value": {
      -        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "value"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "type": "string"
      +      },
      +      "currency": {
      +        "description": "An ISO 4217 code.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "money"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "amount",
      +      "currency"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "quantity"
      +      },
      +      "places": {
      +        "description": "How many decimal places the rounding rule keeps; pad to it, never round.",
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "unit": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value",
      +      "unit"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "ratio"
      +      },
      +      "value": {
      +        "description": "A fraction: 0.13 is 13 %.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "rate"
      +      },
      +      "per": {
      +        "description": "`per` units of `base` cost `value` units of `quote`.",
      +        "type": "string"
      +      },
      +      "quote": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value",
      +      "base",
      +      "quote",
      +      "per"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "fractional": {
      +        "const": true
      +      },
      +      "grouping": {
      +        "const": false
      +      },
      +      "kind": {
      +        "const": "count"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "code"
      +      },
      +      "value": {
      +        "description": "A token from a fixed list the tool exports; the words for it are the copy key `<tool>.code.<value>`.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "date"
      +      },
      +      "value": {
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "value"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / $defs / ProvenanceDataset / properties / amended_by
      Added value: +{
      +  "description": "The official notices whose changes this version carries on top of its edition, where there are any: each one by its number and title as the notice writes them and its own date (no page is given). The label a reader sees is the edition and these, for example 2026B + 公告2026年第29号.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "day": {
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +        "type": "string"
      +      },
      +      "number": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "number",
      +      "title",
      +      "day"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / $defs / ProvenanceDataset / properties / edition
      Added value: +{
      +  "description": "The publisher’s name for the edition (2026B), where it names them.",
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "containers": "1",
      +    "currency": "USD",
      +    "freight": "1800",
      +    "freightBasis": "container",
      +    "fxRate": "7.0850",
      +    "margin": "10",
      +    "marginBasis": "quote",
      +    "mode": "forward",
      +    "price": "50",
      +    "quantity": "4500",
      +    "quotedPrice": "7.50",
      +    "refundRate": "13",
      +    "taxRate": "13",
      +    "term": "FOB"
      +  }
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "Links": {
      +      "additionalProperties": false,
      +      "description": "Addresses that go with the answer. `page`: the tool’s page on the site with the same inputs in its address, in the language asked (Chinese for a language the site does not publish yet), so a person can open the page that shows these numbers.",
      +      "properties": {
      +        "page": {
      +          "description": "The tool’s page holding these inputs.",
      +          "format": "uri",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "page"
      +      ],
      +      "type": "object"
      +    },
      +    "Normalized": {
      +      "description": "What the API changed in the inputs before core saw them, so the caller sees what was understood: a JSON number as text, a thousands comma, full-width digits, a currency or unit name or a date written another way. Absent when nothing was changed.",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "given": {
      +            "description": "What was sent, as text.",
      +            "type": "string"
      +          },
      +          "path": {
      +            "description": "The input, like `cartons.0.length`.",
      +            "type": "string"
      +          },
      +          "used": {
      +            "description": "What core was given.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "path",
      +          "given",
      +          "used"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "PlainValue": {
      +      "description": "A figure, tagged so a reader knows how to write it: amounts and quantities are exact decimal strings, never floats.",
      +      "oneOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "amount": {
      +              "type": "string"
      +            },
      +            "currency": {
      +              "description": "An ISO 4217 code.",
      +              "type": "string"
      +            },
      +            "kind": {
      +              "const": "money"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "amount",
      +            "currency"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "kind": {
      +              "const": "quantity"
      +            },
      +            "places": {
      +              "description": "How many decimal places the rounding rule keeps; pad to it, never round.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "unit": {
      +              "type": "string"
      +            },
      +            "value": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value",
      +            "unit"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "kind": {
      +              "const": "ratio"
      +            },
      +            "value": {
      +              "description": "A fraction: 0.13 is 13 %.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "base": {
      +              "type": "string"
      +            },
      +            "kind": {
      +              "const": "rate"
      +            },
      +            "per": {
      +              "description": "`per` units of `base` cost `value` units of `quote`.",
      +              "type": "string"
      +            },
      +            "quote": {
      +              "type": "string"
      +            },
      +            "value": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value",
      +            "base",
      +            "quote",
      +            "per"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "grouping": {
      +              "const": false
      +            },
      +            "kind": {
      +              "const": "count"
      +            },
      +            "value": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "kind": {
      +              "const": "code"
      +            },
      +            "value": {
      +              "description": "A token from a fixed list the tool exports; the words for it are the copy key `<tool>.code.<value>`.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "kind": {
      +              "const": "date"
      +            },
      +            "value": {
      +              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "value"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "Provenance": {
      +      "additionalProperties": false,
      +      "description": "Where the figures in an answer come from. In every answer, errors included.",
      +      "properties": {
      +        "api": {
      +          "const": "v1"
      +        },
      +        "datasets": {
      +          "items": {
      +            "$ref": "#/$defs/ProvenanceDataset"
      +          },
      +          "type": "array"
      +        },
      +        "generated_at": {
      +          "description": "When the answer was made.",
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "language": {
      +          "description": "The language of the source lines.",
      +          "enum": [
      +            "zh-CN",
      +            "en",
      +            "ja",
      +            "ko"
      +          ]
      +        },
      +        "license": {
      +          "additionalProperties": false,
      +          "description": "The license as copy keys: which text applies. `status` was `draft` until the text was approved (2026-10-12) and is `approved` now.",
      +          "properties": {
      +            "ours": {
      +              "type": "string"
      +            },
      +            "status": {
      +              "enum": [
      +                "draft",
      +                "approved"
      +              ]
      +            },
      +            "underlying": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "ours",
      +            "underlying"
      +          ],
      +          "type": "object"
      +        },
      +        "notice": {
      +          "description": "本站非官方渠道的说明:引用本站数据时请和来源行一起转述。 / The site’s own line that it is not an official channel: pass it on with the source line when you quote us.",
      +          "type": "string"
      +        },
      +        "site": {
      +          "description": "The site the data is published by.",
      +          "type": "string"
      +        },
      +        "source_line": {
      +          "description": "来源行:回复用户时请原样引用它,让读者知道数据出自哪里、有多新。 / The credit line to quote as it is when you answer: who the figures come from and how fresh they are (the newest publisher’s day among the datasets used, or the day the answer was made).",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "api",
      +        "site",
      +        "generated_at",
      +        "language",
      +        "source_line",
      +        "notice",
      +        "datasets",
      +        "license"
      +      ],
      +      "type": "object"
      +    },
      +    "ProvenanceDataset": {
      +      "additionalProperties": false,
      +      "description": "A dataset version an answer drew on. An origin the register does not let the site show is named nowhere.",
      +      "properties": {
      +        "id": {
      +          "description": "The dataset.",
      +          "type": "string"
      +        },
      +        "origin": {
      +          "description": "The origin’s id in the register; null when the site may not show it.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "published_at": {
      +          "description": "The publisher’s own date (and time, with its offset, when it gives one).",
      +          "type": "string"
      +        },
      +        "source": {
      +          "description": "The publisher’s own source line, in the answer’s language; null when there is none to show.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "source_url": {
      +          "description": "The publisher’s page, only where the register lets the site link to it.",
      +          "type": "string"
      +        },
      +        "version": {
      +          "description": "Its version, named after the publisher’s date.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "version",
      +        "published_at",
      +        "origin",
      +        "source"
      +      ],
      +      "type": "object"
      +    },
      +    "Step": {
      +      "additionalProperties": false,
      +      "description": "One line of the worked example: `id` is the copy key of its sentence, `values` fill it in.",
      +      "properties": {
      +        "id": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "description": "这一步的一句话说明,数值已代入,用请求的语言。 / The step as one sentence in the language asked, its figures filled in. Absent when a sentence cannot be made whole.",
      +          "type": "string"
      +        },
      +        "values": {
      +          "additionalProperties": {
      +            "$ref": "#/$defs/PlainValue"
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "values"
      +      ],
      +      "type": "object"
      +    },
      +    "Warning": {
      +      "additionalProperties": false,
      +      "description": "Something a reader should know about a result; `code` is a copy key.",
      +      "properties": {
      +        "code": {
      +          "type": "string"
      +        },
      +        "level": {
      +          "description": "Absent means a caution.",
      +          "enum": [
      +            "note",
      +            "hint"
      +          ]
      +        },
      +        "message": {
      +          "description": "这条提醒的一句话说明,数值已代入,用请求的语言:回复时请用它,不要自己编数字。 / The warning as one sentence in the language asked, its figures filled in: use it, do not make up figures. Absent when a sentence cannot be made whole.",
      +          "type": "string"
      +        },
      +        "next": {
      +          "description": "For a hint: the slug of the tool it points to.",
      +          "type": "string"
      +        },
      +        "values": {
      +          "additionalProperties": {
      +            "$ref": "#/$defs/PlainValue"
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "values"
      +      ],
      +      "type": "object"
      +    },
      +    "baojiaOutputs": {
      +      "additionalProperties": {
      +        "$ref": "#/$defs/PlainValue"
      +      },
      +      "description": "Each figure core returns, by id, as a tagged value. The ids listed are the ones the tool’s manifest names; a tool may return more (a figure that only its worked steps use), in the same form.",
      +      "properties": {
      +        "breakEvenCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "breakEvenCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "breakEvenFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionPriceCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionPriceCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionPriceFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionTotalCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionTotalCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "commissionTotalFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "costTotal": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginAltCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginAltCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginAltFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "marginFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "priceCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "priceCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "priceFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "profitCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "profitCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "profitFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "refundTotal": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "totalCfr": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "totalCif": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "totalFob": {
      +          "$ref": "#/$defs/PlainValue"
      +        }
      +      },
      +      "required": [
      +        "priceFob",
      +        "totalFob",
      +        "profitFob",
      +        "breakEvenFob",
      +        "refundTotal",
      +        "costTotal"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "links": {
      +      "$ref": "#/$defs/Links"
      +    },
      +    "normalized": {
      +      "$ref": "#/$defs/Normalized"
      +    },
      +    "outputs": {
      +      "$ref": "#/$defs/baojiaOutputs"
      +    },
      +    "provenance": {
      +      "$ref": "#/$defs/Provenance"
      +    },
      +    "steps": {
      +      "items": {
      +        "$ref": "#/$defs/Step"
      +      },
      +      "type": "array"
      +    },
      +    "tool": {
      +      "const": "baojia"
      +    },
      +    "warnings": {
      +      "items": {
      +        "$ref": "#/$defs/Warning"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "tool",
      +    "outputs",
      +    "steps",
      +    "warnings",
      +    "links",
      +    "provenance"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Beyond the readOnly/idempotent/closed-world annotations, it discloses the refund methodology (trading company with a special VAT invoice), that fx rate and refund rate are never looked up for you, the no-guessing/refusal policy for missing figures, the requirement to quote provenance.source_line and the notice, and the liability disclaimer. This is exactly the context annotations cannot carry.

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

Conciseness3/5

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

The content is well ordered — purpose, modes, required inputs, sibling routing, refusal policy, provenance — but the full Chinese/English duplication roughly doubles the length and makes it slow to scan for an agent already conditioned on one language.

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

Completeness4/5

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

For a 23-parameter calculator with an output schema, it covers the decision-critical parts: mode selection, conditional term escalation, required vs. optional inputs, and refusal behavior, so return values need not be described. A few inputs (markup, unit, currency, fxPer, containers/volume) are left entirely to the schema.

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, but the description adds cross-parameter semantics the schema cannot: the required set plus margin only in forward mode, term+quotedPrice for reverse, freight enabling CFR, insuranceRate enabling CIF, and commission producing a commission-inclusive price. It does not explain the less obvious knobs (markup, freightBasis, domesticBasis, fxPer), which the schema handles.

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: computing FOB/CFR/CIF quotes and profit from cost (mode=forward) or profit/margin/break-even from a quoted price (mode=reverse). It also names the siblings it is not — lookup_refund_rate for a customs code, make_quote for a buyer-facing quote, tuishui for a manufacturer's 免抵退 — so an agent can route correctly without opening another schema.

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?

Explicit routing rules: use lookup_refund_rate first when the user gives a customs code, use make_quote when the output is a quote to send to a buyer, use tuishui for manufacturer refunds. It also states which mode is the default and what triggers each optional term (freight → CFR, insurance rate → CIF).

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