Relocation, residency, visa, company-formation and crypto-tax data for about 170 countries.
Connect Remote server
claude mcp add --transport http mcp https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"mcp": {
"url": "https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"mcp": {
"type": "http",
"url": "https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 15 found in our last check
compare_jurisdictionsUse when the question is 'which country is best/safest/cheapest for X' or any ranked multi-country comparison — e.g. 'compare Portugal vs Paraguay vs UAE for relocation', 'safest low-tax countries', 'rank countries by cost of living and banking access'. Scores jurisdictions on a…
optimize_relocationUse for open-ended 'where should I move / relocate / base myself' questions — e.g. 'best country for a crypto founder with a German passport', 'where can I get residency fast, pay no tax on foreign income, and reach citizenship in under 5 years', 'territorial-tax countries with…
visa_checkUse for 'can I go / work / stay in X with a Y passport' questions — e.g. 'Slovakia to Thailand visa', 'US citizen digital nomad visa Japan', 'do Indian passport holders need a visa for Georgia'. Give the passport country and destination (ISO-3166 code or English name), optional…
check_eligibilityUse for 'can I, as a citizen of X, get this Polystate service' — e.g. 'can a US citizen buy Paraguay Temporary Residence'. Give `nationality` (ISO-3166 code or English name) and the `service` id or name as returned by list_services (case, accents and hyphens are ignored). Return…
list_servicesUse for 'what can Polystate do for me in X' or to find the exact service name before checking eligibility or booking — e.g. 'what residency services do you sell for Paraguay', 'do you offer a Wyoming LLC', 'list bank account services'. Optional `country` (ISO-3166 code or Englis…
book_serviceUse when the person has decided to buy a Polystate service — e.g. 'book the Wyoming LLC', 'start my Paraguay residency'. With a Polystate API key it starts a checkout and returns the link; without a key it returns the polystate.io page where the person books instead, and no chec…
tax_compareUse for head-to-head 'X vs Y' questions about crypto and company taxes — e.g. 'crypto taxes Germany vs Czechia', 'is Dubai or Singapore better for corporate tax', 'Portugal vs Spain for a crypto investor'. Give two countries `country1` and `country2` (ISO-3166 code or English na…
get_visa_requirementsUse for 'what are the requirements/documents for a visa to X' — e.g. 'Paraguay residency visa requirements for US citizens', 'Thailand DTV requirements', 'what do I need for a Portugal D7'. Give `passport_country` and `destination_country` (ISO-3166 code or English name), option…
get_residency_programsUse for 'how do I get residency in X' — e.g. 'Paraguay tax residency requirements', 'Portugal golden visa program', 'UAE digital nomad residency', 'Prospera tax residency'. Give the country (ISO-3166 code or English name; 'Prospera' resolves to Honduras and returns the Próspera…
get_crypto_tax_treatmentUse for 'how is crypto taxed in X' — e.g. 'is crypto tax-free in Portugal', 'Germany 1-year holding rule', 'crypto capital gains in UAE', 'do I pay tax selling bitcoin in Slovakia'. Give the country (ISO-3166 code or English name). Returns the country's crypto tier, summary, eff…
get_company_formationUse for 'set up / incorporate / register a company in X' — e.g. 'Wyoming LLC formation cost' (country US), 'Dubai free zone company requirements' (country AE), 'Prospera LLC' (country Honduras or Prospera). Give the country (ISO-3166 code or English name; a US state resolves to…
get_legal_changesUse for 'what changed recently / any new laws in X' — e.g. 'new crypto regulation in Portugal 2026', 'recent visa rule changes Thailand', 'what changed in Paraguay immigration law this year'. Returns legal and regulatory change records, sorted newest first. Filter by `country` (…
get_tax_treatiesUse for 'does X have a tax treaty / double taxation agreement with Y' or 'which countries does X have DTAs with' — e.g. 'France tax treaty partners', 'does Georgia have a DTA with Germany'. Give one country (ISO-3166 code or English name). Returns the treaty count and the list o…
get_tax_ratesUse for 'how are crypto gains and company profits taxed in X' — e.g. 'tax on selling bitcoin in Portugal', 'corporate tax rate in Paraguay', 'special tax regimes Italy'. Give the country (ISO-3166 code or English name), optional `tax_type` filter (`income` | `corporate` | `vat`…
check_licensed_agentUse for 'is this agent / firm licensed for citizenship or residency by investment' or 'who are the authorised agents for X' — e.g. 'is Arton Capital an authorised agent for Saint Lucia', 'licensed agents for the St Kitts CBI', 'check licence RES-ACCA'. Searches the official gove…
Headers
| Name | Description |
|---|---|
AuthorizationOptional, secret | Optional. Works without a key within fair-use limits; a Polystate API key (bearer token) gives higher limits and direct checkout links. |
Details
| Endpoint | https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp (Streamable HTTP) |
| First published | 11 Nov 2026 |
| Last updated | 11 Nov 2026 |
| Registry name | io.polystate/mcp |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
