com.mirabelloconsultancy/mcp

Official64 tools

by mirabello-consultancy

Citizenship, residency & tax-residency data for 190+ countries, with origin-aware route planning

com.mirabelloconsultancy/mcp (MCP)

This MCP server provides citizenship, residency, and tax-residency data for 190+ countries. It also includes origin-aware route planning. The available description indicates the server focuses on country-level location and legal-status information and uses origin context when planning routes.

🛠️ Key Features

Citizenship, residency, and tax-residency data
Coverage for 190+ countries
Origin-aware route planning

🚀 Use Cases

Determine citizenship and residency information by country
Support tax-residency related research across multiple jurisdictions
Plan routes while accounting for a specified origin context

⚡ Developer Benefits

Country dataset scope stated as 190+ countries
Single service scope combining legal-status data with origin-aware routing needs

⚠️ Limitations

No tool count or specific MCP tools are provided in the available data
No additional documentation details (e.g., topics or README excerpt) are included

Topics

ai-agentsapicitizenship-by-investmentgolden-visamcpmodel-context-protocolinvestment-migrationimmigrationmcp-serverrelocationresidency-by-investmenttax-residencyvisawealth-management

Captured live from the server via tools/list.

list_programmes

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.

Parameters5

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

Raw schema

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

get_programme

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Programme id as returned by list_programmes (e.g. \"dominica-cbi\", \"greece-gv\", \"portugal-gv\"). Not a country name and not a website slug.",
      "examples": [
        "dominica-cbi",
        "greece-gv"
      ]
    }
  },
  "required": [
    "id"
  ]
}

compare_programmes

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "programme id (use with b) for the canonical two-programme artefact"
    },
    "b": {
      "type": "string",
      "description": "programme id (use with a)"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 4,
      "description": "2-4 programme ids for the classic comparison"
    }
  }
}

get_processing_times

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.

Parameters1

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Programme id as returned by list_programmes (e.g. \"dominica-cbi\", \"greece-gv\", \"portugal-gv\"). Not a country name and not a website slug.",
      "examples": [
        "dominica-cbi",
        "greece-gv"
      ]
    }
  }
}

estimate_total_cost

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.

Parameters4

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

Raw schema

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

recommend_programmes

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

Parameters6

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

Raw schema

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

check_visa_free

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "programme_id": {
      "type": "string",
      "description": "Programme id as returned by list_programmes (e.g. \"st-kitts-cbi\"). Not a country name and not a website slug.",
      "examples": [
        "st-kitts-cbi"
      ]
    },
    "destination": {
      "type": "string",
      "description": "optional: check access to a specific destination (e.g. Schengen, UK, USA, China)"
    }
  },
  "required": [
    "programme_id"
  ]
}

get_index

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "CBI",
        "RBI"
      ],
      "description": "Programme family: \"CBI\" grants citizenship, \"RBI\" grants residence (golden visa). Omit for both.",
      "examples": [
        "CBI"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of items to return. Responses can be large; use this to keep the answer small.",
      "examples": [
        10
      ]
    }
  }
}

get_recent_changes

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of items to return. Responses can be large; use this to keep the answer small.",
      "examples": [
        10
      ]
    }
  }
}

get_about

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_passport_renewal

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.

Parameters1

country

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "programme id (e.g. st-kitts-cbi, st-lucia-cbi) or country alias; omit for all six"
    }
  }
}

book_consultation

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.

Parameters19

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

Raw schema

{
  "type": "object",
  "properties": {
    "salutation": {
      "type": "string",
      "enum": [
        "Mr.",
        "Ms.",
        "Mrs.",
        "Sheikh",
        "Prof.",
        "Dr."
      ],
      "description": "salutation / honorific"
    },
    "name": {
      "type": "string",
      "description": "full name"
    },
    "email": {
      "type": "string",
      "description": "Contact email address for the enquiry. Only ever send an address the user has explicitly provided for this purpose."
    },
    "phone": {
      "type": "string",
      "description": "phone / WhatsApp (with country code)"
    },
    "preferred_channel": {
      "type": "string",
      "enum": [
        "email",
        "phone",
        "whatsapp",
        "telegram",
        "wechat"
      ],
      "description": "how the client prefers to be contacted"
    },
    "programme_interest": {
      "type": "string",
      "description": "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\")"
    },
    "source": {
      "type": "string",
      "description": "origin surface of this lead for attribution, e.g. \"plan_path\" when booking follows a plan_path result"
    },
    "goal": {
      "type": "string",
      "description": "why / use-case (e.g. second passport, EU residency, tax, mobility, family relocation)"
    },
    "budget": {
      "type": "string",
      "description": "investment budget or band (e.g. \"$250k\", \"up to $500k\")"
    },
    "timeline": {
      "type": "string",
      "description": "desired timeline (e.g. \"ASAP\", \"6 months\", \"within a year\")"
    },
    "nationality": {
      "type": "string",
      "description": "current nationality (country name)"
    },
    "residence_country": {
      "type": "string",
      "description": "current country of residence (if different from nationality)"
    },
    "marital_status": {
      "type": "string",
      "enum": [
        "Yes",
        "No"
      ],
      "description": "married? Yes/No"
    },
    "number_of_children": {
      "type": "number",
      "description": "how many children to include"
    },
    "childrens_ages": {
      "type": "string",
      "description": "children ages, comma-separated (e.g. 5, 12, 17)"
    },
    "family_size": {
      "type": "string",
      "description": "who is included (e.g. \"single\", \"couple\", \"family of 4\") — optional summary; prefer number_of_children + childrens_ages"
    },
    "message": {
      "type": "string",
      "description": "short comment / interest description"
    },
    "consent": {
      "type": "boolean",
      "description": "User consents to share details with Mirabello Consultancy (GDPR). Must be true to deliver."
    },
    "website": {
      "type": "string",
      "description": "leave blank (spam honeypot)"
    }
  },
  "required": [
    "email"
  ]
}

