DoubleTaxation

Comprueba tu residencia fiscal entre dos países y descubre dónde y qué impuestos debes pagar, con normas de convenios, fuentes legales, próximos pasos, impuesto de salida, regímenes fiscales y formas jurídicas empresariales.

Servidor MCP alojado

npx add-mcp 'https://doubletaxation.app/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

DoubleTaxation MCP server

Connect DoubleTaxation to Claude or another AI assistant. The assistant can then check a person's tax residence between two countries, explain where and which taxes apply with the legal basis, say what to do next (certificate of residence, filing obligations, leaving a country, the year of the move, exit tax), show the tax burden on salaries, search special tax regimes for individuals, compare a sole proprietorship with a company and count days of stay from the trips the user gives. The result is computed by the same rules engine as this website.

Server URL: https://doubletaxation.app/api/mcp
Sign-in: none · Tools: read-only · Price: free

Connect

Claude (web, desktop, mobile)

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name: DoubleTaxation; URL: https://doubletaxation.app/api/mcp. Authentication: No sign-in.
  3. In a chat, ask, for example: “Am I a tax resident of Ukraine or Poland? I'm a Ukrainian citizen living in Warsaw since March.”

Claude Code

claude mcp add --transport http doubletaxation https://doubletaxation.app/api/mcp

Other MCP clients

Any client that supports remote MCP servers over Streamable HTTP can use the same URL without credentials.

Example prompts

  • “I'm a U.S. citizen working in Germany for 8 months this year. Where am I tax resident and do I still file in the U.S.?”
  • “Jestem Polakiem, pracuję w Wielkiej Brytanii — gdzie płacę podatki od pensji i dywidend z Polski?”
  • “Compare income tax and social contributions on a 60,000 EUR salary in Spain, Italy and Poland.”
  • “Which tax regimes for people relocating are still open in Italy and Spain?”
  • “I do IT consulting in Poland: 60,000 EUR revenue, 6,000 EUR costs. Sole proprietorship on the lump-sum tax or an LLC?”
  • “I want to open an online shop in Ukraine: about 1.2 million UAH revenue, 900,000 UAH costs. Which form and tax system costs least?”
  • “I'm leaving Germany this year. Does Germany charge an exit tax, and what do I have to file?”
  • “Я громадянин України, живу в Польщі з березня, родина в Києві. Де я податковий резидент?”
  • “Ich wohne seit Februar in Wien, meine Familie lebt noch in München. Wo bin ich steuerlich ansässig?”
  • “Je travaille à Lisbonne depuis avril, mais mon foyer reste à Lyon. Suis-je encore résident fiscal en France?”

How a residence check works

  1. The assistant picks the version for the user's home country (list_versions) and the other country (list_countries).
  2. It calls check_residency without answers. The server returns "status": "needs_answer" and the next question: its id, text, hint and options.
  3. The assistant asks the user and calls again with all answers so far, e.g. "answers": { "home.UA": "yes", "days.OTHER": 200 }. Only the questions needed for this person are asked.
  4. When the answers are complete, the server returns "status": "done". The result contains the conclusion and reliability score, how each country's law treats the person, the treaty tie-breaker, where and which taxes apply, the next steps (certificate of residence, obligations as a resident and a non-resident, steps when leaving), the exit tax and the year of the move (when move is given), what the result does not cover, the legal basis with links, court practice, optional per-income rules, the disclaimer and result_link. The link opens the same result on this website, where it can be saved as a PDF.

Texts are in the language of the version. The assistant presents them in the user's language. When the conclusion is already known, next_steps returns the same next-step blocks without the questions.

Versions

Each version is written for taxpayers of one home country and compares it with the other countries in the set.

