GoodbyeMatrix Residency & Citizenship Index
Residency programmes, golden visas, second passports and citizenship by investment in 80+ countries
使うべきか
品質と安全性
A
検出事項（1）
- MEDIUMTool 'get_program' description contains placeholder textget_program 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~8,047トークン数（ツール定義）
~9.5 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 6.29%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"residency-index": {
"url": "https://ai.goodbyematrix.com/cbi/api/agent/v1/residency-index/mcp"
}
}
}リモートエンドポイント
https://ai.goodbyematrix.com/cbi/api/agent/v1/residency-index/mcpstreamable-httpできること
ツール一覧
ツール（9）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢search_programs(country, region, type, max_budget_usd, citizenship_path, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"type": "string",
"maxLength": 80,
"description": "Country as ISO 3166-1 alpha-2 code (for example \"PT\") or name in English or German."
},
"region": {
"type": "string",
"enum": [
"europe",
"americas",
"asia",
"africa",
"middle_east",
"oceania"
],
"description": "Region: europe, americas (including the Caribbean), asia, africa, middle_east or oceania."
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"description": "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)."
},
"max_budget_usd": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Maximum minimum investment in USD; programmes without a known amount are not matched."
},
"citizenship_path": {
"type": "boolean",
"description": "true: programmes with a path to citizenship; false: programmes without one."
},
"dual_citizenship_allowed": {
"type": "boolean",
"description": "true: dual citizenship permitted; false: dual citizenship prohibited. Conditional cases match neither."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 10,
"description": "Number of programmes per page (1 to 10, default 10)."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Start position for the next page (nextOffset of the previous answer)."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"nextOffset": {
"type": [
"integer",
"null"
]
},
"filters": {
"type": "object"
},
"programs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Programme id for get_program and compare_programs."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
]
},
"typeLabel": {
"type": "string"
},
"country": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"region": {
"type": [
"string",
"null"
]
},
"minimumAmount": {
"type": [
"string",
"null"
],
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD."
},
"incomeRequirement": {
"type": "string",
"description": "Residency only, where published: minimum income as on the programme page."
},
"minInvestmentUsd": {
"type": [
"number",
"null"
],
"description": "Minimum investment in USD where known (0 when no investment is required)."
},
"presence": {
"type": [
"string",
"null"
],
"description": "Physical presence requirement."
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"dualCitizenship": {
"type": [
"string",
"null"
],
"description": "permitted, conditional or prohibited."
},
"availability": {
"type": "string",
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed."
},
"stand": {
"type": [
"string",
"null"
]
},
"pages": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"ok",
"language",
"total",
"programs",
"stand",
"notice"
]
}🟢get_program(id, language)
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.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Programme id from search_programs or get_country_overview, or a programme name (word order and country codes are tolerated)."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"required": [
"id"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"program": {
"type": [
"object",
"null"
],
"description": "The programme; null when the name matches several programmes (see candidates).",
"properties": {
"id": {
"type": "string",
"description": "Programme id for get_program and compare_programs."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
]
},
"typeLabel": {
"type": "string"
},
"country": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"region": {
"type": [
"string",
"null"
]
},
"minimumAmount": {
"type": [
"string",
"null"
],
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD."
},
"incomeRequirement": {
"type": "string",
"description": "Residency only, where published: minimum income as on the programme page."
},
"minInvestmentUsd": {
"type": [
"number",
"null"
],
"description": "Minimum investment in USD where known (0 when no investment is required)."
},
"presence": {
"type": [
"string",
"null"
],
"description": "Physical presence requirement."
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"dualCitizenship": {
"type": [
"string",
"null"
],
"description": "permitted, conditional or prohibited."
},
"availability": {
"type": "string",
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed."
},
"stand": {
"type": [
"string",
"null"
]
},
"pages": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"yearsToCitizenship": {
"type": [
"number",
"null"
],
"description": "Shortest published number of years to citizenship."
},
"yearsToCitizenshipText": {
"type": "string",
"description": "Published wording when the years to citizenship depend on nationality or other conditions."
},
"texts": {
"type": "object"
},
"officialLinks": {
"type": "array"
}
}
},
"candidates": {
"type": "array",
"description": "Only when the name matches several programmes: up to 5 matching programmes with their ids.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
},
"typeLabel": {
"type": "string"
}
}
}
},
"cbiQuoteNote": {
"type": "string",
"description": "Only for the 9 programmes with a cost calculator: get_cbi_quote calculates the costs for a specific family."
},
"consultationNote": {
"type": "string"
}
},
"required": [
"ok",
"language",
"program",
"stand",
"notice",
"consultationNote"
]
}🟢compare_programs(ids, language)
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.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"minItems": 2,
"maxItems": 5,
"items": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Programme id from search_programs or get_country_overview, or a programme name (word order and country codes are tolerated)."
},
"description": "2 to 5 programme ids (as returned by search_programs)."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"required": [
"ids"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"programs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Programme id for get_program and compare_programs."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
]
},
"typeLabel": {
"type": "string"
},
"country": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"region": {
"type": [
"string",
"null"
]
},
"minimumAmount": {
"type": [
"string",
"null"
],
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD."
},
"incomeRequirement": {
"type": "string",
"description": "Residency only, where published: minimum income as on the programme page."
},
"minInvestmentUsd": {
"type": [
"number",
"null"
],
"description": "Minimum investment in USD where known (0 when no investment is required)."
},
"presence": {
"type": [
"string",
"null"
],
"description": "Physical presence requirement."
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"dualCitizenship": {
"type": [
"string",
"null"
],
"description": "permitted, conditional or prohibited."
},
"availability": {
"type": "string",
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed."
},
"stand": {
"type": [
"string",
"null"
]
},
"pages": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"yearsToCitizenship": {
"type": [
"number",
"null"
]
},
"yearsToCitizenshipText": {
"type": "string",
"description": "Published wording when the years to citizenship depend on nationality or other conditions."
}
}
}
},
"consultationNote": {
"type": "string"
}
},
"required": [
"ok",
"language",
"programs",
"stand",
"notice",
"consultationNote"
]
}🟢get_country_overview(country, language)
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.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Country as ISO 3166-1 alpha-2 code (for example \"PA\") or name in English or German."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"required": [
"country"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"country": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"taxSystem": {
"type": [
"object",
"null"
],
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
}
},
"residencyPrograms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Programme id for get_program and compare_programs."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
]
},
"typeLabel": {
"type": "string"
},
"country": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"region": {
"type": [
"string",
"null"
]
},
"minimumAmount": {
"type": [
"string",
"null"
],
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD."
},
"incomeRequirement": {
"type": "string",
"description": "Residency only, where published: minimum income as on the programme page."
},
"minInvestmentUsd": {
"type": [
"number",
"null"
],
"description": "Minimum investment in USD where known (0 when no investment is required)."
},
"presence": {
"type": [
"string",
"null"
],
"description": "Physical presence requirement."
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"dualCitizenship": {
"type": [
"string",
"null"
],
"description": "permitted, conditional or prohibited."
},
"availability": {
"type": "string",
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed."
},
"stand": {
"type": [
"string",
"null"
]
},
"pages": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
}
},
"cbiPrograms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Programme id for get_program and compare_programs."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
]
},
"typeLabel": {
"type": "string"
},
"country": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"region": {
"type": [
"string",
"null"
]
},
"minimumAmount": {
"type": [
"string",
"null"
],
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD."
},
"incomeRequirement": {
"type": "string",
"description": "Residency only, where published: minimum income as on the programme page."
},
"minInvestmentUsd": {
"type": [
"number",
"null"
],
"description": "Minimum investment in USD where known (0 when no investment is required)."
},
"presence": {
"type": [
"string",
"null"
],
"description": "Physical presence requirement."
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"dualCitizenship": {
"type": [
"string",
"null"
],
"description": "permitted, conditional or prohibited."
},
"availability": {
"type": "string",
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed."
},
"stand": {
"type": [
"string",
"null"
]
},
"pages": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
}
},
"climateMap": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"consultationNote": {
"type": "string"
}
},
"required": [
"ok",
"language",
"country",
"stand",
"notice",
"consultationNote"
]
}🟢explain_term(term, language)
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.
入力スキーマ
{
"type": "object",
"properties": {
"term": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Term in English or German, for example \"183-day rule\" or \"Wegzugsbesteuerung\"."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"required": [
"term"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"found": {
"type": "boolean"
},
"term": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"definition": {
"type": [
"object",
"null"
],
"properties": {
"language": {
"type": "string"
},
"text": {
"type": "string"
}
}
},
"definitionNote": {
"type": "string",
"description": "Only when the English definition is not available yet and the German one is returned."
},
"glossaryPage": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"related": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"ok",
"language",
"found",
"stand",
"notice"
]
}🟢get_cbi_quote(program, language, family)
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). 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.
入力スキーマ
{
"type": "object",
"properties": {
"program": {
"type": "string",
"enum": [
"sao_tome",
"vanuatu",
"dominica",
"st_lucia",
"st_kitts",
"grenada",
"antigua",
"nauru",
"argentina"
],
"description": "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": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
},
"family": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"description": "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.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"role",
"age"
],
"properties": {
"role": {
"type": "string",
"enum": [
"main",
"partner",
"child",
"parent",
"parent_in_law",
"grandparent",
"grandparent_in_law",
"sibling"
],
"description": "Relationship to the main applicant: main, partner, child, parent, parent_in_law, grandparent, grandparent_in_law, sibling."
},
"age": {
"type": "integer",
"minimum": 0,
"maximum": 120,
"description": "Age in years."
},
"married": {
"type": "boolean",
"description": "Married to the main applicant (partner) or married themselves (other roles)."
},
"same_sex": {
"type": "boolean",
"description": "Same-sex partnership (relevant for partners)."
},
"dependent": {
"type": "boolean",
"description": "Dependent on the main applicant (for example a child in education or a parent living in the household)."
},
"financially_dependent": {
"type": "boolean",
"description": "Financially dependent on the main applicant (relevant for adult children and parents)."
},
"nationalities": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"description": "Optional: every citizenship of this person as ISO 3166-1 alpha-2 codes (for example [\"DE\"] or [\"RU\", \"GE\"] for dual citizens), as mentioned by the user."
},
"birthplace": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Optional: country of birth as ISO 3166-1 alpha-2 code, as mentioned by the user."
}
}
}
}
},
"required": [
"family"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"program",
"portfolio"
]
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"generatedAt": {
"type": "string"
},
"program": {
"type": "string",
"description": "Programme key."
},
"programLabel": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"route": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string",
"description": "ok, partial, review_required, fees_on_request or not_eligible (main applicant excluded by nationality or country of birth: no figures, no link)."
},
"total": {
"type": [
"integer",
"null"
],
"description": "Total in USD, rounded to the nearest 1,000."
},
"totalScope": {
"type": [
"string",
"null"
],
"description": "total, or known_costs when professional fees are on request."
},
"costSummary": {
"type": [
"object",
"null"
],
"description": "contribution, investment and professionalFees as published; fees = total minus the other three.",
"properties": {
"contribution": {
"type": "number"
},
"investment": {
"type": "number"
},
"fees": {
"type": "number"
},
"professionalFees": {
"type": [
"number",
"null"
]
}
}
},
"paymentPhases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"amount": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
},
"applicable": {
"type": "boolean"
}
}
}
},
"websiteEstimate": {
"type": [
"number",
"null"
],
"description": "The figure the website calculator shows."
},
"eligibility": {
"type": "object",
"properties": {
"includedCount": {
"type": [
"integer",
"null"
]
},
"excludedCount": {
"type": [
"integer",
"null"
]
},
"excluded": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"processingTime": {
"type": "string"
},
"pages": {
"type": "object",
"properties": {
"calculator": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"info": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"quoteRequestUrl": {
"type": [
"string",
"null"
],
"description": "Link to the calculator page of the programme on goodbyematrix.com with the family already filled in; there the user requests the detailed cost breakdown with the exact amounts. null when not_eligible."
},
"restrictionNote": {
"type": "string",
"description": "Only with status not_eligible: why the programme is not possible."
},
"rounding": {
"type": "object",
"properties": {
"step": {
"type": "integer"
},
"mode": {
"type": "string"
},
"note": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"currency": {
"type": "string"
},
"notice": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"pricingNotice": {
"type": "string"
},
"restrictionsChecked": {
"type": "boolean",
"description": "true when nationalities or a country of birth were given and checked."
},
"overviewUrl": {
"type": [
"string",
"null"
],
"description": "Portfolio only: overview page of all programmes with the family filled in."
},
"programs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"program": {
"type": "string",
"description": "Programme key."
},
"programLabel": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"route": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string",
"description": "ok, partial, review_required, fees_on_request or not_eligible (main applicant excluded by nationality or country of birth: no figures, no link)."
},
"total": {
"type": [
"integer",
"null"
],
"description": "Total in USD, rounded to the nearest 1,000."
},
"totalScope": {
"type": [
"string",
"null"
],
"description": "total, or known_costs when professional fees are on request."
},
"costSummary": {
"type": [
"object",
"null"
],
"description": "contribution, investment and professionalFees as published; fees = total minus the other three.",
"properties": {
"contribution": {
"type": "number"
},
"investment": {
"type": "number"
},
"fees": {
"type": "number"
},
"professionalFees": {
"type": [
"number",
"null"
]
}
}
},
"paymentPhases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"amount": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
},
"applicable": {
"type": "boolean"
}
}
}
},
"websiteEstimate": {
"type": [
"number",
"null"
],
"description": "The figure the website calculator shows."
},
"eligibility": {
"type": "object",
"properties": {
"includedCount": {
"type": [
"integer",
"null"
]
},
"excludedCount": {
"type": [
"integer",
"null"
]
},
"excluded": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"processingTime": {
"type": "string"
},
"pages": {
"type": "object",
"properties": {
"calculator": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"info": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"quoteRequestUrl": {
"type": [
"string",
"null"
],
"description": "Link to the calculator page of the programme on goodbyematrix.com with the family already filled in; there the user requests the detailed cost breakdown with the exact amounts. null when not_eligible."
},
"restrictionNote": {
"type": "string",
"description": "Only with status not_eligible: why the programme is not possible."
},
"rounding": {
"type": "object",
"properties": {
"step": {
"type": "integer"
},
"mode": {
"type": "string"
},
"note": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"currency": {
"type": "string"
},
"notice": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"startingAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"ok",
"schema",
"scope",
"language"
],
"description": "Same JSON as the GET/POST quote endpoint of the GoodbyeMatrix pricing API: one programme (scope \"program\") or all programmes (scope \"portfolio\", list in programs)."
}🟢list_cbi_programs(language)
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.
入力スキーマ
{
"type": "object",
"properties": {
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"currency": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"generatedAt": {
"type": "string"
},
"overview": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"documentation": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"quoteEndpoint": {
"type": "string"
},
"programs": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label"
],
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"region": {
"type": "string"
},
"route": {
"type": "string",
"description": "contribution, investment or both."
},
"startingAmount": {
"type": [
"number",
"null"
],
"description": "\"From\" amount in USD for a single applicant."
},
"currency": {
"type": "string"
},
"professionalFeesLabel": {
"type": [
"string",
"null"
]
},
"processingTime": {
"type": "string"
},
"visaFreeCount": {
"type": "integer"
},
"pages": {
"type": "object",
"properties": {
"calculator": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"info": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"notes": {
"type": "string"
},
"restrictions": {
"type": "object",
"description": "Public programme rule: excluded nationalities and countries of birth (ISO-2 code and name).",
"properties": {
"nationalities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"birthplaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
}
}
}
},
"notice": {
"type": "object",
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
},
"required": [
"ok",
"language",
"programs"
],
"description": "Same JSON as the GET programs endpoint of the GoodbyeMatrix pricing API."
}🟢request_cost_breakdown_link(program, language, family, contact)
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. Contact details (first name, last name, e-mail, phone) are optional; only details the user has provided and wants to pass on are used. They prefill the form on that page and are never part of the link; the link works without them. The user checks the details and sends the request personally; the privacy consent is never preselected.
入力スキーマ
{
"type": "object",
"properties": {
"program": {
"type": "string",
"enum": [
"sao_tome",
"vanuatu",
"dominica",
"st_lucia",
"st_kitts",
"grenada",
"antigua",
"nauru",
"argentina"
],
"description": "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."
},
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
},
"family": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"description": "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.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"role",
"age"
],
"properties": {
"role": {
"type": "string",
"enum": [
"main",
"partner",
"child",
"parent",
"parent_in_law",
"grandparent",
"grandparent_in_law",
"sibling"
],
"description": "Relationship to the main applicant: main, partner, child, parent, parent_in_law, grandparent, grandparent_in_law, sibling."
},
"age": {
"type": "integer",
"minimum": 0,
"maximum": 120,
"description": "Age in years."
},
"married": {
"type": "boolean",
"description": "Married to the main applicant (partner) or married themselves (other roles)."
},
"same_sex": {
"type": "boolean",
"description": "Same-sex partnership (relevant for partners)."
},
"dependent": {
"type": "boolean",
"description": "Dependent on the main applicant (for example a child in education or a parent living in the household)."
},
"financially_dependent": {
"type": "boolean",
"description": "Financially dependent on the main applicant (relevant for adult children and parents)."
},
"nationalities": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"description": "Optional: every citizenship of this person as ISO 3166-1 alpha-2 codes (for example [\"DE\"] or [\"RU\", \"GE\"] for dual citizens), as mentioned by the user."
},
"birthplace": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Optional: country of birth as ISO 3166-1 alpha-2 code, as mentioned by the user."
}
}
}
},
"contact": {
"type": "object",
"additionalProperties": false,
"description": "Optional. Contact details are used only as the user has provided them in this conversation and wants to pass them on to GoodbyeMatrix; the link works without them. They prefill the request form on the page; they are not part of the link and the user still checks and sends the request personally.",
"properties": {
"first_name": {
"type": "string",
"maxLength": 60
},
"last_name": {
"type": "string",
"maxLength": 60
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "With international dialling code, for example +49 151 2345678."
}
}
}
},
"required": [
"program",
"family"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"program": {
"type": "string"
},
"programLabel": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"quoteRequestUrl": {
"type": "string",
"description": "Link to the calculator page with the family filled in, where the user requests the detailed cost breakdown by e-mail."
},
"contactPrefilled": {
"type": "boolean",
"description": "Only when contact was given: true if at least one contact field was accepted and will prefill the form."
},
"ignoredFields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only when contact was given: contact fields that were invalid and dropped."
}
},
"required": [
"program",
"language",
"quoteRequestUrl"
]
}🟢request_consultation_link(language)
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; this tool sends and books nothing.
入力スキーマ
{
"type": "object",
"properties": {
"language": {
"type": "string",
"enum": [
"de",
"en"
],
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German)."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"tool": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"de",
"en"
]
},
"stand": {
"type": [
"string",
"null"
],
"description": "Date of the source data (YYYY-MM-DD)."
},
"notice": {
"type": "string",
"description": "General information, not legal, tax or immigration advice."
},
"consultationUrl": {
"type": "string"
},
"languagesOffered": {
"type": "array",
"items": {
"type": "string"
}
},
"covers": {
"type": "string"
}
},
"required": [
"ok",
"language",
"consultationUrl",
"stand",
"notice"
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 9 件