generate_briefing

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.

Parameters14

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

Raw schema

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

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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "webhook_url": {
      "type": "string",
      "description": "HTTPS endpoint to POST change entries to (for agents/systems)"
    },
    "email": {
      "type": "string",
      "description": "email for change alerts (requires consent:true)"
    },
    "programme_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "optional filter — only these programmes"
    },
    "consent": {
      "type": "boolean",
      "description": "required true when email is given (GDPR)"
    },
    "website": {
      "type": "string",
      "description": "leave blank (spam honeypot)"
    }
  }
}

check_eligibility

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "nationality": {
      "type": "string",
      "description": "applicant nationality (country name, e.g. \"Iran\", \"India\")"
    },
    "programme_id": {
      "type": "string",
      "description": "optional: check one programme in detail"
    },
    "type": {
      "type": "string",
      "enum": [
        "CBI",
        "RBI"
      ],
      "description": "optional filter"
    }
  },
  "required": [
    "nationality"
  ]
}

get_document_checklist

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.

Parameters1

programme_id

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "programme_id": {
      "type": "string",
      "description": "Programme id as returned by list_programmes (e.g. \"st-kitts-cbi\"). Not a country name and not a website slug.",
      "examples": [
        "st-kitts-cbi"
      ]
    }
  },
  "required": [
    "programme_id"
  ]
}

estimate_timeline

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

Parameters1

programme_id

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "programme_id": {
      "type": "string",
      "description": "Programme id as returned by list_programmes (e.g. \"st-kitts-cbi\"). Not a country name and not a website slug.",
      "examples": [
        "st-kitts-cbi"
      ]
    }
  },
  "required": [
    "programme_id"
  ]
}

get_country

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

Parameters3

cc	string	required	ISO alpha-2 country code
pathway	string	optional	optional: one pathway id to return
nationality	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code"
    },
    "pathway": {
      "type": "string",
      "description": "optional: one pathway id to return"
    },
    "nationality": {
      "type": "string",
      "description": "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."
    }
  },
  "required": [
    "cc"
  ]
}

get_provenance

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

Parameters2

cc	string	required	ISO alpha-2 country code
pathway	string	optional	optional: one pathway id

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code"
    },
    "pathway": {
      "type": "string",
      "description": "optional: one pathway id"
    }
  },
  "required": [
    "cc"
  ]
}

query_graph

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.

Parameters9

id	string	optional	entity id for neighbours mode (programme:<id> \| country:<CC> \| bloc:<NAME> \| authority:<slug> \| source:<host>)
type	string	optional	CBI or RBI
cc	string	optional	ISO 3166-1 alpha-2 country code, uppercase (e.g. "PT" Portugal, "AE" United Arab Emirates, "KN" St Kitts and Nevis).
status	string	optional	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	optional	Desired outcome: "citizenship" (a passport) or "residence" (a permit).
bloc	string	optional	Political/economic bloc filter (e.g. "EU", "Schengen", "CARICOM", "GCC").
max_investment_usd	number	optional	Upper bound on the headline minimum investment, in USD.
min_investment_usd	number	optional	Lower bound on the headline minimum investment, in USD.
limit	number	optional	Maximum number of items to return. Responses can be large; use this to keep the answer small.

Raw schema

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

plan_path

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.

Parameters7

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

Raw schema