versionHome countryOther countriesWebsite
ukУкраїна (UA)30doubletaxation.app/
enUnited States (US)30
plPolska (PL)30doubletaxation.app/pl/
csČesko (CZ)30doubletaxation.app/cs/
roRomânia (RO)30doubletaxation.app/ro/
huMagyarország (HU)30doubletaxation.app/hu/
trTürkiye (TR)30doubletaxation.app/tr/
zh中国 (CN)30doubletaxation.app/zh/
inIndia (IN)30doubletaxation.app/in/
ja日本 (JP)30doubletaxation.app/ja/
bnবাংলাদেশ (BD)30doubletaxation.app/bn/
pkPakistan (PK)30doubletaxation.app/pk/
deDeutschland (DE)30doubletaxation.app/de/
atÖsterreich (AT)30doubletaxation.app/at/
frFrance (FR)30doubletaxation.app/fr/
esEspaña (ES)30doubletaxation.app/es/
ptPortugal (PT)30doubletaxation.app/pt/
itItalia (IT)30doubletaxation.app/it/
myMalaysia (MY)30doubletaxation.app/my/
sgSingapore (SG)30doubletaxation.app/sg/
tw臺灣 (TW)30doubletaxation.app/tw/
seSverige (SE)30doubletaxation.app/se/
brBrasil (BR)30doubletaxation.app/br/
arArgentina (AR)30doubletaxation.app/ar/
geსაქართველო (GE)30doubletaxation.app/ge/
mxMéxico (MX)30doubletaxation.app/mx/
idIndonesia (ID)30doubletaxation.app/id/

Tools

list_versions — List language versions

Lists the 27 versions of DoubleTaxation. Each version is written for taxpayers of one home state (in its language) and compares it with 30 other countries. Call this first if you are not sure which version fits the user.

No parameters.

list_countries — List countries of a version

Lists the countries that can be checked against the home state of a version: whether a tax treaty is in force (title, dates, link), whether per-income treaty rules and tax burden data exist, plus the allowed citizenship options and years for check_residency.

ParameterTypeDescription
version *string (one of 27 values)Version id from list_versions.

check_residency — Check tax residence

Determines the person's tax residence between the version's home state and another country, step by step. Without all answers it returns status "needs_answer" and the next question (id, text, options); ask the user and call again with all answers collected so far. When complete it returns status "done": the conclusion with reliability %, how each law treats the person, the treaty tie-breaker, where and which taxes apply, next steps (certificate of residence, resident / non-resident obligations, steps when leaving), exit tax and the year of the move (with "move"), what the result does not cover, the legal basis (norms with links) and court practice, optional per-income-type rules, the disclaimer and a link to the same result on doubletaxation.app. Texts are in the language of the version.

ParameterTypeDescription
version *string (one of 27 values)Version id (home state), see list_versions.
country *string (one of 31 values)ISO code of the other country (where the person lives or stays). Must be one of list_countries for this version.
yearintegerTax year: the current year or one of the two previous years. Default: current year.
citizenshipstringCitizenship option value from list_countries.citizenship_options, e.g. "UA", "UA+OTHER" (dual), "NONUS". Default: the first option (citizen of the home state only).
moveobjectOptional: the person moved this tax year. kind "depart" = left the version's home state for the other country; "arrive" = moved to the home state from the other country. date YYYY-MM-DD within the tax year. Adds how each state treats the year of the move, the steps when leaving and the exit tax of the state left.
answersobjectAnswers so far: { "<question id>": value }. Choice questions take an option value (e.g. "yes", "no", "unknown"); number questions take a whole number (days) or "unknown" if allowed.
incomearray of objectsOptional: the person's income, one item per category, to get the treaty's special rules (who may tax it, rate limits, relief method, example calculation if amount is given).

Each item of income:

ParameterTypeDescription
category *string (one of 14 values)
source *stringISO code of the state of source: where the work is done, the property is, the payer or company is resident, the performance takes place. Must be the home state or the other country.
amountnumberOptional annual gross amount (any currency, used for an illustrative calculation).
daysintegeremployment: days in the state of work within the treaty period.
employer_resident_of_source"yes" | "no" | "unknown"employment: is the employer resident in the state of work?
borne_by_pe"yes" | "no" | "unknown"employment: is the salary borne by a permanent establishment of the employer in the state of work?
fixed_place"yes" | "no" | "unknown"business / technical_fees: fixed place of business (permanent establishment) in the state of source?
service_daysintegerbusiness / technical_fees: days of providing services in the state of source.
service_statestringgovernment: state where the government service is performed (ISO code).
pension_kind"social" | "government" | "private"pension: state social pension, pension for government service, or private/occupational pension.
asset"immovable" | "property_rich_shares" | "other"capital_gains: what is sold.
study_statestringstudents: state where the person studies (ISO code).
student"yes" | "no" | "unknown"students: came to the state of study for education, and the payments come from abroad?

tax_burden — Tax burden on salary

