Server definition
- Hash
- sha256:12559ff6e08f1c4b71598ed6dd76f146083fa1bb1237cf62f861b2f588a2d0c1
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "GoodbyeMatrix Residency & Citizenship Index: general information on residency programmes and citizenship by investment from the GoodbyeMatrix knowledge base, for moving abroad along the lines of flag theory (a second residency, a second passport, a new tax residence). It covers more than 170 public residency programmes in more than 80 countries (golden visa or residence by investment, digital nomad visa, independent means visa for retirees and passive income, active investor and entrepreneur visa), 20 citizenship by investment (CBI) programmes, about 200 countries with their tax system and a glossary of relocation and tax terms. search_programs filters programmes by country, region, programme type, maximum budget in USD, path to citizenship and dual citizenship, with paging. get_program returns one programme in detail, compare_programs sets 2 to 5 programmes side by side, get_country_overview summarises a country (tax system, programmes, link to the GoodbyeMatrix climate map) and explain_term explains a glossary term with its glossary page. For the 9 CBI programmes with a cost calculator (St Kitts and Nevis, Antigua and Barbuda, Dominica, Grenada, Saint Lucia, Vanuatu, Sao Tome and Principe, Nauru, Argentina), get_cbi_quote calculates indicative costs for a specific family, list_cbi_programs lists these programmes and request_cost_breakdown_link returns the link to the detailed cost breakdown; the figures are rounded and binding only after a pre-check. The other CBI programmes are listed as on request, coming soon or closed. request_consultation_link returns the page for a free initial consultation with GoodbyeMatrix; the link carries no personal data. Every answer names the GoodbyeMatrix programme page in German and English, the date of the source (stand) and a short note that the content is general information, not legal, tax or immigration advice, and does not decide eligibility. Answers are in English by default or in German with language \"de\".",
"tools": [
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ids": {
"description": "2 to 5 programme ids (as returned by search_programs).",
"items": {
"description": "Programme id as returned by search_programs or get_country_overview (for example \"portugal__portugal_golden_visa\" or \"grenada\"); a programme name is matched as well.",
"maxLength": 120,
"minLength": 2,
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
}
},
"required": [
"ids"
],
"type": "object"
},
"name": "compare_programs",
"outputSchema": {
"properties": {
"consultationNote": {
"type": "string"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"ok": {
"type": "boolean"
},
"programs": {
"items": {
"properties": {
"availability": {
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed.",
"type": "string"
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"country": {
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"dualCitizenship": {
"description": "permitted, conditional or prohibited.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Programme id for get_program and compare_programs.",
"type": "string"
},
"incomeRequirement": {
"description": "Residency only, where published: minimum income as on the programme page.",
"type": "string"
},
"minInvestmentUsd": {
"description": "Minimum investment in USD where known (0 when no investment is required).",
"type": [
"number",
"null"
]
},
"minimumAmount": {
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"pages": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"presence": {
"description": "Physical presence requirement.",
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"stand": {
"type": [
"string",
"null"
]
},
"type": {
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
},
"typeLabel": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
}
},
"required": [
"ok",
"language",
"programs",
"stand",
"notice",
"consultationNote"
],
"type": "object"
}
},
{
"description": "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 text is the German GoodbyeMatrix definition; related terms are listed when the search term matches several entries.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
},
"term": {
"description": "Term in English or German, for example \"183-day rule\" or \"Wegzugsbesteuerung\".",
"maxLength": 120,
"minLength": 2,
"type": "string"
}
},
"required": [
"term"
],
"type": "object"
},
"name": "explain_term",
"outputSchema": {
"properties": {
"definition": {
"properties": {
"language": {
"type": "string"
},
"text": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"found": {
"type": "boolean"
},
"glossaryPage": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"ok": {
"type": "boolean"
},
"related": {
"items": {
"type": "object"
},
"type": "array"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"term": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
},
"id": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"tool": {
"type": "string"
}
},
"required": [
"ok",
"language",
"found",
"stand",
"notice"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"family": {
"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": {
"additionalProperties": false,
"properties": {
"age": {
"description": "Age in years.",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"birthplace": {
"description": "Optional: country of birth as ISO 3166-1 alpha-2 code, as mentioned by the user.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"dependent": {
"description": "Dependent on the main applicant (for example a child in education or a parent living in the household).",
"type": "boolean"
},
"financially_dependent": {
"description": "Financially dependent on the main applicant (relevant for adult children and parents).",
"type": "boolean"
},
"married": {
"description": "Married to the main applicant (partner) or married themselves (other roles).",
"type": "boolean"
},
"nationalities": {
"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.",
"items": {
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"role": {
"description": "Relationship to the main applicant: main, partner, child, parent, parent_in_law, grandparent, grandparent_in_law, sibling.",
"enum": [
"main",
"partner",
"child",
"parent",
"parent_in_law",
"grandparent",
"grandparent_in_law",
"sibling"
],
"type": "string"
},
"same_sex": {
"description": "Same-sex partnership (relevant for partners).",
"type": "boolean"
}
},
"required": [
"role",
"age"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
},
"program": {
"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.",
"enum": [
"sao_tome",
"vanuatu",
"dominica",
"st_lucia",
"st_kitts",
"grenada",
"antigua",
"nauru",
"argentina"
],
"type": "string"
}
},
"required": [
"family"
],
"type": "object"
},
"name": "get_cbi_quote",
"outputSchema": {
"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).",
"properties": {
"costSummary": {
"description": "contribution, investment and professionalFees as published; fees = total minus the other three.",
"properties": {
"contribution": {
"type": "number"
},
"fees": {
"type": "number"
},
"investment": {
"type": "number"
},
"professionalFees": {
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"currency": {
"type": "string"
},
"eligibility": {
"properties": {
"excluded": {
"items": {
"type": "object"
},
"type": "array"
},
"excludedCount": {
"type": [
"integer",
"null"
]
},
"includedCount": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"generatedAt": {
"type": "string"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"ok": {
"type": "boolean"
},
"overviewUrl": {
"description": "Portfolio only: overview page of all programmes with the family filled in.",
"type": [
"string",
"null"
]
},
"pages": {
"properties": {
"calculator": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"info": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"paymentPhases": {
"items": {
"properties": {
"amount": {
"type": [
"number",
"null"
]
},
"applicable": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"pricingNotice": {
"type": "string"
},
"processingTime": {
"type": "string"
},
"program": {
"description": "Programme key.",
"type": "string"
},
"programLabel": {
"type": "string"
},
"programs": {
"items": {
"properties": {
"costSummary": {
"description": "contribution, investment and professionalFees as published; fees = total minus the other three.",
"properties": {
"contribution": {
"type": "number"
},
"fees": {
"type": "number"
},
"investment": {
"type": "number"
},
"professionalFees": {
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"currency": {
"type": "string"
},
"eligibility": {
"properties": {
"excluded": {
"items": {
"type": "object"
},
"type": "array"
},
"excludedCount": {
"type": [
"integer",
"null"
]
},
"includedCount": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"notice": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"pages": {
"properties": {
"calculator": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"info": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"paymentPhases": {
"items": {
"properties": {
"amount": {
"type": [
"number",
"null"
]
},
"applicable": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"processingTime": {
"type": "string"
},
"program": {
"description": "Programme key.",
"type": "string"
},
"programLabel": {
"type": "string"
},
"quoteRequestUrl": {
"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.",
"type": [
"string",
"null"
]
},
"restrictionNote": {
"description": "Only with status not_eligible: why the programme is not possible.",
"type": "string"
},
"rounding": {
"properties": {
"mode": {
"type": "string"
},
"note": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"step": {
"type": "integer"
}
},
"type": "object"
},
"route": {
"type": [
"string",
"null"
]
},
"startingAmount": {
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"status": {
"description": "ok, partial, review_required, fees_on_request or not_eligible (main applicant excluded by nationality or country of birth: no figures, no link).",
"type": "string"
},
"total": {
"description": "Total in USD, rounded to the nearest 1,000.",
"type": [
"integer",
"null"
]
},
"totalScope": {
"description": "total, or known_costs when professional fees are on request.",
"type": [
"string",
"null"
]
},
"variant": {
"type": [
"string",
"null"
]
},
"websiteEstimate": {
"description": "The figure the website calculator shows.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"quoteRequestUrl": {
"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.",
"type": [
"string",
"null"
]
},
"restrictionNote": {
"description": "Only with status not_eligible: why the programme is not possible.",
"type": "string"
},
"restrictionsChecked": {
"description": "true when nationalities or a country of birth were given and checked.",
"type": "boolean"
},
"rounding": {
"properties": {
"mode": {
"type": "string"
},
"note": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"step": {
"type": "integer"
}
},
"type": "object"
},
"route": {
"type": [
"string",
"null"
]
},
"schema": {
"type": "string"
},
"scope": {
"enum": [
"program",
"portfolio"
],
"type": "string"
},
"status": {
"description": "ok, partial, review_required, fees_on_request or not_eligible (main applicant excluded by nationality or country of birth: no figures, no link).",
"type": "string"
},
"total": {
"description": "Total in USD, rounded to the nearest 1,000.",
"type": [
"integer",
"null"
]
},
"totalScope": {
"description": "total, or known_costs when professional fees are on request.",
"type": [
"string",
"null"
]
},
"variant": {
"type": [
"string",
"null"
]
},
"websiteEstimate": {
"description": "The figure the website calculator shows.",
"type": [
"number",
"null"
]
}
},
"required": [
"ok",
"schema",
"scope",
"language"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"country": {
"description": "Country as ISO 3166-1 alpha-2 code (for example \"PA\") or name in English or German.",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
}
},
"required": [
"country"
],
"type": "object"
},
"name": "get_country_overview",
"outputSchema": {
"properties": {
"cbiPrograms": {
"items": {
"properties": {
"availability": {
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed.",
"type": "string"
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"country": {
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"dualCitizenship": {
"description": "permitted, conditional or prohibited.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Programme id for get_program and compare_programs.",
"type": "string"
},
"incomeRequirement": {
"description": "Residency only, where published: minimum income as on the programme page.",
"type": "string"
},
"minInvestmentUsd": {
"description": "Minimum investment in USD where known (0 when no investment is required).",
"type": [
"number",
"null"
]
},
"minimumAmount": {
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"pages": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"presence": {
"description": "Physical presence requirement.",
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"stand": {
"type": [
"string",
"null"
]
},
"type": {
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
},
"typeLabel": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"climateMap": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"consultationNote": {
"type": "string"
},
"country": {
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"ok": {
"type": "boolean"
},
"residencyPrograms": {
"items": {
"properties": {
"availability": {
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed.",
"type": "string"
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"country": {
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"dualCitizenship": {
"description": "permitted, conditional or prohibited.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Programme id for get_program and compare_programs.",
"type": "string"
},
"incomeRequirement": {
"description": "Residency only, where published: minimum income as on the programme page.",
"type": "string"
},
"minInvestmentUsd": {
"description": "Minimum investment in USD where known (0 when no investment is required).",
"type": [
"number",
"null"
]
},
"minimumAmount": {
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"pages": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"presence": {
"description": "Physical presence requirement.",
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"stand": {
"type": [
"string",
"null"
]
},
"type": {
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
},
"typeLabel": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"taxSystem": {
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"tool": {
"type": "string"
}
},
"required": [
"ok",
"language",
"country",
"stand",
"notice",
"consultationNote"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Programme id as returned by search_programs or get_country_overview (for example \"portugal__portugal_golden_visa\" or \"grenada\"); a programme name is matched as well.",
"maxLength": 120,
"minLength": 2,
"type": "string"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_program",
"outputSchema": {
"properties": {
"cbiQuoteNote": {
"description": "Only for the 9 programmes with a cost calculator: get_cbi_quote calculates the costs for a specific family.",
"type": "string"
},
"consultationNote": {
"type": "string"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"ok": {
"type": "boolean"
},
"program": {
"properties": {
"availability": {
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed.",
"type": "string"
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"country": {
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"dualCitizenship": {
"description": "permitted, conditional or prohibited.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Programme id for get_program and compare_programs.",
"type": "string"
},
"incomeRequirement": {
"description": "Residency only, where published: minimum income as on the programme page.",
"type": "string"
},
"minInvestmentUsd": {
"description": "Minimum investment in USD where known (0 when no investment is required).",
"type": [
"number",
"null"
]
},
"minimumAmount": {
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"officialLinks": {
"type": "array"
},
"pages": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"presence": {
"description": "Physical presence requirement.",
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"stand": {
"type": [
"string",
"null"
]
},
"texts": {
"type": "object"
},
"type": {
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
},
"typeLabel": {
"type": "string"
}
},
"type": "object"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
}
},
"required": [
"ok",
"language",
"program",
"stand",
"notice",
"consultationNote"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_cbi_programs",
"outputSchema": {
"description": "Same JSON as the GET programs endpoint of the GoodbyeMatrix pricing API.",
"properties": {
"currency": {
"type": "string"
},
"documentation": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"generatedAt": {
"type": "string"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"notice": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"ok": {
"type": "boolean"
},
"overview": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"programs": {
"items": {
"properties": {
"currency": {
"type": "string"
},
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"notes": {
"type": "string"
},
"pages": {
"properties": {
"calculator": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"info": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"processingTime": {
"type": "string"
},
"professionalFeesLabel": {
"type": [
"string",
"null"
]
},
"region": {
"type": "string"
},
"restrictions": {
"description": "Public programme rule: excluded nationalities and countries of birth (ISO-2 code and name).",
"properties": {
"birthplaces": {
"items": {
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"nationalities": {
"items": {
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"route": {
"description": "contribution, investment or both.",
"type": "string"
},
"startingAmount": {
"description": "\"From\" amount in USD for a single applicant.",
"type": [
"number",
"null"
]
},
"visaFreeCount": {
"type": "integer"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
},
"quoteEndpoint": {
"type": "string"
},
"schema": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
},
"required": [
"ok",
"language",
"programs"
],
"type": "object"
}
},
{
"description": "Returns the page for arranging a free, non-binding initial consultation with GoodbyeMatrix (in German or English): the URL, the languages offered and what the call covers. The link carries no personal data; booking happens on that page.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "request_consultation_link",
"outputSchema": {
"properties": {
"consultationUrl": {
"type": "string"
},
"covers": {
"type": "string"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"languagesOffered": {
"items": {
"type": "string"
},
"type": "array"
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"ok": {
"type": "boolean"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
}
},
"required": [
"ok",
"language",
"consultationUrl",
"stand",
"notice"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"contact": {
"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": {
"email": {
"maxLength": 254,
"type": "string"
},
"first_name": {
"maxLength": 60,
"type": "string"
},
"last_name": {
"maxLength": 60,
"type": "string"
},
"phone": {
"description": "With international dialling code, for example +49 151 2345678.",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"family": {
"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": {
"additionalProperties": false,
"properties": {
"age": {
"description": "Age in years.",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"birthplace": {
"description": "Optional: country of birth as ISO 3166-1 alpha-2 code, as mentioned by the user.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"dependent": {
"description": "Dependent on the main applicant (for example a child in education or a parent living in the household).",
"type": "boolean"
},
"financially_dependent": {
"description": "Financially dependent on the main applicant (relevant for adult children and parents).",
"type": "boolean"
},
"married": {
"description": "Married to the main applicant (partner) or married themselves (other roles).",
"type": "boolean"
},
"nationalities": {
"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.",
"items": {
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"role": {
"description": "Relationship to the main applicant: main, partner, child, parent, parent_in_law, grandparent, grandparent_in_law, sibling.",
"enum": [
"main",
"partner",
"child",
"parent",
"parent_in_law",
"grandparent",
"grandparent_in_law",
"sibling"
],
"type": "string"
},
"same_sex": {
"description": "Same-sex partnership (relevant for partners).",
"type": "boolean"
}
},
"required": [
"role",
"age"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
},
"program": {
"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.",
"enum": [
"sao_tome",
"vanuatu",
"dominica",
"st_lucia",
"st_kitts",
"grenada",
"antigua",
"nauru",
"argentina"
],
"type": "string"
}
},
"required": [
"program",
"family"
],
"type": "object"
},
"name": "request_cost_breakdown_link",
"outputSchema": {
"properties": {
"contactPrefilled": {
"description": "Only when contact was given: true if at least one contact field was accepted and will prefill the form.",
"type": "boolean"
},
"ignoredFields": {
"description": "Only when contact was given: contact fields that were invalid and dropped.",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"program": {
"type": "string"
},
"programLabel": {
"type": "string"
},
"quoteRequestUrl": {
"description": "Link to the calculator page with the family filled in, where the user requests the detailed cost breakdown by e-mail.",
"type": "string"
}
},
"required": [
"program",
"language",
"quoteRequestUrl"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"citizenship_path": {
"description": "true: programmes with a path to citizenship; false: programmes without one.",
"type": "boolean"
},
"country": {
"description": "Country as ISO 3166-1 alpha-2 code (for example \"PT\") or name in English or German.",
"maxLength": 80,
"type": "string"
},
"dual_citizenship_allowed": {
"description": "true: dual citizenship permitted; false: dual citizenship prohibited. Conditional cases match neither.",
"type": "boolean"
},
"language": {
"default": "en",
"description": "Response language: \"en\" (English, default) or \"de\" (German).",
"enum": [
"de",
"en"
],
"type": "string"
},
"limit": {
"default": 10,
"description": "Number of programmes per page (1 to 10, default 10).",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"max_budget_usd": {
"description": "Maximum minimum investment in USD; programmes without a known amount are not matched.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"offset": {
"default": 0,
"description": "Start position for the next page (nextOffset of the previous answer).",
"minimum": 0,
"type": "integer"
},
"region": {
"description": "Region: europe, americas (including the Caribbean), asia, africa, middle_east or oceania.",
"enum": [
"europe",
"americas",
"asia",
"africa",
"middle_east",
"oceania"
],
"type": "string"
},
"type": {
"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).",
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_programs",
"outputSchema": {
"properties": {
"filters": {
"type": "object"
},
"language": {
"enum": [
"de",
"en"
],
"type": "string"
},
"limit": {
"type": "integer"
},
"nextOffset": {
"type": [
"integer",
"null"
]
},
"notice": {
"description": "General information, not legal, tax or immigration advice.",
"type": "string"
},
"offset": {
"type": "integer"
},
"ok": {
"type": "boolean"
},
"programs": {
"items": {
"properties": {
"availability": {
"description": "Citizenship by investment only: cost_calculator, on_request, coming_soon or closed.",
"type": "string"
},
"citizenshipPath": {
"type": [
"boolean",
"null"
]
},
"country": {
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"dualCitizenship": {
"description": "permitted, conditional or prohibited.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Programme id for get_program and compare_programs.",
"type": "string"
},
"incomeRequirement": {
"description": "Residency only, where published: minimum income as on the programme page.",
"type": "string"
},
"minInvestmentUsd": {
"description": "Minimum investment in USD where known (0 when no investment is required).",
"type": [
"number",
"null"
]
},
"minimumAmount": {
"description": "Minimum investment as published on the programme page (currency as stated); for citizenship by investment the lowest starting amount in USD.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"pages": {
"properties": {
"de": {
"type": "string"
},
"en": {
"type": "string"
}
},
"type": "object"
},
"presence": {
"description": "Physical presence requirement.",
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"stand": {
"type": [
"string",
"null"
]
},
"type": {
"enum": [
"citizenship_by_investment",
"residence_by_investment",
"digital_nomad",
"independent_means",
"active_investor",
"skilled_work"
],
"type": "string"
},
"typeLabel": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"schema": {
"type": "string"
},
"stand": {
"description": "Date of the source data (YYYY-MM-DD).",
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"total": {
"type": "integer"
}
},
"required": [
"ok",
"language",
"total",
"programs",
"stand",
"notice"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:12559ff6e08f1c4b71598ed6dd76f146083fa1bb1237cf62f861b2f588a2d0c1 | sha256sum