{
  "type": "object",
  "properties": {
    "from_citizenship": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "current citizenship(s), ISO alpha-2 e.g. [\"US\"]"
    },
    "from_tax_residence": {
      "type": "string",
      "description": "ISO alpha-2 tax residence (defaults to first citizenship)"
    },
    "goal": {
      "type": "string",
      "enum": [
        "mobility",
        "plan_b",
        "tax",
        "business",
        "family",
        "education",
        "succession",
        "diversification",
        "unsure"
      ],
      "description": "What the applicant is optimising for, in plain words: visa-free travel, tax residence, family relocation.",
      "examples": [
        "visa-free travel"
      ]
    },
    "budget_usd": {
      "type": "number",
      "description": "Total budget the applicant has available for the investment itself, in USD (fees are additional).",
      "examples": [
        300000
      ]
    },
    "timeline_months": {
      "type": "number",
      "description": "Target time to the outcome, in MONTHS.",
      "examples": [
        9
      ]
    },
    "family": {
      "type": "object",
      "description": "Family composition object, e.g. { \"adults\": 2, \"children_under16\": 1, \"children_16plus\": 0 }."
    },
    "physical_presence_tolerance": {
      "type": "string",
      "enum": [
        "none",
        "low",
        "medium",
        "high"
      ],
      "description": "How much time the applicant can spend in-country: \"none\", \"minimal\", \"flexible\", \"relocating\".",
      "examples": [
        "minimal"
      ]
    }
  },
  "required": [
    "from_citizenship"
  ]
}

find_pathways

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "pathway": {
      "type": "string",
      "enum": [
        "eu-free-movement",
        "retirement-passive",
        "digital-nomad",
        "skilled-work",
        "general-work",
        "startup-entrepreneur",
        "talent-exceptional",
        "study",
        "family-reunification",
        "marriage",
        "ancestry-descent",
        "naturalisation-ordinary",
        "invest-residence",
        "invest-citizenship"
      ],
      "description": "Pathway id. eu-free-movement = living in another EU/EEA state or Switzerland as an EU/EEA/Swiss citizen."
    },
    "region": {
      "type": "string",
      "description": "Region filter, matched case-insensitively (e.g. \"Caribbean\", \"EU\", \"Middle East\", \"Pacific\", \"Africa\", \"Asia\").",
      "examples": [
        "Caribbean"
      ]
    }
  },
  "required": [
    "pathway"
  ]
}

find_retirement_routes

Find RETIREMENT and PASSIVE-INCOME residence routes (pensionado, rentista, retiree visas, financial-means residency) that qualify on income or savings, not an investment. Filter by monthly income in USD, income type (pension, passive or either), net worth, the most days a year you want to spend there, region, dependants, and whether foreign income must be untaxed. Each route returns its official requirement in its legal currency, whether you appear to qualify (indicative FX, flagged as such), the stay rule, how foreign income is taxed with a plain label (territorial, exempt, partial or worldwide: Mexico, Portugal, Colombia and Brazil tax the foreign pension of a tax resident), the path to permanent residence and citizenship, and the official source. Figures not yet verified are withheld (null), never estimated. Information, not advice.

Parameters7

monthly_income_usd	number	optional	Your regular monthly income in USD (pension and/or passive income). Optional; without it qualification by income is left open.
income_type	string	optional	What the income is: pension (state or private retirement pension), passive (rents, dividends, interest), or either/both. Default either.
net_worth_usd	number	optional	Liquid savings or investable net worth in USD, for routes that accept a deposit, savings balance or assets instead of income. Optional.
max_stay_days_per_year	number	optional	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	optional	true = only routes where foreign income is untaxed for a tax resident (exempt, territorial or remittance basis). Default false.
region	string	optional	Region filter, case-insensitive: e.g. "Latin America", "Caribbean", "Europe", "Asia", "Middle East", "Americas".
dependants	integer	optional	Number of dependants (spouse, children) to include; routes with a per-dependant income add-on raise the requirement accordingly. Default 0.

Raw schema

{
  "type": "object",
  "properties": {
    "monthly_income_usd": {
      "type": "number",
      "description": "Your regular monthly income in USD (pension and/or passive income). Optional; without it qualification by income is left open."
    },
    "income_type": {
      "type": "string",
      "enum": [
        "pension",
        "passive",
        "either"
      ],
      "description": "What the income is: pension (state or private retirement pension), passive (rents, dividends, interest), or either/both. Default either."
    },
    "net_worth_usd": {
      "type": "number",
      "description": "Liquid savings or investable net worth in USD, for routes that accept a deposit, savings balance or assets instead of income. Optional."
    },
    "max_stay_days_per_year": {
      "type": "number",
      "description": "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": {
      "type": "boolean",
      "description": "true = only routes where foreign income is untaxed for a tax resident (exempt, territorial or remittance basis). Default false."
    },
    "region": {
      "type": "string",
      "description": "Region filter, case-insensitive: e.g. \"Latin America\", \"Caribbean\", \"Europe\", \"Asia\", \"Middle East\", \"Americas\"."
    },
    "dependants": {
      "type": "integer",
      "description": "Number of dependants (spouse, children) to include; routes with a per-dependant income add-on raise the requirement accordingly. Default 0."
    }
  }
}

find_fastest_citizenship

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.

Parameters3

nationality	string	optional	ISO-3166 alpha-2 of the passport held, e.g. BR, AR, WS, NZ
cc	string	optional	ISO-3166 alpha-2 of the destination jurisdiction, e.g. ES, PT, NZ, AU
bloc	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "nationality": {
      "type": "string",
      "description": "ISO-3166 alpha-2 of the passport held, e.g. BR, AR, WS, NZ"
    },
    "cc": {
      "type": "string",
      "description": "ISO-3166 alpha-2 of the destination jurisdiction, e.g. ES, PT, NZ, AU"
    },
    "bloc": {
      "type": "string",
      "enum": [
        "EU",
        "EEA",
        "FREE_MOVEMENT"
      ],
      "description": "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."
    }
  }
}