Income tax and social contributions on an annual salary in one or more countries (OECD Taxing Wages method: single person, no children, full-year employee). Returns net pay, personal rate, tax wedge and marginal rate, sorted from lowest to highest personal rate. 30 countries are fully checked; some 140 more have preliminary data (marked level "preliminary"). For up to 3 countries also the line-by-line breakdown, special tax regimes for individuals (e.g. for newcomers), assumptions and official sources.

ParameterTypeDescription
countriesarray of string (one of 175 values)ISO codes; default: the fully checked countries. Other codes in the list have preliminary data (salary tax scale and main contributions only).
gross_eurnumberAnnual gross salary in EUR. Default 60,000 (reference profiles: 30,000 / 60,000 / 120,000).
gross_localnumberAnnual gross salary in the country's own currency (only with exactly one country).
versionstring (one of 27 values)Language of the texts (version id). Default: en.

count_days — Count days of stay

Counts days of stay per country from the trips the user provides (country, from, to) under each country's own counting rule (calendar year, tax year, any 12 months, US substantial presence test, continuous stay): days in the counting period, the day threshold for tax residence and its legal source, the date it was reached or how many more days are needed, and Schengen 90/180 days used. The day of arrival and departure counts in both countries. It does not track anyone: it only counts the trips passed in, and they are not stored.

ParameterTypeDescription
trips *array of objectsStays, one item per stay.
as_ofstringDate to count up to, YYYY-MM-DD. Default: today. Later trips count as planned.
versionstring (one of 27 values)Language of the texts (version id). Default: en.

next_steps — Next steps after the residence conclusion

What to do once the tax residence is known (the same blocks as under the result on doubletaxation.app and in check_residency "done"): how to get a certificate of residence, obligations of a resident (returns, deadlines), obligations and options of a non-resident with income from the other state (treaty relief forms, refunds), U.S. citizen obligations, steps when leaving the state, the exit tax, how each state treats the year of the move, and what the conclusion does not cover. Each step has the authority, form, link and legal norm. Texts are in the language of the version.

ParameterTypeDescription
version *string (one of 27 values)Version id (home state), see list_versions.
residence *stringState of tax residence: the version's home state or one of its other countries (ISO code), or "BOTH", "MAP", "NONE", "UNDETERMINED" (conclusion.residence from check_residency).
otherstring (one of 31 values)The other country of the pair (ISO code). Optional when residence is a country other than the home state (then it is that country); needed for BOTH, MAP, NONE, UNDETERMINED and for move kind "arrive".
citizenshipstringCitizenship option value from list_countries.citizenship_options (e.g. "US", "US+OTHER", "NONUS"). Default: the first option. Matters for U.S. citizens (taxed on worldwide income wherever they live).
yearintegerTax year of the move (current or one of the two previous). Optional; used to check move.date.
moveobjectOptional: the person moved this tax year. kind "depart" = left the version's home state for the other country; "arrive" = moved to the home state from the other country. date YYYY-MM-DD within the tax year.

exit_tax_check — Exit tax on individuals

Whether a country levies an exit (departure) tax on individuals who give up tax residence: who pays and on what (assets, thresholds, prior residence period), deferral or relief (e.g. moving within the EU/EEA), the legal norm with a link and the date checked.

ParameterTypeDescription
countriesarray of string (one of 31 values)ISO codes; default: all available countries.
versionstring (one of 27 values)Language of the texts (version id). Default: en.

regime_search — Search special tax regimes

Special and preferential tax regimes for individuals (newcomers / impatriates, employees, self-employed, investors, pensioners) in 30 countries. Filter by country, kind, status and free text. Returns per regime: official name, who it is for, the benefit, duration, how to apply, limits and risks, status (open, closed to new entrants, only for existing participants, starts later), the legal norm with a link and the date checked.

