Skip to main content
Glama

出口单 chukoudan

结汇成本计算器

fx-cost
Read-onlyIdempotent

结汇成本计算器(FX conversion cost calculator):比较银行和其他方式一年到手多少人民币。 Compare banks and other options: how much RMB you actually get in a year. 读取数据 / Reads: central-parity@current. 输入为精确的十进制字符串 / Inputs are exact decimal strings. 用户没有给的数字和日期不要自己编:必填的先问用户,选填的不填。 / 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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
useBNo添加方案 B / Add option B
useCNo添加方案 C / Add option C
nameBNo方案 B 的名称 / Option B’s name
nameCNo方案 C 的名称 / Option C’s name
bankFeeNo银行的每笔费用(CNY) / Bank’s fee per payment (CNY)
receiptsYes收汇情况 / Your receipts
feePercentBNo方案 B 的费率(%) / Option B’s fee rate (%)
feePercentCNo方案 C 的费率(%) / Option C’s fee rate (%)
feePerReceiptBNo方案 B 的每笔费用(CNY) / Option B’s fee per payment (CNY)
feePerReceiptCNo方案 C 的每笔费用(CNY) / Option C’s fee per payment (CNY)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
toolYes
linksYes
stepsYes
outputsYes
warningsYes
normalizedNo
provenanceYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "bankFee": "50",
      +    "feePerReceiptB": "0",
      +    "feePercentB": "0.3",
      +    "receipts": [
      +      {
      +        "amount": "100000",
      +        "bankRate": "7.0800",
      +        "count": "1",
      +        "currency": "USD",
      +        "rateB": "7.1000"
      +      }
      +    ],
      +    "useB": true
      +  }
      +]
    • 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"
      +    },
      +    "fx_costOutputs": {
      +      "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": {
      +        "annualB": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "annualBank": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "annualC": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "annualMidpoint": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "best": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "costB": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "costBank": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "costC": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "feesB": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "feesBank": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "feesC": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "gainB": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "gainBank": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "gainC": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "rankB": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "rankBank": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "rankC": {
      +          "$ref": "#/$defs/PlainValue"
      +        }
      +      },
      +      "required": [
      +        "annualBank",
      +        "feesBank",
      +        "costBank",
      +        "gainBank",
      +        "rankBank",
      +        "annualMidpoint",
      +        "best"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "links": {
      +      "$ref": "#/$defs/Links"
      +    },
      +    "normalized": {
      +      "$ref": "#/$defs/Normalized"
      +    },
      +    "outputs": {
      +      "$ref": "#/$defs/fx_costOutputs"
      +    },
      +    "provenance": {
      +      "$ref": "#/$defs/Provenance"
      +    },
      +    "steps": {
      +      "items": {
      +        "$ref": "#/$defs/Step"
      +      },
      +      "type": "array"
      +    },
      +    "tool": {
      +      "const": "fx-cost"
      +    },
      +    "warnings": {
      +      "items": {
      +        "$ref": "#/$defs/Warning"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "tool",
      +    "outputs",
      +    "steps",
      +    "warnings",
      +    "links",
      +    "provenance"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already establish a safe read-only, idempotent, closed-world operation, and the description adds genuinely new behavior: it declares the external dependency (central-parity@current), the refusal policy for ambiguous input ('读不准的一律拒绝并说明原因,绝不猜'), and the normalized/provenance fields in the reply. That is real context beyond the structured safety hints.

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 data source are front-loaded and each sentence carries actionable content (input format, no-fabrication rule, provenance citation). Length is inflated by full bilingual duplication, which is audience-driven rather than padding, so it stays efficient but is not maximally tight.

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?

With an output schema present, the description needn't restate return values, and it correctly focuses on inputs, data dependency, and refusal/normalization semantics for a 10-parameter tool. Only the missing sibling-routing guidance (fx-convert vs fx-cost) keeps it from being fully complete.

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

Parameters3/5

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

Schema description coverage is 100% and every property (useB, receipts, feePercentB, bankFee, etc.) is documented in the schema itself, so the baseline is 3. The description only reinforces the decimal-string format rather than adding per-parameter meaning beyond the schema.

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

Purpose4/5

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

The description names a specific verb and resource ('结汇成本计算器' / FX conversion cost calculator) and states the outcome it produces ('compare banks and other options: how much RMB you actually get in a year'), so an agent knows what it computes. It does not, however, distinguish itself from the sibling fx-convert, leaving the boundary between the two to inference.

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

Usage Guidelines2/5

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

The guidance present ('用户没有给的数字和日期不要自己编', 'Reads: central-parity@current') governs how to fill parameters and where data comes from, not when to choose this tool over fx-convert or the other siblings. There is no when-to-use / when-not-to-use statement and no named alternative.

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