get_emigration_flows

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "string",
      "description": "e.g. \"2025\"; defaults to the latest available"
    },
    "destination": {
      "type": "string",
      "description": "destination country name in German, e.g. \"Schweiz\", or a fragment"
    },
    "top": {
      "type": "number",
      "description": "limit the destination list (default 25)"
    }
  }
}

get_capital_controls

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 origin country code (e.g. IN, CN, ZA)"
    },
    "regime": {
      "type": "string",
      "enum": [
        "free",
        "liberalising",
        "controlled"
      ],
      "description": "optional filter"
    }
  }
}

check_visa_requirement

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "from_nationality": {
      "type": "string",
      "description": "passport held - ISO alpha-2 code or country name, e.g. NG, IN, \"Nigeria\""
    },
    "destination": {
      "type": "string",
      "description": "destination - ISO alpha-2 code or country name, e.g. TR, \"Turkey\", \"Schengen\" (checked via Germany)"
    }
  },
  "required": [
    "from_nationality",
    "destination"
  ]
}

list_visa_free_destinations

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "from_nationality": {
      "type": "string",
      "description": "passport held - ISO alpha-2 code or country name"
    },
    "group": {
      "type": "string",
      "enum": [
        "visa_free",
        "visa_on_arrival",
        "e_visa",
        "eta",
        "visa_required",
        "no_admission"
      ],
      "description": "optional: return only this group"
    }
  },
  "required": [
    "from_nationality"
  ]
}

get_name_change

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.

Parameters1

string

optional

ISO alpha-2 country code, e.g. GB, AE, CH

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code, e.g. GB, AE, CH"
    }
  }
}

get_foundation_rules

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.

Parameters1

string

optional

ISO alpha-2 country code, e.g. LI, CH, AE

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code, e.g. LI, CH, AE"
    }
  }
}

get_nonresident_banking

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.

Parameters1

string

optional

ISO alpha-2 country code, e.g. AE, CH, SG

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code, e.g. AE, CH, SG"
    }
  }
}

get_property_law

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.

Parameters1

string

optional

ISO alpha-2 country code, e.g. CH, AE, PT

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code, e.g. CH, AE, PT"
    }
  }
}

get_entry_requirements

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.

Parameters1

string

optional

ISO alpha-2 destination country code

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 destination country code"
    }
  }
}

get_country_tax

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.

Parameters1

string

required

ISO alpha-2 country code

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 country code"
    }
  },
  "required": [
    "cc"
  ]
}

find_low_tax

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.

Parameters8

no_income_tax	boolean	optional	True to require no personal income tax.
no_inheritance_tax	boolean	optional	True to require no inheritance or estate tax.
no_wealth_tax	boolean	optional	True to require no net-wealth tax.
no_capital_gains_tax	boolean	optional	True to require no capital-gains tax.
territorial	boolean	optional	True to require a territorial tax system (foreign income untaxed).
non_crs	boolean	optional	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.
not_eu_listed	boolean	optional	True to exclude jurisdictions on the EU list of non-cooperative tax jurisdictions.
crypto_friendly	boolean	optional	True to require a favourable published treatment of digital assets.

Raw schema

{
  "type": "object",
  "properties": {
    "no_income_tax": {
      "type": "boolean",
      "description": "True to require no personal income tax."
    },
    "no_inheritance_tax": {
      "type": "boolean",
      "description": "True to require no inheritance or estate tax."
    },
    "no_wealth_tax": {
      "type": "boolean",
      "description": "True to require no net-wealth tax."
    },
    "no_capital_gains_tax": {
      "type": "boolean",
      "description": "True to require no capital-gains tax."
    },
    "territorial": {
      "type": "boolean",
      "description": "True to require a territorial tax system (foreign income untaxed)."
    },
    "non_crs": {
      "type": "boolean",
      "description": "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."
    },
    "not_eu_listed": {
      "type": "boolean",
      "description": "True to exclude jurisdictions on the EU list of non-cooperative tax jurisdictions."
    },
    "crypto_friendly": {
      "type": "boolean",
      "description": "True to require a favourable published treatment of digital assets."
    }
  }
}

find_trust_jurisdictions

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "vehicle": {
      "type": "string",
      "description": "trust or foundation"
    },
    "strong_protection": {
      "type": "boolean",
      "description": "True to require strong asset-protection legislation."
    }
  }
}

find_charity_jurisdictions

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "vehicle": {
      "type": "string",
      "description": "e.g. foundation, donor-advised fund, charitable trust, waqf"
    },
    "donor_relief": {
      "type": "boolean",
      "description": "only jurisdictions giving donors a tax deduction/credit"
    }
  }
}

get_structuring_roster

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.

Parameters1

lane

string

optional

corporate | trust | personal | watchlist (omit for full roster)

Raw schema

{
  "type": "object",
  "properties": {
    "lane": {
      "type": "string",
      "description": "corporate | trust | personal | watchlist (omit for full roster)"
    }
  }
}

get_structuring_playbook

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "us | eu | ch | asia | mea"
    },
    "archetype": {
      "type": "string",
      "description": "solo-lean | scaleup | enterprise"
    },
    "holding": {
      "type": "boolean",
      "description": "include holding-layer detail"
    }
  }
}

get_company_formation

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.

Parameters1

structure

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "structure": {
      "type": "string",
      "description": "profile key, e.g. us-llc-wy, ae-freezone, sg-pte (omit for the catalogue)"
    }
  }
}

find_formation_jurisdictions

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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "remote_only": {
      "type": "boolean",
      "description": "True to return only options that can be completed without travelling to the country."
    },
    "max_setup_usd": {
      "type": "number",
      "description": "Maximum acceptable set-up cost in USD.",
      "examples": [
        25000
      ]
    },
    "banking_tier": {
      "type": "string",
      "description": "good | moderate (minimum acceptable)"
    },
    "eu_clean": {
      "type": "boolean",
      "description": "True to require the jurisdiction be absent from EU tax and AML listings."
    },
    "lane": {
      "type": "string",
      "description": "company | trust"
    }
  }
}

compare_formation

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.

Parameters1

structures

array

required

2-6 profile keys

Raw schema

{
  "type": "object",
  "properties": {
    "structures": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2-6 profile keys"
    }
  },
  "required": [
    "structures"
  ]
}

plan_global_setup

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.

Parameters6

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

Raw schema

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

get_banking_access

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 (US, AE, SG, HK, CH, LI, KY) or EMI for the e-money layer"
    },
    "type": {
      "type": "string",
      "description": "corporate | personal (omit for both)"
    }
  }
}

get_regulator_registry

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO alpha-2 (or roster key like MY-LABUAN, KZ-AIFC)"
    },
    "international": {
      "type": "boolean",
      "description": "True to include international/offshore structures rather than domestic-only options."
    }
  }
}

compare_treaty_position

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start of the date range, ISO date (YYYY-MM-DD).",
      "examples": [
        "2026-01-01"
      ]
    },
    "to": {
      "type": "string",
      "description": "End of the date range, ISO date (YYYY-MM-DD).",
      "examples": [
        "2026-12-31"
      ]
    }
  },
  "required": [
    "from",
    "to"
  ]
}

withholding_map

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start of the date range, ISO date (YYYY-MM-DD).",
      "examples": [
        "2026-01-01"
      ]
    },
    "to": {
      "type": "string",
      "description": "End of the date range, ISO date (YYYY-MM-DD).",
      "examples": [
        "2026-12-31"
      ]
    }
  },
  "required": [
    "from",
    "to"
  ]
}

flag_cfc_poe_risk

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  },
  "required": [
    "cc"
  ]
}

residence_evidence_checklist

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  },
  "required": [
    "cc"
  ]
}

build_sow_pack

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Country the applicant is relocating FROM, as a country name.",
      "examples": [
        "South Africa"
      ]
    },
    "context": {
      "type": "string",
      "description": "Free-text background about the applicant's situation, used to tailor the answer."
    }
  }
}

forced_heirship_risk

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  },
  "required": [
    "cc"
  ]
}

matrimonial_regime_screen

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  },
  "required": [
    "cc"
  ]
}

succession_conflict_map

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.

Parameters1

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  },
  "required": [
    "cc"
  ]
}

choice_of_law_options

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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "nationalities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO alpha-2 codes of nationalities held."
    },
    "habitual_residence": {
      "type": "string",
      "description": "ISO alpha-2 of current habitual residence."
    },
    "asset_situs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO alpha-2 codes where assets are situated."
    },
    "married": {
      "type": "boolean",
      "description": "Whether the applicant is married — affects family pricing and some eligibility rules."
    },
    "spouse_nationalities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of the spouse's citizenships as country names.",
      "examples": [
        [
          "Brazil"
        ]
      ]
    }
  }
}

