io.github.mirabello-consultancy/mcp-server

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Verified CBI/RBI data + Mirabello Freedom Compass origin-aware migration planner. 96 programmes.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.mirabelloconsultancy.com/",
      "transport": "streamable-http"
    }
  }
}

Measured tools (68)

• list_programmes read-only

  List Mirabello-advised citizenship- (CBI) and residency-by-investment (RBI/golden visa) programmes, optionally filtered by type, budget (USD, compared at indicative FX), region, or max processing time. All 98 programmes is a large response — pass limit when you only need a sample. Budget filters exclude programmes with no fixed threshold, which are still listed unfiltered.

  Parameters:

  • type — string — Programme family: "CBI" grants citizenship, "RBI" grants residence (golden visa). Omit for both.
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.
  • region — string — Region filter, matched case-insensitively (e.g. "Caribbean", "EU", "Middle East", "Pacific", "Africa", "Asia").
  • budget_max — number — Maximum headline minimum investment the applicant will consider, in USD. Programmes with no fixed threshold are excluded from budget filtering.
  • max_processing_months — number — Maximum acceptable processing time in MONTHS, compared against the lower bound of each programme's published range.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_programme read-only

  Full detail for one programme by id (e.g. "dominica-cbi","greece-gv"): routes, fees, processing, mobility, tax, path to citizenship, its Mirabello Index composite score + rank (mirabello_index), and the Mirabello programme page.

  Parameters:

  • id (required) — string — Programme id as returned by list_programmes (e.g. "dominica-cbi", "greece-gv", "portugal-gv"). Not a country name and not a website slug.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_programmes read-only

  Compare programmes side by side. Pass a + b (two programme ids) for the canonical versioned comparison artefact from the Mirabello Investment Migration Index: rank, composite, the dimension scores, per-dimension deltas, per-metric leads (a|b|tie) and the human compare page URL where one exists. Or pass ids (2-4) for the classic multi-column comparison of cost, processing, mobility, family inclusion, tax, path to citizenship.

  Parameters:

  • a — string — programme id (use with b) for the canonical two-programme artefact
  • b — string — programme id (use with a)
  • ids — array — 2-4 programme ids for the classic comparison

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_processing_times read-only

  Processing-time estimate for one programme (by id) or all programmes: the typical government processing range, the basis of the estimate and its source. Use when the user asks how long an application takes. Figures are indicative and vary with the case and the workload of the authority.

  Parameters:

  • id — string — Programme id as returned by list_programmes (e.g. "dominica-cbi", "greece-gv", "portugal-gv"). Not a country name and not a website slug.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• estimate_total_cost read-only

  Estimate the total cost of a programme for a given family: investment + government & due-diligence fees + family add-ons. Indicative; excludes professional/property/legal fees.

  Parameters:

  • programme_id (required) — string — Programme id as returned by list_programmes (e.g. "st-kitts-cbi"). Not a country name and not a website slug.
  • adults — number — main + spouse/adult applicants (default 1)
  • children_16plus — number — Number of dependent children aged 16 or over — usually priced higher than under-16s.
  • children_under16 — number — Number of dependent children aged under 16 — priced separately by most Caribbean programmes.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• recommend_programmes read-only

  Recommend a ranked shortlist of programmes for a client profile (budget, family size, mobility priority, timeline, tax goal) with reasoning. Respects closed/paused programmes.

  Parameters:

  • type — string — Programme family: "CBI" grants citizenship, "RBI" grants residence (golden visa). Omit for both.
  • tax_goal — boolean — True when the applicant's main objective is a tax outcome rather than mobility.
  • budget_max — number — Maximum headline minimum investment the applicant will consider, in USD. Programmes with no fixed threshold are excluded from budget filtering.
  • family_size — number — TOTAL number of people to be included, the main applicant INCLUDED (so a couple with two children is 4).
  • mobility_priority — boolean — True when visa-free travel is the applicant's main objective.
  • timeline_max_months — number — Maximum acceptable time to the outcome, in MONTHS.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_visa_free read-only

  Mobility for a programme passport: visa-free count and access to key destinations (Schengen, UK, USA, China).

  Parameters:

  • programme_id (required) — string — Programme id as returned by list_programmes (e.g. "st-kitts-cbi"). Not a country name and not a website slug.
  • destination — string — optional: check access to a specific destination (e.g. Schengen, UK, USA, China)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_index read-only

  The Mirabello Investment Migration Index — a composite 0–100 ranking of CBI/RBI programmes across cost, mobility, speed, path-to-citizenship, stability, family and tax, with transparent published methodology. Filter by type (CBI/RBI) and limit. Returns the TOP 25 by default (the full table is large); pass limit for more, or limit:0 for every ranked programme. Programmes with insufficient verified data are flagged provisional and excluded from the headline ranking.

  Parameters:

  • type — string — Programme family: "CBI" grants citizenship, "RBI" grants residence (golden visa). Omit for both.
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_recent_changes read-only

  Recent material changes across investment-migration programmes (launches, closures, threshold/mobility/regulatory changes) + current status counts, PLUS pathway_field_changes (official-source field-level diffs per country x pathway, from->to + cited source) and official_legislation_changes (changes detected directly on official government/gazette sources). The freshest, primary-source-verified record — use for "what changed recently / latest" questions. Pass cc to filter to one country.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_about read-only

  About Mirabello Consultancy: track record (cases, approval rate), credentials (IMC, ACAMS), offices, languages, services. Use for "who is Mirabello / why use them / are they reputable" questions.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_passport_renewal read-only

  CBI passport-RENEWAL facts for a Caribbean/Pacific programme country (St Kitts & Nevis, Antigua & Barbuda, Dominica, Grenada, St Lucia, Vanuatu): official government renewal fees (currency-primary EC$/GBP/VT with USD approximations, adult/child/lost-stolen), passport validity (adult/child years incl. Grenada adult 10-year since Jul 2024 and St Lucia 10-year since Aug 2025), typical processing, remote-renewal capability (Vanuatu requires in-person biometrics), biometric status, ECCIRA status (postponed to mid-2026, existing rules in force), the biometric/ECCIRA deadlines (e.g. St Kitts 31 Jul 2027), official source URLs, last_verified and the Mirabello /passport-renewal page. Pass country (programme id, e.g. st-kitts-cbi) for one; omit for all six. Citizenship is permanent; an expired passport is only a lapsed travel document. Information, not advice.

  Parameters:

  • country — string — programme id (e.g. st-kitts-cbi, st-lucia-cbi) or country alias; omit for all six

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_malta_citizen_service read-only

  Official procedure facts for Maltese citizens and their families, in Malta and abroad: (1) passport renewal (Identità fees by age and season, the official 4-hour urgent service in Malta, applying through a mission abroad, minors, lost/stolen); (2) a newborn's birth registration, citizenship and first passport (born in Malta or abroad to a Maltese parent); (3) a foreign spouse's citizenship by marriage (Cap. 188 art. 6, Form B, 5-year rule); (4) registration by descent (art. 5(3), Forms K and M, two consecutive Malta-born generations; the 1 August 2028 dates concern the parent or ancestor, not an application deadline). Returns steps, documents, itemised fees with source and verified flag, timelines, the authority, missions for the residence country and how Mirabello prepares the file. NOT investment citizenship (Malta's investor programme closed in 2025). Omit service for an overview. Information, not legal advice.

  Parameters:

  • service — string — Which service: "passport-renewal" (renew a Maltese passport), "newborn" (register a birth, prove citizenship, first passport), "marriage" (foreign spouse of a Maltese citizen), "descent" (planned). Omit for an overview of all services.
  • applicant_age — number — Age in years of the person the passport is for (passport service only); selects the minors rules and fee band.
  • residence_country — string — Where the applicant lives now, as a country name or ISO code (e.g. "Australia", "GB", "Malta"). Selects the in-Malta or abroad procedure and the nearest Maltese missions.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• estimate_malta_passport_fee read-only

  Itemised official government fee for a Maltese passport (Identità): age band (under 10 / 10-15 / 16+), seasonal adult rate (€70 September-March, €80 April-August), the official urgent service (€160 adult, 4 working hours, in Malta only), the €15 supplement when a lost or stolen passport was still valid, and, for applications through a Maltese embassy or consulate abroad, the mission processing fee and courier charges (flagged where unverified). Deterministic: computed from the official fee table with sources. Information only; confirm with the Passport Office or mission before paying.

  Parameters:

  • age (required) — number — Age in years of the passport holder on the application date.
  • month — number — Month of application, 1-12 (adult standard fee is €80 April-August, €70 otherwise). Defaults to the current month.
  • urgent — boolean — True for the official urgent service (4 working hours in Malta; from abroad the urgent fee applies but no 4-hour timeframe).
  • location — string — "malta" if applying at the Passport Office in Malta, "abroad" if applying through a Maltese embassy, high commission or consulate.
  • lost_still_valid — boolean — True if the passport being replaced was lost, stolen or destroyed while still valid (adds the €15 oath supplement; a Maltese police report is required).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_maltese_citizenship_eligibility read-only

  Rules-based first screen of whether a person is already Maltese or can register, for two family routes: "birth" (a child born in Malta or abroad to a Maltese parent, the 1 August 1989 rule, the father-only rule for 1964-1989 births abroad and the maternal-line Form I) and "marriage" (spouse of a Maltese citizen, 5 years married and living together, widow/widower and separation cases, the prerequisite of registering a foreign marriage in Malta). Returns an outcome (citizen_automatically | likely_eligible | not_yet_eligible | needs_legal_opinion | out_of_scope), the reasons, the form to use, next steps and official sources. A screen, not a legal determination; the decision rests with Aġenzija Komunità Malta.

  Parameters:

  • route (required) — string — "birth" to check a child's citizenship by birth/descent, "marriage" to check a foreign spouse's eligibility to register.
  • separated — boolean — Route marriage: true if the spouses are separated (legally or in fact).
  • birth_date — string — Route birth: the child's date of birth, ISO YYYY-MM-DD.
  • born_in_malta — boolean — Route birth: true if the child was born in Malta, false if born abroad.
  • marriage_date — string — Route marriage: date of the marriage, ISO YYYY-MM-DD (the 5 years run from this date).
  • maltese_parent — string — Route birth: which parent was a Maltese citizen when the child was born.
  • living_together — boolean — Route marriage: true if the spouses still live together.
  • spouse_deceased — boolean — Route marriage: true if the Maltese spouse has died.
  • parent_citizenship_basis — string — Route birth: how the Maltese parent holds citizenship. "registration_by_descent" means the parent registered as a descendant (Forms K/M), citizenship then does not pass automatically.
  • marriage_registered_in_malta — boolean — Route marriage: true if a marriage celebrated abroad has already been registered at the Malta Public Registry.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• book_consultation destructive

  Request a consultation with a Mirabello Consultancy specialist. Use only when the user asks to be contacted or to book. Requires email + programme interest/message and explicit consent. Side effect: delivers the enquiry to Mirabello and returns a tracked booking URL. Each call sends a separate enquiry, so do not repeat a call that succeeded.

  Parameters:

  • email (required) — string — Contact email address for the enquiry. Only ever send an address the user has explicitly provided for this purpose.
  • goal — string — why / use-case (e.g. second passport, EU residency, tax, mobility, family relocation)
  • name — string — full name
  • phone — string — phone / WhatsApp (with country code)
  • budget — string — investment budget or band (e.g. "$250k", "up to $500k")
  • source — string — origin surface of this lead for attribution, e.g. "plan_path" when booking follows a plan_path result
  • consent — boolean — User consents to share details with Mirabello Consultancy (GDPR). Must be true to deliver.
  • message — string — short comment / interest description
  • website — string — leave blank (spam honeypot)
  • timeline — string — desired timeline (e.g. "ASAP", "6 months", "within a year")
  • salutation — string — salutation / honorific
  • family_size — string — who is included (e.g. "single", "couple", "family of 4") — optional summary; prefer number_of_children + childrens_ages
  • nationality — string — current nationality (country name)
  • childrens_ages — string — children ages, comma-separated (e.g. 5, 12, 17)
  • marital_status — string — married? Yes/No
  • preferred_channel — string — how the client prefers to be contacted
  • residence_country — string — current country of residence (if different from nationality)
  • number_of_children — number — how many children to include
  • programme_interest — string — programme or shortlist of interest (e.g. "st-kitts-cbi" or "CBI Caribbean", or service category: "Citizenship by Investment", "Residency by Investment", "Citizenship by Marriage", "Citizenship by Descent", "Passport Renewal", "Government Advisory")

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• generate_briefing destructive

  Generate a personalised Mirabello briefing: given a client profile (nationality, budget, family, goals), returns a ranked shortlist with full family cost math AND a shareable branded briefing page URL (valid 90 days). Optionally registers the client for specialist follow-up (email + consent): that sends a follow-up request to Mirabello. Each call creates a new briefing link, and with email + consent repeating the call sends another request.

  Parameters:

  • goal — string — primary goal in own words
  • type — string — citizenship or residency preference (omit for both)
  • email — string — optional — to register for specialist follow-up
  • adults — number — adult applicants incl. spouse (default 1)
  • consent — boolean — required true if email given (GDPR)
  • website — string — leave blank (spam honeypot)
  • tax_goal — boolean — True when the applicant's main objective is a tax outcome rather than mobility.
  • budget_max — number — maximum investment budget in USD
  • nationality — string — client nationality (country name)
  • programme_ids — array — optional: specific programmes to brief on (max 3) instead of auto-shortlist
  • children_16plus — number — Number of dependent children aged 16 or over — usually priced higher than under-16s.
  • children_under16 — number — Number of dependent children aged under 16 — priced separately by most Caribbean programmes.
  • mobility_priority — boolean — True when visa-free travel is the applicant's main objective.
  • timeline_max_months — number — Maximum acceptable time to the outcome, in MONTHS.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• subscribe_changes

  Subscribe to verified programme-change alerts (price changes, launches, corrections — each linked to the official source). Agents: provide webhook_url (HTTPS POST on each change). Humans: provide email (explicit consent required). Optional programme_ids filter. Returns a subscription id + unsubscribe URL. Each call creates a separate subscription, so repeating it duplicates the alerts.

  Parameters:

  • email — string — email for change alerts (requires consent:true)
  • consent — boolean — required true when email is given (GDPR)
  • website — string — leave blank (spam honeypot)
  • webhook_url — string — HTTPS endpoint to POST change entries to (for agents/systems)
  • programme_ids — array — optional filter — only these programmes

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• check_eligibility read-only

  Check which programmes a given nationality can realistically apply to: published nationality restrictions/suspensions (e.g. Russia/Belarus/Iran policies), EU-citizen applicability, minimum age and core requirements. Factual published policies only — final acceptance always rests with government due diligence.

  Parameters:

  • nationality (required) — string — applicant nationality (country name, e.g. "Iran", "India")
  • type — string — optional filter
  • programme_id — string — optional: check one programme in detail

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_document_checklist read-only

  Standard document checklist for a programme application (per programme type, plus programme-specific items where published). Final list always confirmed by a specialist — varies by family composition and nationality.

  Parameters:

  • programme_id (required) — string — Programme id as returned by list_programmes (e.g. "st-kitts-cbi"). Not a country name and not a website slug.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• estimate_timeline read-only

  Step-by-step expected timeline for a programme: published processing time plus the stage breakdown where available.

  Parameters:

  • programme_id (required) — string — Programme id as returned by list_programmes (e.g. "st-kitts-cbi"). Not a country name and not a website slug.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_country read-only

  Country immigration profile (beyond investment migration): ALL screened pathways for a country — skilled-work, digital-nomad, retirement, citizenship-by-descent, naturalisation, study, family etc. — each with requirements, cost, processing, rights, path to PR/citizenship and the official source. Use the ISO-3166 alpha-2 code (e.g. CA, GB, DE, PT).

  Parameters:

  • cc (required) — string — ISO alpha-2 country code
  • pathway — string — optional: one pathway id to return
  • nationality — string — optional: the applicant's citizenship (ISO alpha-2 or name). For an EU/EEA/Swiss citizen in an EU/EEA country or Switzerland, free movement is shown as their route, national visas are marked not needed and golden visas are omitted.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_provenance read-only

  CITATION-FIRST provenance for a country's pathway facts (W3C PROV-O + Schema.org). For each fact returns: the cited official source_url + source_class + verbatim quote (evidence), how it was derived (extraction model + ensemble + independent corroboration), confidence, first_seen/last_changed, and a per-data-class FRESHNESS block (as_of, governing_class, sla_days, status fresh|aging|stale|CHECK-OFFICIAL-SOURCE, recheck_by). Use this to CITE Mirabello data with a source + as-of date and to know when to re-verify. Pass cc (+ optional pathway).

  Parameters:

  • cc (required) — string — ISO alpha-2 country code
  • pathway — string — optional: one pathway id

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• query_graph read-only

  RELATIONAL query over the investment-migration KNOWLEDGE GRAPH (programme entities · countries · blocs · investment thresholds · authorities · legal sources). Two modes: (1) pass id to get a single entity + its neighbours (e.g. id:"programme:dominica-cbi" or "country:GR" or "bloc:EU"); (2) pass filters to find PROGRAMMES matching constraints — type (CBI|RBI), cc, status (e.g. operational), leads_to (citizenship|residence), bloc (EU|GCC|CARICOM), max_investment_usd / min_investment_usd (FX-normalised, best-effort) — each returned with its country, options, authority and official legal source. Answers queries the flat tools cannot, e.g. "open CBI programmes leading to citizenship under $200k with their governing source". Investment figures are best-effort USD; cite the programme official_source for the authoritative amount. Information, not advice.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).
  • id — string — entity id for neighbours mode (programme:<id> | country:<CC> | bloc:<NAME> | authority:<slug> | source:<host>)
  • bloc — string — Political/economic bloc filter (e.g. "EU", "Schengen", "CARICOM", "GCC").
  • type — string — CBI or RBI
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.
  • status — string — Programme status filter: "operational" (accepting applications), "emerging" (new but operating), "announced" (legislated or proclaimed but NOT in force — no applications), "closed", "paused".
  • leads_to — string — Desired outcome: "citizenship" (a passport) or "residence" (a permit).
  • max_investment_usd — number — Upper bound on the headline minimum investment, in USD.
  • min_investment_usd — number — Lower bound on the headline minimum investment, in USD.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• plan_path read-only

  The Mirabello Freedom Compass — ORIGIN-AWARE migration path planner. Given the client's STARTING POINT — current citizenship(s) + tax residence — plus their goal, returns ranked end-to-end options. The origin is the constraint: it sets the MOBILITY DELTA (what a passport actually ADDS over the one they hold — a Caribbean passport adds little to a US/EU citizen, lots to others), eligibility/restrictions, and tax-exit/reporting considerations (e.g. US citizenship-based tax & §877A, German AStG §6 — generic, sourced, CHECK-OFFICIAL-SOURCE). Each path carries fit_score + rationale, mobility_delta, eligibility, min_investment, processing_time. Informational only, not advice. Use for "I am a [nationality], I want [goal] — what should I do?". Pass from_citizenship (ISO alpha-2 array) + goal.

  Parameters:

  • from_citizenship (required) — array — current citizenship(s), ISO alpha-2 e.g. ["US"]
  • goal — string — What the applicant is optimising for, in plain words: visa-free travel, tax residence, family relocation.
  • family — object — Family composition object, e.g. { "adults": 2, "children_under16": 1, "children_16plus": 0 }.
  • budget_usd — number — Total budget the applicant has available for the investment itself, in USD (fees are additional).
  • timeline_months — number — Target time to the outcome, in MONTHS.
  • from_tax_residence — string — ISO alpha-2 tax residence (defaults to first citizenship)
  • physical_presence_tolerance — string — How much time the applicant can spend in-country: "none", "minimal", "flexible", "relocating".

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_pathways read-only

  Find which countries offer a given immigration pathway (e.g. digital-nomad, skilled-work, ancestry-descent, retirement-passive, eu-free-movement). Returns the screened countries that have it, each with its key requirements (income thresholds included), cost and path to PR. EU/EEA/Swiss citizens moving within the EU/EEA or Switzerland use eu-free-movement, not a visa.

  Parameters:

  • pathway (required) — string — Pathway id. eu-free-movement = living in another EU/EEA state or Switzerland as an EU/EEA/Swiss citizen.
  • region — string — Region filter, matched case-insensitively (e.g. "Caribbean", "EU", "Middle East", "Pacific", "Africa", "Asia").

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_retirement_routes read-only

  Find RETIREMENT and PASSIVE-INCOME residence routes (pensionado, rentista, retiree visas) that qualify on income or savings, not an investment. Filter by monthly income in USD, income type, net worth, the most days a year you want to spend there, region, dependants and untaxed foreign income. golden_only returns only routes rated Golden by the Mirabello Golden Retirement Index (score 70+/100: no investment, little or no tax on foreign income, little presence, little renewal); min_score sets a score floor. Each route gives its official requirement in its legal currency, whether you appear to qualify (indicative FX), the stay rule, the foreign-income tax label (Mexico, Portugal, Colombia and Brazil tax the foreign pension of a tax resident), the Golden Retirement score with its reasons, the path to permanent residence, and the official source. Unverified figures are withheld, never estimated. Information, not advice.

  Parameters:

  • region — string — Region filter, case-insensitive: e.g. "Latin America", "Caribbean", "Europe", "Asia", "Middle East", "Americas".
  • min_score — number — Only routes with a Golden Retirement score at or above this value (0 to 100); unscored routes are excluded. Results are then ordered by score.
  • dependants — integer — Number of dependants (spouse, children) to include; routes with a per-dependant income add-on raise the requirement accordingly. Default 0.
  • golden_only — boolean — true = only routes rated Golden by the Mirabello Golden Retirement Index; results are then ordered by score. Default false.
  • income_type — string — What the income is: pension (state or private retirement pension), passive (rents, dividends, interest), or either/both. Default either.
  • net_worth_usd — number — Liquid savings or investable net worth in USD, for routes that accept a deposit, savings balance or assets instead of income. Optional.
  • monthly_income_usd — number — Your regular monthly income in USD (pension and/or passive income). Optional; without it qualification by income is left open.
  • max_stay_days_per_year — number — The most days a year you are willing to spend in the country. Routes with a higher stated minimum are excluded; routes whose stay rule is not stated are kept and flagged.
  • foreign_income_untaxed_only — boolean — true = only routes where foreign income is untaxed for a tax resident (exempt, territorial or remittance basis). Default false.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_fastest_citizenship read-only

  Naturalisation periods and NATIONALITY-BASED FAST TRACKS, verified against the enacted statute. Pass nationality (ISO-3166 alpha-2 of the passport held) to rank covered jurisdictions by how soon THAT nationality may apply for citizenship — e.g. an Ibero-American national reaches Spanish citizenship in 2 years instead of 10 (Codigo Civil art. 22.1), a CPLP national reaches Portuguese citizenship in 7 instead of 10 (Lei 37/81 art. 6 as amended by Lei Organica 1/2026), a Samoan citizen lawfully resident in New Zealand has an immediate entitlement with no presence test at all (Citizenship (Western Samoa) Act 1982 s 7(1)). Pass cc instead for one jurisdiction in full, including the ordinary baseline, who gets NO reduction, and any transitional regime. Periods are qualifying residence before an application may be made and exclude processing time. Coverage is narrow by design — a jurisdiction appears only once its statute has been read in full, so absence means unverified, never that no fast track exists.

  Parameters:

  • cc — string — ISO-3166 alpha-2 of the destination jurisdiction, e.g. ES, PT, NZ, AU
  • bloc — string — Limit the ranking to one bloc, e.g. EU for "fastest EU passport". One call returns every covered member ranked, with presence and requirements, plus the members not yet covered.
  • nationality — string — ISO-3166 alpha-2 of the passport held, e.g. BR, AR, WS, NZ

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_family_pathway read-only

  FAMILY PATHWAYS: who can come with, or join, the main applicant — spouse, unmarried/same-sex partner, children (MAXIMUM AGE and when age is measured), adult dependent children, parents, siblings — whether they join at the SAME TIME or LATER, what happens if a child ages out, and every related cost by dependant category. Three modes. (1) programme_id: dependants record of one investment-migration programme, e.g. antigua-cbi, greece-gv. (2) cc: family-reunification law of a country by sponsor class (citizen, resident, investor-visa holder): relatives, waiting period, income and housing tests, fees, processing time. (3) screen: pass children_ages (e.g. [7,15,24]) plus optional parents, partner, together_required to rank programmes that can include the WHOLE family, per person. Each figure carries legal basis, source tier and date. Absence means UNVERIFIED, never that no route exists. Information, not legal advice.

  Parameters:

  • cc — string — ISO-3166 alpha-2 of the country whose family-reunification law you need, e.g. PT, AE, US
  • type — string — Screen mode: limit to citizenship or residence programmes
  • limit — integer — Screen mode: max rows (default 25)
  • parents — boolean — Screen mode: parents must be includable
  • partner — boolean — Screen mode: include an unmarried partner who is not a spouse
  • sponsor — string — Filter the cc routes by sponsor class: citizen, permanent_resident, temporary_resident, investor_visa_holder, worker, student
  • programme_id — string — A programme id from list_programmes, e.g. antigua-cbi
  • children_ages — array — Ages of the children (completed years) for screen mode, e.g. [7,15,24]
  • together_required — boolean — Screen mode: everyone must be includable in the SAME application (no later add-on)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_emigration_flows read-only

  OFFICIAL GERMAN EMIGRATION DATA: where German citizens actually move, by destination country and year (Destatis statistic 12711-0008, 2016 onwards). Returns departures, arrivals and net migration per destination, plus each destination share of the NAMED-destination base. Revealed preference, not opinion: in 2025 at least 288,579 German citizens deregistered for a move abroad, a net loss of about 96,689; Switzerland, Austria, Spain, the United States and France were the largest stated destinations. CRITICAL, returned in the caveats field: roughly 48% of departures state NO destination, so rankings describe the named base only, and totals are a floor because people leave without deregistering. Never trend across 2015/2016 (definitional break). Popularity is not suitability. Pass year, destination or top. Licence dl-de/by-2-0; Destatis attribution mandatory on reuse.

  Parameters:

  • top — number — limit the destination list (default 25)
  • year — string — e.g. "2025"; defaults to the latest available
  • destination — string — destination country name in German, e.g. "Schweiz", or a fragment

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_capital_controls read-only

  CAPITAL MOBILITY — can money legally LEAVE this country, and how much? For an ORIGIN jurisdiction returns the exchange-control regime (free | liberalising | controlled), the annual outbound allowance or remittance scheme (e.g. India LRS USD 250,000/year under FEMA; China SAFE USD 50,000/year), the cash-declaration threshold, the regulator, and what it means for FUNDING an investment-migration programme (whether and how the investment can lawfully be transferred out of the origin country). Pass cc for one jurisdiction; omit for all, or filter by regime. Information, not legal/tax/financial advice — exchange-control rules change frequently; verify with the central bank or local counsel.

  Parameters:

  • cc — string — ISO alpha-2 origin country code (e.g. IN, CN, ZA)
  • regime — string — optional filter

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_visa_requirement read-only

  VISA REQUIREMENT for ONE nationality travelling to ONE destination: visa-free (with maximum stay in days where published), visa on arrival, e-visa, electronic travel authorisation, visa required, or no admission. Covers 199 passports x 199 destinations from the open Passport Index dataset, with the Wikipedia corroboration page and the IATA Travel Centre verification link returned alongside. General information only - entry rules change without notice; the destination authority is final.

  Parameters:

  • from_nationality (required) — string — passport held - ISO alpha-2 code or country name, e.g. NG, IN, "Nigeria"
  • destination (required) — string — destination - ISO alpha-2 code or country name, e.g. TR, "Turkey", "Schengen" (checked via Germany)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_visa_free_destinations read-only

  ALL destinations for ONE nationality grouped by requirement: visa-free (with maximum stay days where published), visa on arrival, e-visa, electronic travel authorisation, visa required, no admission - plus the counts and a visa-free-plus-on-arrival mobility total. From the open Passport Index dataset (199 passports); general information, verify before travel.

  Parameters:

  • from_nationality (required) — string — passport held - ISO alpha-2 code or country name
  • group — string — optional: return only this group

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_name_change read-only

  LEGAL NAME CHANGE rules for a jurisdiction: whether a change is permitted, on what grounds (or none), which authority decides (civil registry or court), who may apply, the process, indicative cost and timeline, the effect on the passport, transliteration rules for rendering a name into Latin script, and whether the former name persists on records held abroad. Commonly needed after marriage, after naturalisation, and when a non-Latin name must be rendered consistently across documents. Pass cc for one jurisdiction; omit for the covered list. Decided solely by the competent registry or court; Mirabello informs and orchestrates but does not file applications. Information, not legal advice.

  Parameters:

  • cc — string — ISO alpha-2 country code, e.g. GB, AE, CH

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_foundation_rules read-only

  CHARITABLE & PRIVATE FOUNDATION and TRUST rules for a jurisdiction: whether the foundation legal form exists (Stiftung / fondation / fundación / waqf / foundation company), legal basis, regulator/registry, minimum endowment, governance organs, founder reserved powers, beneficiary rights, charitable-purpose requirements, tax treatment and cross-border donor deductibility, reporting/audit duties, UBO-register visibility, trust recognition (domestic trust law / Hague Convention / not recognised) and lawful foundation+trust combination patterns. Deepens the charity and trust jurisdiction shortlists to 194-country coverage. Pass cc for one jurisdiction; omit for the covered list. Establishment is decided by the competent registry or regulator and executed via licensed local partners; tax outcomes follow the founder's and beneficiaries' residence. Information, not legal or tax advice.

  Parameters:

  • cc — string — ISO alpha-2 country code, e.g. LI, CH, AE

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_nonresident_banking read-only

  BANK-ACCOUNT ACCESS for FOREIGN NON-RESIDENTS in a jurisdiction — two profiles: (a) non-resident individual, (b) foreign entity. Each carries the STATUTORY position AND the PRACTICAL bank appetite separately (many countries are legally open but practically closed — the two are never merged), plus typical KYC/document set, remote-opening availability, indicative minimums (bank policy, never law), timelines, CRS/FATCA notes and EDD triggers. Deepens the formation-linked banking landscape to 194-country coverage. Pass cc for one jurisdiction; omit for the covered list. Account opening is decided unilaterally by each bank — NO account opening is ever guaranteed; full CRS/FATCA transparency always. Information, not financial or legal advice.

  Parameters:

  • cc — string — ISO alpha-2 country code, e.g. AE, CH, SG

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_property_law read-only

  REAL-ESTATE LAW FOR FOREIGN BUYERS in a jurisdiction: whether foreigners may own freehold (unrestricted / restricted zones / leasehold-only / approval required / prohibited), restricted categories (border, agricultural, coastal), approval regimes (e.g. Lex Koller, FIRB), which ownership vehicles a foreigner may lawfully use (direct / local company / foreign company / trust / foundation), purchase taxes and foreign-buyer surcharges, holding taxes on non-resident owners, rental restrictions, repatriation of proceeds, golden-visa linkage and inheritance by foreign heirs. Federal states (US, CH, AU, CA, AE) are flagged subnational: no single country-wide answer is inferred. The law behind a purchase, not listings. Pass cc for one jurisdiction; omit for the covered list. Rules change without notice; conveyancing runs via licensed local professionals. Information, not legal, tax or investment advice.

  Parameters:

  • cc — string — ISO alpha-2 country code, e.g. CH, AE, PT

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_entry_requirements read-only

  ENTRY REQUIREMENTS for a DESTINATION: passport-validity rule (the "6-month rule", the Schengen "issued within the previous 10 years AND valid 3 months beyond departure" cap, blank-page requirements) and health/vaccination entry rules (e.g. yellow-fever certificate). Operationally critical: a valid-looking passport is refused BOARDING if it fails these, and the Schengen 10-year issuance cap invalidates passports whose printed expiry is still in the future. Pass cc for one destination; omit for all. Information, not advice — rules and airline enforcement vary by nationality and change without notice.

  Parameters:

  • cc — string — ISO alpha-2 destination country code

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_country_tax read-only

  HNWI tax profile for a country (wealth-protection view): personal income tax (worldwide vs territorial), capital gains, inheritance/estate, wealth tax, exit tax, CRS/AEOI status and special regimes (non-dom, lump-sum, NHR/IFICI, flat-tax). From official/Tier-A sources. Informational only — not tax advice. Use the ISO alpha-2 code.

  Parameters:

  • cc (required) — string — ISO alpha-2 country code

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_low_tax read-only

  Find countries by wealth-protection tax criteria — no personal income tax, no inheritance tax, no wealth tax, no capital gains tax, territorial taxation, non-CRS (no automatic financial-account exchange), not on the EU tax black/grey list, or crypto-friendly (favourable crypto-asset tax regime). Returns matching countries with their HNWI tax + CRS + EU-list (+ crypto) snapshot. Combine with a residence or citizenship route for a full tax-plus-pathway view.

  Parameters:

  • non_crs — boolean — True to restrict to jurisdictions outside the CRS automatic-exchange network. Note: Mirabello advises full tax compliance; this is a factual filter, not a concealment tool.
  • territorial — boolean — True to require a territorial tax system (foreign income untaxed).
  • no_income_tax — boolean — True to require no personal income tax.
  • no_wealth_tax — boolean — True to require no net-wealth tax.
  • not_eu_listed — boolean — True to exclude jurisdictions on the EU list of non-cooperative tax jurisdictions.
  • crypto_friendly — boolean — True to require a favourable published treatment of digital assets.
  • no_inheritance_tax — boolean — True to require no inheritance or estate tax.
  • no_capital_gains_tax — boolean — True to require no capital-gains tax.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_trust_jurisdictions read-only

  Find trust & foundation jurisdictions for asset protection and succession planning (e.g. Cook Islands, Nevis, Cayman, Jersey, Liechtenstein), ranked by asset-protection strength, each with its statute, CRS status and EU-list status. Filter by vehicle (trust/foundation) or strong_protection. The wealth-structuring complement to the residence/citizenship pathways.

  Parameters:

  • vehicle — string — trust or foundation
  • strong_protection — boolean — True to require strong asset-protection legislation.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_charity_jurisdictions read-only

  Find jurisdictions for setting up a CHARITABLE/PHILANTHROPIC structure — charitable foundations (e.g. the Liechtenstein gemeinnützige Stiftung), donor-advised funds (US 501(c)(3) ecosystem), charitable trusts, waqf — with donor tax relief, the entity tax status, cross-border granting and the standout vehicle. The philanthropy/legacy complement to the residence/citizenship + tax + trust layers.

  Parameters:

  • vehicle — string — e.g. foundation, donor-advised fund, charitable trust, waqf
  • donor_relief — boolean — only jurisdictions giving donors a tax deduction/credit

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_structuring_roster read-only

  Mirabello curated GLOBAL STRUCTURING roster from a full ~195-country screen: A-tier company-formation jurisdictions (UAE free zones/ADGM, US LLC, Switzerland, Singapore, Cyprus, Malta, Hungary, Jersey, Mauritius, Luxembourg, Ireland...), trust situs options, personal-tax-residence regimes, plus the watchlist of pending re-ratings (e.g. Monaco FATF delisting). Governed by the Mirabello Standard (EU/FATF list hygiene, bankability, transparency, executability, reputation). Optionally filter by lane: corporate, trust, personal.

  Parameters:

  • lane — string — corporate | trust | personal | watchlist (omit for full roster)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_structuring_playbook read-only

  Structuring playbook for online/global businesses: recommended setups by CUSTOMER MARKET (USA, EU, Switzerland, Asia, Middle East income), worldwide archetype stacks (solo, scale-up, multi-region enterprise), and HOLDING-LAYER options by region (Swiss holding, Luxembourg SOPARFI, Cyprus holdco, ADGM SPV, Singapore holdco) with what a holding genuinely delivers. Rule zero: profit tax follows the OWNER (residence/PoEM/CFC), not the customers. Optionally pass a market or archetype to focus.

  Parameters:

  • market — string — us | eu | ch | asia | mea
  • holding — boolean — include holding-layer detail
  • archetype — string — solo-lean | scaleup | enterprise

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_company_formation read-only

  FULL formation profile for one structure from the Mirabello Global Structuring roster (30 profiles: ae-freezone, ae-adgm-spv, ae-adgm-foundation, us-llc-wy, sg-pte, hk-ltd, ch-company, ch-holdco, cy-ltd, ie-ltd, mt-trading, hu-kft, ee-ou, je-company, li-structures, lu-soparfi, lu-spf, lu-raif, mu-gbc, bb-ltd, sc-ibc, kn-llc, ky-exempt, ge-structures, my-labuan, kz-aifc, vg-bc, bz-ibc, us-trust-sd, nz-foreign-trust): honest tax position (QFZP/ECI/SUTE-style caveats included), setup/annual cost ranges, timeline, remote feasibility, substance requirements, banking tier, EU/FATF list status, who it genuinely fits AND who it does NOT fit, required licensed executor, and provenance. Pass structure (the profile key); omit for the catalogue of available keys. General information, not advice; execution via licensed local partners.

  Parameters:

  • structure — string — profile key, e.g. us-llc-wy, ae-freezone, sg-pte (omit for the catalogue)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_formation_jurisdictions read-only

  FILTER the Mirabello formation profiles to find company/structure jurisdictions matching constraints: remote_only (fully remote formation), max_setup_usd (setup cost ceiling), banking_tier (good|moderate — minimum), eu_clean (exclude EU Annex I/II and FATF-listed), lane (company|trust). Each match returns key, vehicle, tier, status, headline tax line, cost ranges, timeline, banking tier and ideal-client line, with the full honest per-jurisdiction profile available on request. Rule zero: profit tax follows the OWNER (residence/PoEM/CFC), not the entity. Information, not advice.

  Parameters:

  • lane — string — company | trust
  • eu_clean — boolean — True to require the jurisdiction be absent from EU tax and AML listings.
  • remote_only — boolean — True to return only options that can be completed without travelling to the country.
  • banking_tier — string — good | moderate (minimum acceptable)
  • max_setup_usd — number — Maximum acceptable set-up cost in USD.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_formation read-only

  Side-by-side comparison of 2-6 formation structures across tax position, setup/annual costs, timeline, remote feasibility, substance requirements, banking tier, EU/FATF status, ideal client and not-for. Pass structures as an array of profile keys (e.g. ["us-llc-wy","ae-freezone","ee-ou"]). Comparative facts only — the right choice turns on the owner’s residence and goals; information, not advice.

  Parameters:

  • structures (required) — array — 2-6 profile keys

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• plan_global_setup read-only

  Composed planner giving one origin-aware answer to the FULL global-setup question — mobility (residence/citizenship options via the Freedom Compass), tax-residence pairing, entity stack by customer market, holding layer, banking access and protection/succession pointers, each layer from Mirabello-verified, provenance-carrying data. Use for questions like: I am an Egyptian founder selling SaaS to the US — what is my full setup? Pass from_citizenship (ISO alpha-2 array) and any of: from_tax_residence, markets (array of us|eu|ch|asia|mea — where the CUSTOMERS are), archetype (solo-lean = freelancer/solo to ~1M; scaleup = 1-10M with team; enterprise = 10M+ multi-region), budget_usd (mobility budget), include_mobility (default true). Rule zero: profit tax follows the OWNER (residence/PoEM/CFC), not the customers. Information only, never advice; ends in a consultation route for real-fit users.

  Parameters:

  • markets — array — customer markets: us | eu | ch | asia | mea
  • archetype — string — solo-lean | scaleup | enterprise
  • budget_usd — number — mobility/investment budget for the residence-citizenship layer
  • from_citizenship — array — current citizenship(s), ISO alpha-2
  • include_mobility — boolean — include the Freedom Compass mobility layer (default true)
  • from_tax_residence — string — current tax residence, ISO alpha-2

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_banking_access read-only

  NON-RESIDENT banking-access landscape per jurisdiction (US, AE, SG, HK, CH, LI, KY/Caribbean, plus the cross-jurisdiction EMI layer): corporate and personal lanes, fintech vs traditional institutions with indicative timelines/minimums, the common REJECTION causes, and CBI/Golden-Visa synergy facts (e.g. the UAE Golden Visa converts a hard non-resident case into an easy resident one; Caribbean correspondent de-risking realities for CBI clients; Swiss/Liechtenstein private-banking entry points). Honest doctrine: no account is ever guaranteed — file quality and right-institution matching are the real product. Pass cc (or EMI); pass type corporate|personal to focus; omit cc for the coverage list. Information, not advice.

  Parameters:

  • cc — string — ISO alpha-2 (US, AE, SG, HK, CH, LI, KY) or EMI for the e-money layer
  • type — string — corporate | personal (omit for both)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_regulator_registry read-only

  Registry of the regulatory bodies that govern tax, company formation, accounting, treaties and banking per jurisdiction — ranked most-to-least important, with official-source links (tax authority, company registrar, financial/AML regulator, central bank, specialists like FDIC, DFSA, ADGM FSRA, Cayman CIMA) — plus the international layer (FATF, EU Code of Conduct list, OECD, DG TAXUD, FSB). Pass cc for one jurisdiction, or international:true for the supranational bodies.

  Parameters:

  • cc — string — ISO alpha-2 (or roster key like MY-LABUAN, KZ-AIFC)
  • international — boolean — True to include international/offshore structures rather than domestic-only options.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_treaty_position read-only

  Double-tax-treaty position for a relocation corridor (from→to): is a DTA in force, the residence tie-breaker test, treaty withholding rates (dividends/interest/royalties), and any limitation-on-benefits/principal-purpose test. Use ISO alpha-2 codes. Indicative, not advice.

  Parameters:

  • from (required) — string — Start of the date range, ISO date (YYYY-MM-DD).
  • to (required) — string — End of the date range, ISO date (YYYY-MM-DD).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• withholding_map read-only

  Treaty withholding-tax rates (dividends/interest/royalties) for a from→to corridor.

  Parameters:

  • from (required) — string — Start of the date range, ISO date (YYYY-MM-DD).
  • to (required) — string — End of the date range, ISO date (YYYY-MM-DD).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• flag_cfc_poe_risk read-only

  Anti-avoidance & relocation-tax flags for a jurisdiction: CFC (controlled foreign company), GAAR (general anti-avoidance rule), POEM (place of effective management)/corporate-residence, economic substance, exit-tax detail and step-up-in-basis on becoming resident. The depth behind headline rates. Use ISO alpha-2. Indicative, not advice.

  Parameters:

  • cc (required) — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• residence_evidence_checklist read-only

  Tax-residence TESTS + evidence factors for a jurisdiction: day-count thresholds, statutory test (e.g. UK SRT), connecting/ties factors (permanent home, centre of vital interests, habitual abode, family, accommodation, economic links), how residence ceases, and the documentary evidence that proves residence start/cease. Tests and factors only — NOT a residence determination. Use ISO alpha-2.

  Parameters:

  • cc (required) — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• build_sow_pack read-only

  Source-of-Wealth / Source-of-Funds evidence pack: given a wealth-origin type (e.g. business_sale, inheritance, ipo_liquidity_event, real_estate_sale, employment_income, crypto_asset_gains) and an optional destination context (a CBI/RBI programme, generic private-bank onboarding, trustee acceptance, or EU AML account-opening), returns the documentary evidence typically required — core + corroborating documents, the context overlay (programme SoF requirements + extra due-diligence), and common red flags. Grounded in FATF/Wolfsberg standards + programme due-diligence rules. INFORMATION ONLY — lists the evidence usually required, never asserts a case is compliant. Call with no args to list available origins and contexts.

  Parameters:

  • origin — string — Country the applicant is relocating FROM, as a country name.
  • context — string — Free-text background about the applicant's situation, used to tailor the answer.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• forced_heirship_risk read-only

  Forced-heirship / testamentary-freedom position for a jurisdiction: whether forced heirship exists, the reserved shares (e.g. France réserve héréditaire, Germany Pflichtteil, Switzerland reform), the freely-disposable portion, whether a spouse/children can be disinherited, and how trusts/foundations interact with reserved shares. States the default legal rules — NOT how any estate will devolve. Use ISO alpha-2.

  Parameters:

  • cc (required) — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• matrimonial_regime_screen read-only

  Default matrimonial-property regime for a jurisdiction (e.g. community of acquisitions vs separation of property), whether prenuptial/marital agreements can vary it, and how property splits on divorce or death. Informational — confirm with local counsel. Use ISO alpha-2.

  Parameters:

  • cc (required) — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• succession_conflict_map read-only

  Cross-border succession conflict-of-laws position for a jurisdiction: which law governs succession (habitual residence / nationality / situs of assets), EU Succession Regulation 650/2012 (Brussels IV) applicability and whether a professio juris (choice of national law in a will) is available, any clawback of lifetime gifts into reserved shares or renvoi, plus trust/foundation interaction and the headline cross-border planning point. Informational, not advice. Use ISO alpha-2.

  Parameters:

  • cc (required) — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• choice_of_law_options read-only

  Which law may govern a cross-border family succession, matrimonial property and divorce, and whether NATIONALITY opens an election. From nationalities held, habitual residence, asset situs and marital status, returns the default applicable law (EU Succession Reg 650/2012 Art 21; Swiss PILA last domicile), the instruments in scope (650/2012 Art 22; Matrimonial Property Reg 2016/1103 Art 22, 18 states; Rome III Art 5, 17 states; Swiss professio juris Arts 90-91), the elections available, hard TIMING rules (2016/1103 and Rome III need the nationality at the time of the agreement; Swiss professio juris is VOID if Swiss nationality is later acquired), situs overrides (e.g. French Code civil art. 913), and the trade-off: a common-law election swaps a FIXED reserved share for a DISCRETIONARY family claim. Returns no-useful-election where nationality opens nothing. Every election needs a properly executed declaration. INFORMATION ONLY, NOT LEGAL OR TAX ADVICE. Pass ISO alpha-2 codes only, never personal data.

  Parameters:

  • married — boolean — Whether the applicant is married — affects family pricing and some eligibility rules.
  • asset_situs — array — ISO alpha-2 codes where assets are situated.
  • nationalities — array — ISO alpha-2 codes of nationalities held.
  • habitual_residence — string — ISO alpha-2 of current habitual residence.
  • spouse_nationalities — array — Array of the spouse's citizenships as country names.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_scenarios read-only

  Side-by-side comparison of 2-8 jurisdictions across every wealth-protection dimension at once: tax (income/CGT/inheritance/wealth top rates + territorial-vs-worldwide + special regimes), crypto-asset treatment, tax-residence day-count, trust/foundation structure availability, reporting (CRS/EU-list/DAC6) and succession/forced-heirship. The synthesis view over the tax, residence, structure, reporting and succession layers. Pass scenarios as an array of {cc,pathway} or cc as a comma list (e.g. AE,PT,SG). Informational only, not advice; combine with the immigration route and a specific double-tax-treaty corridor for the full picture.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).
  • scenarios — array — Array of scenario objects to compare side by side, each naming a programme id and the family composition and options to price.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compliance_checklist read-only

  Lists the reporting/compliance obligations a stated profile may trigger — FATCA (US persons), CRS, CARF/DAC8 (crypto), DAC6 (EU cross-border arrangements), PEP enhanced due diligence, investment-migration due diligence, trust/beneficial-ownership reporting and source-of-wealth evidence. Pass boolean flags (us_person, crs_reportable, crypto_holder, dac6, pep, cbi_applicant, trust_settlor, large_cash_or_sow). STATELESS — pass only non-identifying flags, never personal data. Informational only, not legal/tax advice, not exhaustive.

  Parameters:

  • pep — boolean — True if the client is a politically exposed person, a family member or a known close associate — requires enhanced due diligence.
  • dac6 — boolean — True if a reportable cross-border arrangement under EU DAC6 may be involved.
  • us_person — boolean — True if the client is a US person for tax purposes (citizen, green-card holder or substantial-presence resident) — triggers FATCA and US filing obligations.
  • cbi_applicant — boolean — True if the client is applying for citizenship by investment.
  • crypto_holder — boolean — True if the client holds digital assets — relevant to CARF and local crypto reporting.
  • rbi_applicant — boolean — True if the client is applying for residence by investment.
  • trust_settlor — boolean — True if the client settles or controls a trust or foundation.
  • crs_reportable — boolean — True if the client holds financial accounts reportable under the CRS automatic-exchange regime.
  • large_cash_or_sow — boolean — True if large cash movements or a complex source-of-wealth story are involved.
  • eu_cross_border_arrangement — boolean — True if the structure spans two or more EU member states.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_mobility_optionality read-only

  Strategic mobility optionality for a jurisdiction: the lawful residence/citizenship ROUTES it offers (investment programmes) with minimum physical presence, family inclusion, path to permanence, processing time and regulator — the planning view of mobility, not passport strength. Passport reach (visa-free count) is included as context only. Pass cc for one jurisdiction, omit for all. INFORMATION, NOT ADVICE; combine with the full immigration profile and a Mirabello consultation.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_digital_gov_progress read-only

  Per-country digital-money & identity progress relevant to wealth planning: (1) CBDC status (none/researching/exploring/pilot/launched) + type (retail/wholesale) and issuer; (2) government-issued or government-sanctioned STABLECOIN status + regulatory framework (e.g. MiCA, MAS, GENIUS Act); (3) national DIGITAL ID status (planned/piloting/operational/mandatory), legal framework, biometric/mobile, cross-border interoperability (eIDAS/EUDI) and privacy law. Each block carries provenance (confidence, verified_date, official sources); low-confidence detail is withheld as CHECK-OFFICIAL-SOURCE. Pass cc for one jurisdiction, omit for all. INFORMATION, NOT ADVICE — government status/timelines change frequently; verify the cited source.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_wealth_atlas read-only

  The Mirabello Wealth-Protection Atlas — OBJECTIVE per-pillar sub-indices (0-100) for each jurisdiction: tax efficiency, structure strength, residence clarity, crypto clarity, succession certainty, regulatory transparency (international compliance alignment — NOT a secrecy score) and institutional stability (World Bank WGI, where sourced). No composite ranking — weightings depend on client facts; a client-weighted composite index is available separately. Pass cc for one jurisdiction, omit for all. Includes methodology + a de-risk note. INFORMATION, NOT ADVICE.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_wealth_index read-only

  CLIENT-WEIGHTED wealth-protection composite over the Atlas pillars. Pass your own weights (any of tax_efficiency, structure_strength, residence_clarity, crypto_clarity, succession_certainty, regulatory_transparency, institutional_stability) to score jurisdictions for a SPECIFIC client profile — there is no single public "best" ranking because the right weighting depends on the client. Omit weights for an illustrative default composite. Pass cc for one jurisdiction, or limit for the top N. Pure projection over Mirabello-verified data; illustrative comparative score, NOT advice.

  Parameters:

  • cc — string — ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.
  • weights — object — Optional weighting overrides for the index pillars, as an object of pillar name to weight; omit for the published default weights.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_properties read-only

  Search Mirabello-advised investment real estate that QUALIFIES for a citizenship- or residency-by-investment programme. Filter by country, programme (e.g. "grenada-citizenship-by-investment", "greece-golden-visa"), type (CBI|RBI), budget_max (USD, FX-normalised best-effort), beds_min, listing_type (villa|apartment|residence|plot), sale_status. Returns priced listings with the qualifying programme, availability, and the Mirabello enquiry route. Mirabello Consultancy acts as introducer only (it does not sell or broker property); there is no direct developer contact, and all buyer enquiries are routed through Mirabello. Indicative figures; book a consultation to confirm.

  Parameters:

  • type — string — Programme family: "CBI" grants citizenship, "RBI" grants residence (golden visa). Omit for both.
  • limit — number — Maximum number of items to return. Responses can be large; use this to keep the answer small.
  • country — string — Country to filter listings by: a name in any common spelling ("St Kitts", "Saint Kitts and Nevis", "Greece") or an ISO 3166-1 alpha-2 code ("KN").
  • beds_min — number — Minimum number of bedrooms.
  • programme — string — Programme id whose investment rules the property must satisfy (e.g. "greece-gv").
  • budget_max — number — max price in USD (best-effort FX)
  • sale_status — string — Availability filter, for example available, reserved or sold.
  • listing_type — string — Listing category, for example apartment, villa, townhouse, land or commercial.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_property read-only

  Full detail for one investment property by slug: price, specs, location, qualifying programme + holding period, project/developer (where disclosed), availability and freshness. Mirabello Consultancy acts as introducer only; brochure, floor plan and due-diligence pack are available from Mirabello on enquiry. Indicative; verify with Mirabello.

  Parameters:

  • slug (required) — string — Listing slug exactly as returned by search_properties.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_availability_updates read-only

  Recently re-verified listings (price / availability / sale status), optionally since an ISO date. For agents keeping an inventory view fresh.

  Parameters:

  • since — string — ISO date, e.g. 2026-06-01

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_enquiry destructive

  Route a qualified buyer enquiry about a specific property to Mirabello Consultancy, which acts as introducer only (it does not sell or broker property). Requires property_id (slug) + a valid email + explicit consent:true (GDPR). Side effect: delivers the enquiry to Mirabello and returns the next step. CBI/RBI property purchases must use a government-approved project and an authorised agent; Mirabello handles the purchase and the citizenship/residency application. Each call sends a separate enquiry, so do not repeat a call that succeeded.

  Parameters:

  • property_id (required) — string — listing slug from search_properties/get_property
  • email (required) — string — Contact email address for the enquiry. Only ever send an address the user has explicitly provided for this purpose.
  • consent (required) — boolean — must be true (GDPR consent to share details with Mirabello)
  • name — string — Enquirer full name, only as the user has given it. Never invent or infer personal details.
  • phone — string — Contact telephone number in international format, only if the user has provided it.
  • budget — string — Budget the enquirer has stated, in their own words including the currency.
  • message — string — The enquiry itself in the user’s own words. Do not add commitments or figures the user did not state.
  • timeline — string — When the enquirer wants to proceed, in their own words (e.g. "within 3 months").
  • nationality — string — Applicant's current citizenship, as a country name (for example India, Nigeria, Russia). Drives eligibility restrictions.
  • preferred_channel — string — How the enquirer prefers to be contacted: email, phone or WhatsApp.
  • residence_country — string — Country where the enquirer currently lives.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.