Tax Reclaim calculator
Estimate dividend and interest withholding-tax refunds, treaty rates and filing deadlines.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"calculator": {
"url": "https://api.taxreclaim.eu/api/mcp"
}
}
}远程端点
https://api.taxreclaim.eu/api/mcpstreamable-http它能做什么
工具清单
工具(4)
🟢estimate_refund(source_country, residence_country, income_type, gross_amount, payment_date, ...)
Estimate the reclaimable withholding tax on one dividend or interest payment for a source/residence country pair, with the treaty rate, filing form and deadline. Country codes are ISO alpha-2; payment_date is YYYY-MM-DD.
输入模式
{
"type": "object",
"properties": {
"source_country": {
"maxLength": 2,
"minLength": 2,
"title": "Source Country",
"type": "string"
},
"residence_country": {
"maxLength": 2,
"minLength": 2,
"title": "Residence Country",
"type": "string"
},
"income_type": {
"default": "dividend",
"enum": [
"dividend",
"interest"
],
"title": "Income Type",
"type": "string"
},
"gross_amount": {
"minimum": 0,
"title": "Gross Amount",
"type": "number"
},
"payment_date": {
"description": "ISO date YYYY-MM-DD",
"title": "Payment Date",
"type": "string"
},
"tax_payment_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Authoritative withholding-tax payment date when the deadline runs from tax payment",
"title": "Tax Payment Date"
},
"withheld_rate_pct": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Withheld Rate Pct"
},
"withheld_amount": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Withheld Amount"
},
"entity_type": {
"default": "retail",
"enum": [
"retail",
"corporate"
],
"title": "Entity Type",
"type": "string"
},
"holding_pct": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Holding Pct"
},
"holding_months": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Holding Months"
},
"is_franked": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Franked"
},
"is_portfolio_interest": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Portfolio Interest"
},
"is_arms_length": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Arms Length"
}
},
"required": [
"source_country",
"residence_country",
"gross_amount",
"payment_date"
],
"additionalProperties": false,
"title": "RefundArgs"
}🟢list_countries
List supported source and residence countries, domestic withholding rates and the payment years that may still be reclaimable.
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false,
"title": "NoArgs"
}🟢get_deadline(country, treaty_partner)
Get the withholding-tax reclaim deadline rule for a source country, optionally for a specific residence (treaty partner) country.
输入模式
{
"type": "object",
"properties": {
"country": {
"description": "ISO alpha-2 source country",
"maxLength": 2,
"minLength": 2,
"title": "Country",
"type": "string"
},
"treaty_partner": {
"anyOf": [
{
"maxLength": 2,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO alpha-2 residence country, for treaty exceptions",
"title": "Treaty Partner"
}
},
"required": [
"country"
],
"additionalProperties": false,
"title": "DeadlineArgs"
}🟢estimate_dividends(residence_country, residence_currency, csv_text, broker, column_map, ...)
Estimate the reclaimable withholding tax for a whole dividend history in one call: send either a broker export as csv_text with its broker id, or a list of payments (ISIN, payment_date YYYY-MM-DD, gross_amount, currency, optional withheld_amount), max 500. Returns each payment with its source country, treaty rate, reclaimable amount in the residence currency, form and deadline, plus totals per source country. A payment whose source country cannot be resolved is returned as unresolved with no amount; withheld_is_estimated marks a withholding figure estimated from the statutory rate.
输入模式
{
"type": "object",
"properties": {
"residence_country": {
"description": "ISO alpha-2",
"maxLength": 2,
"minLength": 2,
"title": "Residence Country",
"type": "string"
},
"residence_currency": {
"default": "EUR",
"description": "ISO 4217",
"maxLength": 3,
"minLength": 3,
"title": "Residence Currency",
"type": "string"
},
"csv_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Broker export as text",
"title": "Csv Text"
},
"broker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One of: avanza, bux, degiro, etoro, freetrade, ibkr, ibkr_flex, nordnet, rabobank, revolut, saxo, schwab, swissquote, trade_republic, trading212, xtb, or generic (needs column_map)",
"title": "Broker"
},
"column_map": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "generic only: target field -> CSV column (asset_name, payment_date, gross_amount, ...)",
"title": "Column Map"
},
"payments": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Payment"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Payments"
}
},
"required": [
"residence_country"
],
"$defs": {
"Payment": {
"additionalProperties": false,
"properties": {
"isin": {
"maxLength": 20,
"minLength": 1,
"title": "Isin",
"type": "string"
},
"payment_date": {
"format": "date",
"title": "Payment Date",
"type": "string"
},
"gross_amount": {
"maximum": 1000000000000,
"minimum": 0,
"title": "Gross Amount",
"type": "number"
},
"currency": {
"description": "ISO 4217",
"maxLength": 3,
"minLength": 3,
"title": "Currency",
"type": "string"
},
"withheld_amount": {
"anyOf": [
{
"maximum": 1000000000000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Tax withheld at source; omit if unknown and it is estimated",
"title": "Withheld Amount"
},
"income_type": {
"default": "dividend",
"enum": [
"dividend",
"interest"
],
"title": "Income Type",
"type": "string"
},
"asset_name": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Asset Name"
}
},
"required": [
"isin",
"payment_date",
"gross_amount",
"currency"
],
"title": "Payment",
"type": "object"
}
},
"additionalProperties": false,
"title": "DividendsArgs"
}社区
证据