compare_scenarios

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "scenarios": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cc": {
            "type": "string"
          },
          "pathway": {
            "type": "string"
          }
        }
      },
      "description": "Array of scenario objects to compare side by side, each naming a programme id and the family composition and options to price."
    },
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  }
}

compliance_checklist

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.

Parameters10

us_person	boolean	optional	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.
crs_reportable	boolean	optional	True if the client holds financial accounts reportable under the CRS automatic-exchange regime.
crypto_holder	boolean	optional	True if the client holds digital assets — relevant to CARF and local crypto reporting.
dac6	boolean	optional	True if a reportable cross-border arrangement under EU DAC6 may be involved.
eu_cross_border_arrangement	boolean	optional	True if the structure spans two or more EU member states.
pep	boolean	optional	True if the client is a politically exposed person, a family member or a known close associate — requires enhanced due diligence.
cbi_applicant	boolean	optional	True if the client is applying for citizenship by investment.
rbi_applicant	boolean	optional	True if the client is applying for residence by investment.
trust_settlor	boolean	optional	True if the client settles or controls a trust or foundation.
large_cash_or_sow	boolean	optional	True if large cash movements or a complex source-of-wealth story are involved.

Raw schema

{
  "type": "object",
  "properties": {
    "us_person": {
      "type": "boolean",
      "description": "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."
    },
    "crs_reportable": {
      "type": "boolean",
      "description": "True if the client holds financial accounts reportable under the CRS automatic-exchange regime."
    },
    "crypto_holder": {
      "type": "boolean",
      "description": "True if the client holds digital assets — relevant to CARF and local crypto reporting."
    },
    "dac6": {
      "type": "boolean",
      "description": "True if a reportable cross-border arrangement under EU DAC6 may be involved."
    },
    "eu_cross_border_arrangement": {
      "type": "boolean",
      "description": "True if the structure spans two or more EU member states."
    },
    "pep": {
      "type": "boolean",
      "description": "True if the client is a politically exposed person, a family member or a known close associate — requires enhanced due diligence."
    },
    "cbi_applicant": {
      "type": "boolean",
      "description": "True if the client is applying for citizenship by investment."
    },
    "rbi_applicant": {
      "type": "boolean",
      "description": "True if the client is applying for residence by investment."
    },
    "trust_settlor": {
      "type": "boolean",
      "description": "True if the client settles or controls a trust or foundation."
    },
    "large_cash_or_sow": {
      "type": "boolean",
      "description": "True if large cash movements or a complex source-of-wealth story are involved."
    }
  }
}

get_mobility_optionality

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.

Parameters1

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  }
}

get_digital_gov_progress

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.

Parameters1

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  }
}

get_wealth_atlas

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.

Parameters1

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "cc": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase (e.g. \"PT\" Portugal, \"AE\" United Arab Emirates, \"KN\" St Kitts and Nevis).",
      "examples": [
        "PT",
        "AE"
      ]
    }
  }
}

get_wealth_index

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.

Parameters3

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

Raw schema

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

search_properties

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 is broker of record on every listing — there is no direct developer contact; all buyer enquiries are routed through Mirabello. Indicative figures; book a consultation to confirm.

Parameters8

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

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name to filter listings by (e.g. \"Greece\", \"Portugal\").",
      "examples": [
        "Greece"
      ]
    },
    "programme": {
      "type": "string",
      "description": "Programme id whose investment rules the property must satisfy (e.g. \"greece-gv\").",
      "examples": [
        "greece-gv"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "CBI",
        "RBI"
      ],
      "description": "Programme family: \"CBI\" grants citizenship, \"RBI\" grants residence (golden visa). Omit for both.",
      "examples": [
        "CBI"
      ]
    },
    "budget_max": {
      "type": "number",
      "description": "max price in USD (best-effort FX)"
    },
    "beds_min": {
      "type": "number",
      "description": "Minimum number of bedrooms.",
      "examples": [
        2
      ]
    },
    "listing_type": {
      "type": "string",
      "description": "Listing category, for example apartment, villa, townhouse, land or commercial.",
      "examples": [
        "apartment"
      ]
    },
    "sale_status": {
      "type": "string",
      "enum": [
        "available",
        "off-plan",
        "under-construction",
        "reserved",
        "sold"
      ],
      "description": "Availability filter, for example available, reserved or sold.",
      "examples": [
        "available"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of items to return. Responses can be large; use this to keep the answer small.",
      "examples": [
        10
      ]
    }
  }
}

get_property

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

Parameters1

slug

string

required

Listing slug exactly as returned by search_properties.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Listing slug exactly as returned by search_properties."
    }
  },
  "required": [
    "slug"
  ]
}

