Polystate

Relocation, residency, visa, company-formation and crypto-tax data for about 170 countries.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
97%
Naming quality
93%
Poisoning risk
80%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains suspicious base64-like encoded stringin book_service

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~7,079Tokens (tool definitions)
~2.5 KBTypical response size
Significant attention impact (5.53% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "mcp": {
      "url": "https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcp"
    }
  }
}

Remote endpoints

https://polystate-mcp-server.shy-surf-2fdf.workers.dev/mcpstreamable-http

What it can do

Tool inventory

Tools (15)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒compare_jurisdictions(countries, limit, weights)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "countries": {
      "description": "2-50 countries to compare, each an ISO-3166 alpha-2/alpha-3 code or English name, e.g. ['PT', 'Paraguay', 'UAE']. Omit to rank every country.",
      "minItems": 2,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 60
      }
    },
    "limit": {
      "description": "How many countries to return when `countries` is omitted (default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 171
    },
    "weights": {
      "description": "Importance of each dimension, 0-100: tax, safety, healthcare, institutions, business_ease, privacy, cost_of_living, banking_access. Omitted dimensions keep their default weight.",
      "type": "object",
      "properties": {
        "tax": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "safety": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "healthcare": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "institutions": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "business_ease": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "privacy": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "cost_of_living": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "banking_access": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒optimize_relocation(passport_country, weights, filters, limit, goal_tag)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "passport_country": {
      "description": "Passport the person holds: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'DE' or 'Germany'. Enables the passport_power dimension.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "weights": {
      "description": "Importance of each goal, 0-100: tax, safety, healthcare, institutions, business_ease, privacy, cost_of_living, banking_access, crypto_tax, residency_ease, passport_power. Set the ones the person cares about; the rest keep their default.",
      "type": "object",
      "properties": {
        "tax": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "safety": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "healthcare": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "institutions": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "business_ease": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "privacy": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "cost_of_living": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "banking_access": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "crypto_tax": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "residency_ease": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "passport_power": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      }
    },
    "filters": {
      "description": "Hard requirements that exclude countries: crypto_tier_in (HEAVEN best to HELL worst), max_time_to_citizenship_years, max_minimum_presence_days_per_year, territorial_tax_only, requires_bookable_service, countries (restrict to this list).",
      "type": "object",
      "properties": {
        "crypto_tier_in": {
          "description": "Keep only countries in these crypto-tax tiers (HEAVEN is best, HELL worst).",
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "HEAVEN",
              "PARADISE",
              "LIMBO",
              "PURGATORY",
              "HELL"
            ]
          }
        },
        "max_time_to_citizenship_years": {
          "description": "Keep only countries with a program reaching citizenship within this many years of residence, counted from the start of the program. Programs with no path, or whose time is not plainly stated, do not qualify. Combined with max_minimum_presence_days_per_year, one program must meet both, and since citizenship counts real residence, the presence cap must then allow living there (183 days or more).",
          "type": "number",
          "minimum": 0,
          "maximum": 30
        },
        "max_minimum_presence_days_per_year": {
          "description": "Keep only countries with a program that can be KEPT with at most this many days in the country per year. Programs whose requirement is not plainly stated do not qualify, and ones that require living there qualify only at 365.",
          "type": "number",
          "minimum": 0,
          "maximum": 365
        },
        "territorial_tax_only": {
          "description": "True keeps only countries the dataset flags as territorial (foreign-source income untaxed). Only a few are flagged, so this is a narrow filter, not a complete list.",
          "type": "boolean"
        },
        "requires_bookable_service": {
          "description": "True keeps only countries where Polystate sells a service.",
          "type": "boolean"
        },
        "countries": {
          "description": "Rank only these countries (ISO-3166 codes or English names).",
          "minItems": 1,
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 2,
            "maxLength": 60
          }
        }
      }
    },
    "limit": {
      "default": 10,
      "description": "How many ranked countries to return (1-50, default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "goal_tag": {
      "description": "Short label for the person's goal, e.g. 'crypto_tax'. Only tags the follow-up link.",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒visa_check(passport_country, destination_country, visa_type, max_alternatives)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "passport_country": {
      "description": "Country of the traveller's passport: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'SK', 'SVK', 'Slovakia'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "destination_country": {
      "description": "Country being travelled to: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'TH', 'THA', 'Thailand'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "visa_type": {
      "description": "Keyword filter on the visa type, e.g. 'digital nomad', 'work', 'visa_free'. Omit to get every option on file.",
      "type": "string"
    },
    "max_alternatives": {
      "description": "How many alternative visa options to return after the best match (0-20, default 5).",
      "type": "integer",
      "minimum": 0,
      "maximum": 20
    }
  },
  "required": [
    "passport_country",
    "destination_country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒check_eligibility(nationality, service)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "nationality": {
      "description": "Applicant's nationality: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'US', 'USA', 'United States'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "service": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Service name or id exactly as returned by list_services, e.g. 'Paraguay Temporary Residence'."
    }
  },
  "required": [
    "nationality",
    "service"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒list_services(country, search, limit, offset)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Only services for this country: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PY' or 'Paraguay'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "search": {
      "description": "Keyword that must appear in the service name, e.g. 'residence', 'LLC', 'bank', 'prospera'. Case and accents are ignored.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "limit": {
      "default": 25,
      "description": "How many services to return (1-50, default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Services to skip, for paging. Use the response's `next_offset`.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒book_service(service, country, country_id, category)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Exact service name or id as returned by list_services, e.g. 'Wyoming LLC Formation'. A partial name returns candidates instead of booking."
    },
    "country": {
      "description": "Narrow the match to one country: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PY' or 'Paraguay'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "country_id": {
      "description": "Internal numeric country id. Prefer `country`.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "category": {
      "description": "Internal numeric service category id. Rarely needed.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "service"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒tax_compare(country1, country2)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country1": {
      "description": "First country: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PT' or 'Portugal'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "country2": {
      "description": "Second country: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'ES' or 'Spain'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    }
  },
  "required": [
    "country1",
    "country2"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_visa_requirements(passport_country, destination_country, visa_type)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "passport_country": {
      "description": "Country of the traveller's passport: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'SK', 'SVK', 'Slovakia'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "destination_country": {
      "description": "Country being travelled to: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'TH', 'THA', 'Thailand'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "visa_type": {
      "description": "Keyword filter on the visa type, e.g. 'digital nomad', 'work', 'visa_free'. Omit to get every option on file.",
      "type": "string"
    }
  },
  "required": [
    "passport_country",
    "destination_country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_residency_programs(country, category)

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).

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country to get residency programs for: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PY', 'PRY', 'Paraguay'. 'Prospera' resolves to Honduras.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "category": {
      "description": "Return only programs of this kind. Omit to get every program on file.",
      "type": "string",
      "enum": [
        "temporary",
        "permanent",
        "investor",
        "digital_nomad"
      ]
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_crypto_tax_treatment(country)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country to look up: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'DE', 'DEU', 'Germany'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_company_formation(country, entity_type)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country to incorporate in: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'US', 'USA', 'United States'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "entity_type": {
      "description": "Exact entity type to filter on, e.g. 'llc', 'corporation', 'free_zone', 'ibc'. Omit to list every structure on file.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_legal_changes(country, countries, categories, month, year, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Single country to filter on: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PT' or 'Portugal'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "countries": {
      "description": "Several countries to filter on (up to 50), same formats as `country`.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 60
      }
    },
    "categories": {
      "description": "Exact category names to filter on, e.g. ['Corporate Taxation']. Each result's `category` field shows the valid values.",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 50
      }
    },
    "month": {
      "description": "Calendar month 1-12. Must be given together with `year`.",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "year": {
      "description": "Four-digit year, e.g. 2026. Must be given together with `month`.",
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    },
    "from_date": {
      "description": "Start of a date range, YYYY-MM-DD. Must be given together with `to_date`.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to_date": {
      "description": "End of a date range, YYYY-MM-DD. Must be given together with `from_date`.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "description": "How many records to return (1-100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Records to skip, for paging. Use the response's `next_offset`.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "include_full_content": {
      "description": "Set true to include each record's full text (several thousand characters each). Default false returns title, summary and sources only.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_tax_treaties(country)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country whose treaty partners to list: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'GE', 'GEO', 'Georgia'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒get_tax_rates(country, tax_type)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country to look up: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'PT', 'PRT', 'Portugal'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "tax_type": {
      "description": "Return only this rate. Omit to get all five.",
      "type": "string",
      "enum": [
        "income",
        "corporate",
        "vat",
        "capital_gains",
        "crypto"
      ]
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟒check_licensed_agent(name, country, limit)

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`.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Firm or person name, or a licence number, e.g. 'Arton Capital', 'Nuri Katz', 'RES-ACCA'. Word order, accents, punctuation and company endings (Ltd, Inc) are ignored.",
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "country": {
      "description": "Programme country: ISO-3166 alpha-2/alpha-3 code or English name, e.g. 'St Kitts and Nevis', 'GD', 'Malta'. Omit to search all lists.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "limit": {
      "default": 20,
      "description": "Maximum matches to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools