GoodbyeMatrix Residency & Citizenship Index

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

Residency programmes, golden visas, second passports and citizenship by investment in 80+ countries

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "GoodbyeMatrix Residency & Citizenship Index": {
      "url": "https://ai.goodbyematrix.com/cbi/api/agent/v1/residency-index/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• search_programs read-only

  Searches the public programmes of the GoodbyeMatrix index: more than 170 residency programmes in more than 80 countries (golden visa or residence by investment, digital nomad visa, independent means visa, active investor visa, skilled worker visa) and 20 citizenship by investment (second passport) programmes. Filters: country, region, programme type, maximum budget in USD, path to citizenship and dual citizenship. Returns a page of matching programmes (total, offset, limit, nextOffset) with id, name, country, type, minimum amount, physical presence, path to citizenship, dual citizenship and the programme page in German and English. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • type — string — Programme type: citizenship_by_investment, residence_by_investment (golden visa), digital_nomad, independent_means (retirees, passive income), active_investor (investor and entrepreneur visas) or skilled_work (skilled worker and talent visas).
  • limit — integer — Number of programmes per page (1 to 10, default 10).
  • offset — integer — Start position for the next page (nextOffset of the previous answer).
  • region — string — Region: europe, americas (including the Caribbean), asia, africa, middle_east or oceania.
  • country — string — Country as ISO 3166-1 alpha-2 code (for example "PT") or name in English or German.
  • language — string — Response language: "en" (English, default) or "de" (German).
  • max_budget_usd — number — Maximum minimum investment in USD; programmes without a known amount are not matched.
  • citizenship_path — boolean — true: programmes with a path to citizenship; false: programmes without one.
  • dual_citizenship_allowed — boolean — true: dual citizenship permitted; false: dual citizenship prohibited. Conditional cases match neither.

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

• get_program read-only

  Returns one programme of the index in detail. Residency programmes: minimum amount and investment options, physical presence, time to permanent residency and to citizenship, dual citizenship, settlement area, tax system of the country, steps and excerpts of the GoodbyeMatrix programme texts (overview, qualification, costs, benefits, citizenship timeline, legal basis). Citizenship by investment programmes: routes with starting amounts, visa-free destinations, status (cost calculator, on request, coming soon or closed) and official links. Includes the programme page in German and English, the date of the source and consultationNote. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • id (required) — string — Programme id from search_programs or get_country_overview, or a programme name (word order and country codes are tolerated).
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• compare_programs read-only

  Sets 2 to 5 programmes of the index side by side: type, country, minimum amount, physical presence, time to permanent residency and to citizenship, path to citizenship, dual citizenship, tax system of the country, visa-free destinations and the programme page in German and English, plus the date of the source and consultationNote. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • ids (required) — array — 2 to 5 programme ids (as returned by search_programs).
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• get_country_overview read-only

  Summarises a country for moving abroad: tax system (residence-based, territorial, no income tax, remittance basis or citizenship-based), the residency and citizenship by investment programmes of the index in that country with their programme pages, and the GoodbyeMatrix climate map, plus the date of the source and consultationNote. Covers about 200 countries. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • country (required) — string — Country as ISO 3166-1 alpha-2 code (for example "PA") or name in English or German.
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• explain_term read-only

  Explains a term on relocation, residency, citizenship, tax and asset protection from the GoodbyeMatrix glossary (more than 120 terms, for example golden visa, 183-day rule, tax residency certificate, flag theory) with the glossary page in German and English. The definition is returned in the requested language (English or German); a term without an English entry yet comes with the German definition and a note. Related terms are listed when the search term matches several entries. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • term (required) — string — Term in English or German, for example "183-day rule" or "Wegzugsbesteuerung".
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• get_cbi_quote read-only

  Answers how much citizenship by investment or a second passport costs for a person or family, or compares programmes by total cost. Calculates the indicative cost for a family: government contribution, investment, fees, professional fees, payment phases and total in USD, plus which family members are eligible, processing time, page links and quoteRequestUrl. With one programme it returns that programme; without program it compares all 9 programmes (St Kitts and Nevis, Antigua and Barbuda, Dominica, Grenada, Saint Lucia, Vanuatu, Sao Tome and Principe, Nauru, Argentina). Nationality and country of birth count for every person in the family, not only for the main applicant. Figures are calculated live at request time from the current GoodbyeMatrix price and rule data; the data status is the date of the response (updatedAt), not an older date. Figures are rounded indicative figures (total to the nearest 1,000 USD), binding only after a pre-check; the user receives the exact amounts by requesting the cost breakdown through quoteRequestUrl. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • family (required) — array — Everyone who applies together. The first person is the main applicant (role "main"); only the first person has the role "main". Defaults: a partner counts as married and not same-sex unless stated; a child under 18 counts as dependent. Nationalities and country of birth are relevant for every person in the list (partner, children, parents), not only for the main applicant, because exclusions apply per person.
  • program — string — Programme key: sao_tome (Sao Tome and Principe), vanuatu, dominica, st_lucia (Saint Lucia), st_kitts (St. Kitts and Nevis), grenada, antigua (Antigua and Barbuda), nauru, argentina. Without a programme, the figures cover all programmes at once.
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• list_cbi_programs read-only

  For questions about which citizenship by investment (second passport) programmes exist or what they start from: lists the 9 programmes GoodbyeMatrix prices (St Kitts and Nevis, Antigua and Barbuda, Dominica, Grenada, Saint Lucia, Vanuatu, Sao Tome and Principe, Nauru, Argentina) with region, route (contribution, investment or both), starting amount in USD for a single applicant, professional fee label, processing time, number of visa-free destinations where known, calculator and programme page links, and short notes. Read-only: it only retrieves and computes from the GoodbyeMatrix data set, stores nothing, sends nothing and calls no external services.

  Parameters:

  • language — string — Response language: "en" (English, default) or "de" (German).

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

• request_cost_breakdown_link read-only

  Returns only the personal link (quoteRequestUrl) for one programme and family: the calculator page on goodbyematrix.com with the family already filled in, where the user requests the detailed cost breakdown with the exact amounts by e-mail from the GoodbyeMatrix team. The link carries the family only, never contact details; the user enters their contact details on that page, checks them and sends the request personally; the privacy consent is never preselected. Read-only: it returns a URL only; nothing is sent, booked or stored.

  Parameters:

  • program (required) — string — Programme key: sao_tome (Sao Tome and Principe), vanuatu, dominica, st_lucia (Saint Lucia), st_kitts (St. Kitts and Nevis), grenada, antigua (Antigua and Barbuda), nauru, argentina.
  • family (required) — array — Everyone who applies together. The first person is the main applicant (role "main"); only the first person has the role "main". Defaults: a partner counts as married and not same-sex unless stated; a child under 18 counts as dependent. Nationalities and country of birth are relevant for every person in the list (partner, children, parents), not only for the main applicant, because exclusions apply per person.
  • language — string — Response language: "en" (English, default) or "de" (German).

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

• request_consultation_link read-only

  Use only when the user explicitly asks to speak with GoodbyeMatrix. Returns the URL of the GoodbyeMatrix consultation page (German or English) and the topics a call covers. The link carries no personal data. Read-only: it returns a URL only; nothing is sent, booked or stored.

  Parameters:

  • language — string — Response language: "en" (English, default) or "de" (German).

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

Publisher website

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