get_availability_updates

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

Parameters1

since

string

optional

ISO date, e.g. 2026-06-01

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "ISO date, e.g. 2026-06-01"
    }
  }
}

create_enquiry

Route a qualified buyer enquiry about a specific property to Mirabello Consultancy (the broker of record and licensed advisor). 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.

Parameters11

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

Raw schema

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

README.md10 KBView on GitHub

Mirabello Immigration Intelligence: MCP Server

The first Model Context Protocol (MCP) server for citizenship- and residency-by-investment, grown into a global relocation, tax-residency and wealth-protection data layer. Maintained by Mirabello Consultancy, a Swiss boutique investment-migration advisory (Zurich, Dubai, Hong Kong SAR; IMC member, ACAMS certified).

63 tools · 98 investment-migration programmes · 194 countries · 1,229 verified immigration pathways · 199 × 199 visa matrix · 14 statute-read naturalisation regimes

Every figure is sourced: official government sources first, corroborated where possible, with verification dates and confidence returned alongside the data. Where a fact cannot be verified, the server says so instead of guessing.

Connect (remote, no install)

Streamable HTTP, stateless JSON-RPC 2.0, no API key:

code

https://mcp.mirabelloconsultancy.com/

MCP client config:

json

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

Also listed on the official MCP Registry, Glama, PulseMCP, mcp.so and Smithery.

In Grok

Grok supports custom MCP connectors for every user: go to grok.com/connectors, click New Connector, choose Custom and paste https://mcp.mirabelloconsultancy.com/. Grok Business and Enterprise admins add it once under console.x.ai, Grok Business, Connectors. For Grok Build, this repo is also a plugin (.mcp.json + .grok-plugin/plugin.json).

In Claude and ChatGPT

Claude: Settings, Connectors, Add custom connector, paste the address above. ChatGPT: Mirabello Immigration Intelligence in the GPT Store.

What you can ask

"I am a Nigerian entrepreneur with USD 300,000. Which second citizenship fits my family of four, and what does it cost?"
"Which countries offer a digital nomad visa, and what income do they require?"
"What is the fastest way for a Brazilian to reach an EU passport?"
"I am German and want to retire in Portugal. Do I need a visa?"
"Where can a Pakistani passport travel visa-free?"
"Compare the tax position of moving from Germany to the UAE versus Switzerland."

Tools (63)

59 tools are read-only. 4 act on the user's behalf (book_consultation, generate_briefing, subscribe_changes, create_enquiry), and only with explicit consent.

Investment migration: CBI / RBI programmes (14)

Tool	Purpose
`list_programmes`	List citizenship- and residency-by-investment programmes with every investment route and its minimum; filter by type, budget, region, processing time
`get_programme`	Full record for one programme: routes, fees, family rules, processing, mobility, tax, Index score, sources
`compare_programmes`	Side-by-side comparison of 2 to 4 programmes
`get_processing_times`	Processing time for one programme or all
`estimate_total_cost`	Itemised total for a given family: investment, government and due-diligence fees
`recommend_programmes`	Ranked shortlist for a client profile (budget, family, timeline, mobility, tax goal)
`check_visa_free`	Passport mobility of a programme: visa-free count and key destinations
`get_index`	The Mirabello Investment Migration Index, a composite 0 to 100 ranking
`get_recent_changes`	Recent programme changes with field-level diffs and official sources
`check_eligibility`	Which programmes a nationality can realistically apply to
`get_document_checklist`	Standard document checklist for an application
`estimate_timeline`	Stage-by-stage expected timeline
`get_passport_renewal`	Passport-renewal rules for CBI countries
`get_about`	Mirabello track record, credentials, offices, languages

Countries, pathways and naturalisation (6)

Tool	Purpose
`get_country`	Every verified pathway for a country: skilled work, digital nomad, retirement, study, family, descent, investment, EU free movement; pass `nationality` to tailor it
`find_pathways`	Which countries offer a given pathway, with income thresholds and requirements
`find_fastest_citizenship`	Naturalisation periods and nationality-based fast tracks read from the enacted statute; one call ranks a whole bloc (e.g. `bloc: "EU"`)
`plan_path`	The Mirabello Freedom Compass: origin-aware planner from a person's current citizenship and goal to ranked routes
`get_provenance`	Citation-first provenance for a country's facts: source, tier, verification date, confidence
`query_graph`	Relational query over the programme, country, bloc and authority knowledge graph

Travel and entry (3)

Tool	Purpose
`check_visa_requirement`	Visa requirement for one nationality to one destination, with maximum stay
`list_visa_free_destinations`	Every destination for one passport, grouped: visa-free, on arrival, e-visa, electronic authorisation, visa required
`get_entry_requirements`	Passport-validity and entry rules of a destination

Relocation practicalities (6)

