Tax Reclaim calculator
Estimate dividend and interest withholding-tax refunds, treaty rates and filing deadlines.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"calculator": {
"url": "https://api.taxreclaim.eu/api/mcp"
}
}
}Remote-Endpunkte
https://api.taxreclaim.eu/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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"
}Community
Nachweis