Skip to main content
Glama

出口单 chukoudan

出口退税计算器

tuishui
Read-onlyIdempotent

出口退税计算器(Export tax refund calculator):填发票金额和退税率,立刻看到应退税额和每一步的出处。 Trading companies (exempt-and-refund) and manufacturers (exempt-credit-refund). 读取数据 / Reads: refund-rates@current, 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
modeNo计算方式。可选值:period = 按申报期计算;order = 单笔估算 / How to work it out. options: period = For a filing period; order = One-order estimate
exportsYes出口货物 / Exported goods
inputTaxNo当期进项税额(CNY) / Input VAT this period (CNY)
outputTaxNo当期内销销项税额(CNY) / Output VAT on domestic sales this period (CNY)
carriedCreditNo上期留抵税额(CNY) / Credit carried from the last period (CNY)
enterpriseTypeYes企业类型。可选值:trading = 外贸企业(免退税);manufacturer = 生产企业(免抵退) / Business type. options: trading = Trading company (exempt-and-refund); manufacturer = Manufacturer (exempt-credit-refund)
declaredEndCreditNo申报表的期末留抵税额(可选)(CNY) / Period-end credit on the VAT return (optional) (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: +[
      +  {
      +    "enterpriseType": "trading",
      +    "exports": [
      +      {
      +        "exportDate": "2026-09-24",
      +        "hsCode": "61091000",
      +        "invoiceAmount": "100000",
      +        "refundRate": "13",
      +        "taxRate": "13"
      +      }
      +    ]
      +  }
      +]
    • 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"
      +    },
      +    "tuishuiOutputs": {
      +      "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": {
      +        "basis": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "carriedForward": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "costAddition": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "endCredit": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "exempted": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "exemption": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "exemptionOffset": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "inputVat": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "nonCreditable": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "nonCreditableOffset": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "refund": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "taxDue": {
      +          "$ref": "#/$defs/PlainValue"
      +        },
      +        "taxPayable": {
      +          "$ref": "#/$defs/PlainValue"
      +        }
      +      },
      +      "required": [],
      +      "type": "object"
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "links": {
      +      "$ref": "#/$defs/Links"
      +    },
      +    "normalized": {
      +      "$ref": "#/$defs/Normalized"
      +    },
      +    "outputs": {
      +      "$ref": "#/$defs/tuishuiOutputs"
      +    },
      +    "provenance": {
      +      "$ref": "#/$defs/Provenance"
      +    },
      +    "steps": {
      +      "items": {
      +        "$ref": "#/$defs/Step"
      +      },
      +      "type": "array"
      +    },
      +    "tool": {
      +      "const": "tuishui"
      +    },
      +    "warnings": {
      +      "items": {
      +        "$ref": "#/$defs/Warning"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "tool",
      +    "outputs",
      +    "steps",
      +    "warnings",
      +    "links",
      +    "provenance"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, closed-world behavior, so the description isn't carrying the safety burden. It still adds real behavioral context: inputs must be exact decimal strings, values that cannot be read unambiguously are refused with a reason rather than guessed, and the caller must cite provenance.source_line in the reply. That is meaningful operational detail beyond the annotations.

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

Conciseness5/5

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

The purpose is front-loaded in the first clause, followed by data sources, input conventions, and an anti-fabrication rule. Every sentence carries a distinct constraint; the bilingual duplication is a deliberate inclusion choice rather than filler.

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?

An output schema exists, so return values (including provenance and normalized) need not be documented, and the description correctly points at provenance.source_line instead. With 100% schema coverage and clear safety annotations, the only missing element is explicit routing against alternative tools.

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 parameter carries a bilingual description, so the schema does the heavy lifting — the baseline of 3 applies. The description reinforces the exact-decimal-string input convention but adds no per-parameter meaning beyond what the schema already documents.

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?

States a concrete verb+resource: given invoice amount and refund rate, it computes the refundable tax and shows each step's derivation, and it names the two regimes (trading/exempt-and-refund, manufacturer/exempt-credit-refund). It also discloses the data it reads (refund-rates@current, central-parity@current), which implicitly separates it from the rate-lookup sibling. It never names lookup_refund_rate or the quote siblings outright, so the differentiation is inferential rather than explicit.

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

Usage Guidelines3/5

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

The description tells the agent how to behave inside the call (ask for required figures, omit optional ones, quote provenance) and which enterprise regimes apply, but it gives no when-to-use/when-not guidance against siblings such as lookup_refund_rate or make_quote. Usage is implied by the calculation framing rather than stated.

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