Tool	Purpose
`get_capital_controls`	Whether, and how much, money may legally leave a country
`get_nonresident_banking`	Bank-account access for non-resident individuals and companies
`get_property_law`	Real-estate rules for foreign buyers
`get_name_change`	Legal name-change rules
`get_foundation_rules`	Charitable and private foundation and trust rules
`get_emigration_flows`	Official emigration statistics by destination (German Destatis data)

Tax and wealth protection (19)

Tool	Purpose
`get_country_tax`	HNWI tax profile: income, capital gains, inheritance, wealth tax, CRS, special regimes
`find_low_tax`	Countries by tax criteria (no income, inheritance or wealth tax, territorial, crypto treatment)
`compare_treaty_position`	Double-tax-treaty position for a relocation corridor
`withholding_map`	Treaty withholding rates for dividends, interest and royalties
`residence_evidence_checklist`	Tax-residence tests and the evidence that proves them
`flag_cfc_poe_risk`	CFC, GAAR, place-of-effective-management and exit-tax flags
`compliance_checklist`	Reporting obligations (FATCA, CRS, CARF/DAC8, DAC6, PEP) for a stated profile
`build_sow_pack`	Source-of-wealth and source-of-funds evidence pack by wealth origin
`find_trust_jurisdictions`	Trust and foundation jurisdictions by asset-protection strength
`find_charity_jurisdictions`	Jurisdictions for philanthropic structures
`forced_heirship_risk`	Forced-heirship and reserved-share position
`matrimonial_regime_screen`	Default matrimonial-property regime
`succession_conflict_map`	Cross-border succession conflict of laws
`choice_of_law_options`	Which law may govern succession, matrimonial property and divorce
`compare_scenarios`	2 to 8 jurisdictions across every wealth-protection dimension at once
`get_mobility_optionality`	The lawful residence and citizenship routes a jurisdiction offers
`get_digital_gov_progress`	CBDC, stablecoin and digital-ID status
`get_wealth_atlas`	Mirabello Wealth-Protection Atlas: per-pillar sub-indices (0 to 100)
`get_wealth_index`	Client-weighted composite over the Atlas pillars

Global structuring (8)

Tool	Purpose
`plan_global_setup`	One origin-aware answer combining residence, company, banking and tax
`get_structuring_roster`	Curated company-formation jurisdictions from a full country screen
`get_structuring_playbook`	Recommended setups by customer market
`get_company_formation`	Full formation profile for one structure
`find_formation_jurisdictions`	Filter formation profiles by constraints
`compare_formation`	Compare 2 to 6 formation structures
`get_banking_access`	Non-resident banking landscape per jurisdiction
`get_regulator_registry`	Regulators for tax, companies, accounting, treaties and banking

Real estate (4)

Tool	Purpose
`search_properties`	Investment property that qualifies for a CBI or RBI programme
`get_property`	Full detail for one listing
`get_availability_updates`	Recently re-verified listings
`create_enquiry`	Route a buyer enquiry to Mirabello (requires consent)

Consultation (3)

Tool	Purpose
`book_consultation`	Book a free consultation (requires email and explicit consent)
`generate_briefing`	Personalised shortlist with a private 90-day briefing page
`subscribe_changes`	Verified programme-change alerts

Prompts and resources

Prompts: investment_migration_advisor, shortlist_for_client, verify_a_figure, explain_a_refusal
Resources: mirabello://programmes/all, mirabello://programmes/{id}, mirabello://index, mirabello://track-record, ui://mirabello/freedom-compass.html

REST mirror (for non-MCP clients)

A read-only HTTP mirror under /v1, documented by OpenAPI (copy in this repo: openapi.json):

OpenAPI: https://mcp.mirabelloconsultancy.com/v1/openapi.json
Developer docs: https://mcp.mirabelloconsultancy.com/developers
Discovery: /.well-known/mcp.json, /server.json, /llms.txt

Data standards

Official government sources first; corroboration where possible; figures that cannot be verified are withheld or flagged, never estimated.
Every record carries its source, verification date and confidence; get_provenance exposes them.
Closed, paused and announced-but-not-in-force programmes stay listed and are clearly marked, so agents get the correct answer instead of an outdated one.
The server never helps conceal assets or income from tax authorities; CRS and FATCA reporting applies.

If this server is useful to you, a GitHub star helps other developers find it.

Disclaimer

Figures are indicative and subject to change. This server provides general information only and is not legal, financial, tax or immigration advice, nor an offer or solicitation. Programmes are operated and governed solely by the respective governments. © Mirabello Consultancy Ltd. Terms: https://www.mirabelloconsultancy.com/ai

Install

Tools (64)

list_programmesget_programmecompare_programmesget_processing_timesestimate_total_costrecommend_programmescheck_visa_freeget_index

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.mirabelloconsultancy.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mirabelloconsultancy.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.