ParameterTypeDescription
countriesarray of string (one of 30 values)ISO codes; default: all countries.
kindarray of "newcomer" | "employee" | "self_employed" | "investor" | "pensioner" | "other"Who the regime is for; default: all.
statusarray of "open" | "closed" | "grandfathered" | "announced"open = can be entered now; closed = closed to new entrants; grandfathered = only for existing participants; announced = starts later. Default: all.
querystringFree text; all words must match (name, who, benefit, conditions; in the version's language or English), e.g. "foreign income flat".
limitintegerMaximum regimes returned. Default 20.
versionstring (one of 27 values)Language of the texts (version id). Default: en.

compare_business_forms — Business taxes: compare legal forms and tax systems

Business tax calculator for a resident of one country and one sector (activity): every legal form (sole proprietor, own company) under every available tax system — total tax and contributions, what remains, rate, line items, why a system is unavailable for the sector or amount, conditions, legal norms; requirements for each legal form and the sector's tax features; assumptions and sources. Same calculation and ranking as doubletaxation.app (section "Business taxes"); an estimate, not tax advice.

ParameterTypeDescription
country *string (one of 30 values)ISO code of the country of residence.
revenue *numberAnnual revenue, in the currency given by "currency".
expenses *numberAnnual deductible business expenses (not more than revenue), in the same currency.
currency *stringCurrency of revenue and expenses: "EUR" or the country's own currency code (e.g. "PLN"). EUR amounts are converted at the site's rate (fx.per_eur in the result).
distributebooleanFor companies: the whole profit after tax is paid to the owner as dividends (true, default) or stays in the company (false; companies are then not ranked against sole proprietors).
activity"it" | "services" | "consumer" | "trade" | "production"Sector: it = IT and consulting for businesses (default); services = other professional services to companies (marketing, design, translation, engineering, bookkeeping); consumer = services to individuals (household services, repairs, beauty, tutoring); trade = trade in goods, retail or wholesale, incl. online shop (no excise goods); production = making and selling own products.
versionstring (one of 27 values)Language of the texts (version id). Default: en.

explain_residency — Ask the monograph: tax residence, tax jurisdiction, taxpayer status

Answers general questions about tax residence and the theory behind it from the monograph by DoubleTaxation's legal expert, Yevhen Marynchak, "The Financial-Legal Link Between an Individual and the State" (2nd edition, 2020): 893 questions and answers covering what resident status is and why it exists; its history (from the citizenship principle to the residence principle, the League of Nations work of the 1920s, the OECD Model Tax Convention); economic theories of taxation (Smith, von Schanz, Wicksell–Lindahl); concepts of the "income taxpayer"; tax sovereignty and tax jurisdiction and their kinds (interstate, state, local, offshore zones); the legal status and tax legal personality of an individual taxpayer; criteria of residence and the treaty tie-breaker; source taxation; e-government; problems of the Ukrainian rules; the author's own terms and definitions. Each entry is a plain-English paraphrase with the book's section, page and a link to find the original text. Use "query" for a question (translate it into English key words); call without arguments for an overview and the table of contents. Not for a person's own status: use check_residency.

ParameterTypeDescription
querystringThe user's question or its key words, in English (translate if needed), e.g. "why did citizenship stop determining tax duties" or "offshore zone definition".
sectionstring (one of 39 values)Limit to one part of the book (with its subsections); alone, lists that part's entries.
kindstring (one of 11 values)Limit to one kind of entry (e.g. definition, history, legal_norm, proposal).
idsarray of stringReturn these entries by id (from an earlier result).
limitintegerMaximum entries returned. Default 6.
topic"what_is" | "origin" | "why_it_matters" | "criteria" | "citizenship" | "tax_jurisdiction" | "ukraine"Short overview of one theme instead of a search: what_is = What tax residence is; origin = Where the concept comes from; why_it_matters = Why tax residence matters; criteria = How tax residence is determined; citizenship = Tax residence and citizenship; tax_jurisdiction = Tax sovereignty and tax jurisdiction; ukraine = Ukraine: problems analysed in the monograph.

Protocol

  • MCP over Streamable HTTP: POST JSON-RPC 2.0 requests, application/json responses, no sessions; notifications return 202. GET returns 405 (no event stream).
  • Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. Clients on 2026-07-28 fall back to initialize.
  • Methods: initialize, tools/list, tools/call, ping.
  • Invalid input returns a tool result with "isError": true and an explanation the assistant can act on.
  • Limits: request body up to 64 KB; requests per minute are capped per server instance.

Privacy

The answers, trips and amounts that the assistant sends are processed in memory while the request is handled. They are not stored, logged or used for statistics. The only statistic is a daily count of requests, with the assistant's name taken from the user-agent. Details are in the privacy policy. What users write to the assistant is processed by its provider under its own terms.

Disclaimer

The result is for information only and is not tax or legal advice. Tax authorities and courts may interpret the rules differently, including because of circumstances not covered here, and the law changes. Consult a qualified adviser before making decisions.