Polystate MCP server
io.polystate/mcppolystate.iostreamable-httpv0.3.1Scanned
Relocation, residency, visa, company-formation and crypto-tax data for about 170 countries.
15 tools: 5 change things and 10 only read.
- Reads private data · 1
- Reads text others write · 1
- Can send data out · 0
- No findings
Tools listed without sign-in. Remote posture
With Anlyon
5 tools here change things. Govern them.
- Anlyon lists the tools and adopts none.
- Each tool you adopt gets approvals and receipts.
- Your agent never holds the key.
A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.
What the Polystate MCP server can do
The Polystate MCP server is published by polystate.io, a domain the MCP Registry verified. It has 15 tools. It can create or change data (5 tools: optimize_relocation, visa_check, check_eligibility, book_service and 1 more), but cannot delete data. 10 tools only read.
1 tool reads private data (get_visa_requirements); 1 tool brings in text other people can write (book_service).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Its remote endpoint lists its tools without sign-in.
Last scanned Nov 20, 2026, version 0.3.1.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
15 tools
Changes things 5Claude Code: ask
book_serviceUse when the person has decided to buy a Polystate service — e.g.Reads text others writeNo findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Use 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 checkout is created. No payment is taken until the person completes it. Give the service `id` (most reliable) or the `service` name from list_services (case, accents and hyphens are ignored), optionally narrowed by `country`. A partial or ambiguous name returns candidates instead of booking. Returns checkoutUrl/sessionId/totalAmount/currency for card-checkout services, or ctaUrl/note for services handled by a partner. Confirm with the person before calling.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
check_eligibilityUse for 'can I, as a citizen of X, get this Polystate service' — e.g.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Use 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). Returns the service's formal requirements and whether any nationality restriction applies; services are treated as eligible until a structured restriction is recorded. A partial or ambiguous name returns candidates instead of guessing. Free: never consumes quota.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
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.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Use 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 government lists of licensed / authorised agents for St Kitts and Nevis, Antigua and Barbuda, Dominica, Grenada, Saint Lucia, Malta (MPRP residency), Vanuatu and Nauru. Optional `name` (firm, person or licence number; word order, accents, punctuation and company endings ignored) and optional `country` (ISO-3166 code or English name); omit both to get the 8 lists with entry counts and official source URLs. Returns matches with list section, licence number (only Saint Lucia and Malta publish them), website, authority and the official `source_url`, plus `checked_at`. No emails or phone numbers. A country outside the 8 returns `list_available: false`. A name matches when every query word is a whole word of it, so compare the exact name and licence number before telling someone a firm is listed: a similarly named firm is not the same firm. Not finding a name does not prove a firm is unlicensed — say so and point to `source_url`.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
optimize_relocationUse for open-ended 'where should I move / relocate / base myself' questions — e.g.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Use 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 easy residency'. Returns a ranked jurisdiction shortlist fusing tax + crypto-tax tier + residency-program terms + passport power. Provide goal `weights` (0–100 across tax, safety, healthcare, institutions, business_ease, privacy, cost_of_living, banking_access, crypto_tax, residency_ease, passport_power), optional `passport_country` (enables the passport_power dimension — visa-free destination count for the held passport), and optional hard `filters` (crypto_tier_in, max_time_to_citizenship_years, max_minimum_presence_days_per_year, territorial_tax_only, requires_bookable_service, countries). Each result carries a fit score, per-dimension breakdown, plain-language `why`, provenance (last_verified/sources/confidence), and a lead-gen handoff link. `tax_basis` on a result gives the estimate its `tax` score is computed from and the source's two rule wordings (quote the wording when it is a range or has conditions), and `crypto_tax.zero_rate` says whether a 0% estimate is `firm` or `conditional` (null when the estimate is not 0%). Returns program terms and eligibility only — no prices. For a plain scored comparison of named countries use compare_jurisdictions.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
visa_checkUse for 'can I go / work / stay in X with a Y passport' questions — e.g.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Use 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 `visa_type` keyword filter (e.g. 'digital nomad', 'work', 'tourist') and `max_alternatives` (0–20). Returns the best-matching visa option, ranked alternatives, source, passport-specificity flag, and a concise recommendation. Each option carries `official_link` and `data_as_of` (the date the row was last loaded, not a check of the rule; null when undated). For the detailed requirements/documents of a specific route use get_visa_requirements.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 10Show 10 read-only tools
compare_jurisdictionsUse when the question is 'which country is best/safest/cheapest for X' or any ranked multi-country comparison — e.g.No findings
Why it is in this group
- The name "compare_jurisdictions" says "compare": a word for reading.
Description, as the server wrote it Use 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 an 8-dimension weighted model (tax, safety, healthcare, institutions, business_ease, privacy, cost_of_living, banking_access). Pass `countries` (2–50 ISO-3166 codes or English names) to compare a specific set, or omit to rank all available countries (cap with `limit`). Pass `weights` (0–100 per dimension) to match the user's stated priorities. The `tax` score reflects how an individual's crypto is taxed, not salary income tax. `tax_basis` on each row gives the estimate it is computed from and the source's two rule wordings (capital gains, income on crypto): when a wording is a range or has conditions the score rests on an estimate, so quote the wording. Where that estimate is 0%, `zero_tax_rate` on the row says whether the zero is `firm` (scores 10) or `conditional` (holds only under conditions such as a holding period or foreign-source income; scores 9.5), so check get_crypto_tax_treatment before quoting a conditional zero; it is null for any other estimate. The overall `score` is led by the crypto tier, so a row can outrank another with a better `tax` score. For goal-driven relocation shortlists that also weigh residency terms, crypto-tax tier, and passport power, use optimize_relocation instead.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_company_formationUse for 'set up / incorporate / register a company in X' — e.g.No findings
Why it is in this group
- The name "get_company_formation" says "get": a word for reading.
Description, as the server wrote it Use 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 the US, 'Prospera' to Honduras), optional `entity_type` filter (for example: llc, corporation, free_zone, ibc). Returns formation requirements, minimum investment, annual cost, time-to-formation, benefits, and tax notes.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_crypto_tax_treatmentUse for 'how is crypto taxed in X' — e.g.No findings
Why it is in this group
- The name "get_crypto_tax_treatment" says "get": a word for reading.
Description, as the server wrote it Use 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, effective individual rate, capital gains, income tax on crypto, corporate tax, VAT, and supporting details, with data_as_of and sources. For two-country crypto comparisons use tax_compare.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_legal_changesUse for 'what changed recently / any new laws in X' — e.g.No findings
Why it is in this group
- The name "get_legal_changes" says "get": a word for reading.
Description, as the server wrote it Use 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` (single) or `countries` (array, up to 50), optional `categories` (array), and either a `from_date`/`to_date` range or a `month`/`year` pair (mutually exclusive). Supports `limit` (1–100) and `offset` for pagination. Each record carries title, summary, category, date and sources; pass `include_full_content: true` only when the full text is needed.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_residency_programsUse for 'how do I get residency in X' — e.g.No findings
Why it is in this group
- The name "get_residency_programs" says "get": a word for reading.
Description, as the server wrote it Use 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 zone program when `category` is omitted), optional `category` filter (`temporary` | `permanent` | `investor` | `digital_nomad`). Returns program names, requirements, benefits, cost, time to citizenship, minimum presence, and tax implications, with sources, last_verified and a confidence level per program. Cost: `minimum_investment` and `annual_cost` are the source's wording (an investment or income threshold, often in local currency) and are what to quote; `fees.setup` and `fees.recurring` are USD numbers only for the few programs that publish their own fees, and null otherwise (null is not zero).
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_tax_ratesUse for 'how are crypto gains and company profits taxed in X' — e.g.No findings
Why it is in this group
- The name "get_tax_rates" says "get": a word for reading.
Description, as the server wrote it Use 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` | `capital_gains` | `crypto`). Returns, per rate, the source's own wording in `as_reported`, its first percentage as `rate`, a `conditional` flag (true when the wording is a range or has conditions — quote `as_reported` then) and an `applies_to` label; plus special regimes, crypto tier, last_verified and sources. `territorial_vs_worldwide` is set only for the few countries the dataset flags as territorial; null means not flagged, not 'worldwide'. Scope: `corporate` is the headline company rate; the other figures describe how CRYPTO is taxed. General salary/employment income tax brackets and the consumer VAT rate are NOT in this dataset — tell the person that rather than quoting these numbers as such. Separately, `general_rates` gives the OECD's general statutory rates where the OECD covers the country: `corporate_income_tax` (the combined company rate: central plus a representative sub-national rate and surcharges, so it can differ from the crypto source's `corporate`) and `top_personal_income_tax`, each with `rate`, `year`, `measure` and the OECD citation in `source`; null means not covered by the OECD table, or held back because the source value looks wrong (then listed under `general_rates.withheld` with the reason), never zero; `vat` is always null. These are national figures and do not describe a particular state or region. `found: false` means no crypto-tax rows for the country; `general_rates` can still be filled. For side-by-side country comparisons use tax_compare.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
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.No findings
Why it is in this group
- The name "get_tax_treaties" says "get": a word for reading.
Description, as the server wrote it Use 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 of treaty partners (code and name). Treaty data exists for about half the countries: when `data_available` is false the count is null, which means no data on file, not that the country has no treaties.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_visa_requirementsUse for 'what are the requirements/documents for a visa to X' — e.g.Reads private dataNo findings
Why it is in this group
- The name "get_visa_requirements" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "document": it reads documents.
Description, as the server wrote it Use 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), optional `visa_type` filter. Uses passport-specific data when available and falls back to destination program data otherwise. Each result carries `official_link` and `data_as_of` (the date the row was last loaded, not a check of the rule; null when undated). To discover and rank which visa options exist for a route, use visa_check first.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
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.No findings
Why it is in this group
- The name "list_services" says "list": a word for reading.
Description, as the server wrote it Use 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 English name) and `search` keyword (case and accents ignored); omit both to list the whole catalog. Returns each service's id, exact name, description, list price and processing time. Free: never consumes quota. For program facts about countries Polystate does not sell in, use get_residency_programs or get_company_formation.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
tax_compareUse for head-to-head 'X vs Y' questions about crypto and company taxes — e.g.No findings
Why it is in this group
- The name "tax_compare" says "compare": a word for reading.
Description, as the server wrote it Use 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 name). Returns side-by-side headline rates with the source's wording per rate in `rates_detail`, treaty counts, crypto tier, and the tax-only scoring dimension (`tax_score`, with `zero_tax_rate` saying whether a 0% estimate is `firm` or `conditional`). A comparison answers `depends_on_conditions` instead of naming a winner when either rate is a range or conditional. The income and capital-gains figures describe how CRYPTO is taxed and `corporate` is the headline company rate; salary income tax brackets are not covered (see `coverage_note`). Each country also carries `general_rates`: the OECD's combined statutory company income tax rate and top personal income tax rate with year and citation, null where the OECD does not cover the country or the figure is held back (then listed under `withheld` with the reason). Company tax is compared twice and the answers can differ: `comparison.lower_corporate_tax` uses the crypto source's `corporate` figure (sometimes the central-government rate alone, sometimes simply older), `comparison.lower_corporate_tax_oecd` uses the OECD's combined rate; for a general company tax question use the OECD one. `tax_found: false` means no crypto-tax rows for that country; its `general_rates` can still be filled. A null treaty_count means no data on file. To rank more than two countries use compare_jurisdictions.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data1
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write1
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 19, 2026, 17:22 UTC, unchanged since Nov 12, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 5
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
- WarnThe whole server
The endpoint served tools/list without credentials, and the list has 5 tools that change things (5 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp: tools/list returned 15 tools to an anonymous client, including optimize_relocation (write), visa_check (write), check_eligibility (write), book_service (write), check_licensed_agent (write)
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
No change seen yet. Its tools are rescanned every day, and a remote endpoint is looked at once a week.
Install
Pinned to version 0.3.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http polystate https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcpclaude mcp add --transport http polystate https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__polystate__compare_jurisdictions",
"mcp__polystate__list_services",
"mcp__polystate__tax_compare",
"mcp__polystate__get_visa_requirements",
"mcp__polystate__get_residency_programs",
"mcp__polystate__get_crypto_tax_treatment",
"mcp__polystate__get_company_formation",
"mcp__polystate__get_legal_changes",
"mcp__polystate__get_tax_treaties",
"mcp__polystate__get_tax_rates"
],
"ask": [
"mcp__polystate__optimize_relocation",
"mcp__polystate__visa_check",
"mcp__polystate__check_eligibility",
"mcp__polystate__book_service",
"mcp__polystate__check_licensed_agent"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as polystate. Review it before you use it.
Capability tags behind 2 rules
- mcp__polystate__book_service untrusted-input
- mcp__polystate__get_visa_requirements private-data
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.polystate/mcp/verify?hash=c185912d71860159ec5fe45d074c08527fbb2cd30afd044076b5521c0f752ebf" | jq -e '.changed == false'Pinned hash c185912d7186, from Nov 20, 2026, 15:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.polystate/mcp/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.polystate/mcp)Source: MCP Registry. Synced Nov 20, 2026, 15:18 UTC.
Polystate MCP server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the Polystate MCP server safe?
- No scan can promise that. What its definitions show: 15 tools, 5 of which can change, send or delete something, and 0 findings from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the Polystate MCP server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the Polystate MCP server do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the Polystate MCP server have?
- 15 tools: 5 write, 10 read. optimize_relocation, visa_check, check_eligibility, book_service, check_licensed_agent, compare_jurisdictions, list_services, tax_compare and 7 more.
Does the Polystate MCP server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the Polystate MCP server send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the Polystate MCP server changed its tools?
- Not since Anlyon Radar started tracking it. Last scanned Nov 20, 2026.