Geo-Parity MCP — MCP Radar

arrival_cost

What It Costs to Arrive

The cash needed to ARRIVE somewhere, as opposed to what a month costs once you live there: the entry fee for a given passport, the first month's rent, the deposit, and a long-stay visa fee where one has been verified against the issuing government. READ `complete` BEFORE `totalUsd`. Rent covers a subset of the country spine and most visa fees could not be verified, so the total is a FLOOR whenever `complete` is false, and `missing` names every component that could not be priced. The total can legitimately be 0 - visa-free entry into a country with no rent figure sums to nothing known - which is honest arithmetic and a false headline. `depositMonths` is a STATED ASSUMPTION, not a measurement: no free global dataset of deposit norms exists. The entry route itself is derived exactly from passport mobility data, so 'for this passport, this destination is visa-free' is always answered even when no fee is.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'passport': 'US', 'destination': 'GB'}], 'required': ['passport', 'destination'], 'properties': {'income': {'type': 'number', 'minimum': 0, 'description': "Monthly remote income in USD. Optional; enables housing's income-relative view but is not needed for the arrival total."}, 'passport': {'type': 'string', 'description': "ISO alpha-2 of the traveller's passport, e.g. 'US'. Determines the entry route and therefore the fee."}, 'destination': {'type': 'string', 'description': 'ISO alpha-2 of the destination. Must be in the PPP country registry; some countries with a verified nomad-visa fee (e.g. BB) are not and appear only in find_nomad_visas.'}, 'depositMonths': {'type': 'number', 'maximum': 12, 'minimum': 0, 'description': "Months of rent held as a deposit. Defaults to the site's stated assumption of 1; override it if you know the market."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'years': {'type': 'object'}, 'country': {'type': 'string'}, 'metrics': {'type': 'object', 'properties': {'mortgageRatePct': {'type': 'number'}, 'housingPriceLevelEu': {'type': 'number'}, 'priceToRentVsLongRun': {'type': 'number'}, 'priceToIncomeVsLongRun': {'type': 'number'}}}, 'rentBasis': {'enum': ['measured', 'modelled'], 'type': 'string'}, 'arbitrageGap': {'type': 'number', 'description': 'Percentage points by which rent sits lighter on you than on a local.'}, 'measuredCities': {'type': 'number'}, 'rentMonthlyUsd': {'type': 'number'}, 'rentPctOfYourIncome': {'type': 'number'}, 'rentPctOfLocalMedian': {'type': 'number'}}}}, 'focus': {'type': 'object'}, 'updated': {'type': 'string'}, 'excluded': {'type': 'number'}, 'attribution': {'type': 'object'}}}

banking_access

Banking access — opening an account, deposit protection and instant payments

Whether a newcomer can open a personal bank account in a country (`yes`, `restricted` or `no`) with the documents usually asked for from a fixed vocabulary, the statutory deposit guarantee per depositor per bank in local currency AND converted to USD at the site's FX snapshot, the country's instant payment systems from the World Bank's Project FASTT tracker, the EU basic-account right under Directive 2014/92/EU where it applies, and a FATCA flag where banks commonly decline US citizens — a hand-curated register over all 186 spine countries, added 17 Sep 2026, with the scheme or regulator page and check date per row (`confidence: "secondary"` where the official page could not be fetched, separately on `depositGuarantee` for the figure). A country with no deposit-insurance scheme has NO `depositGuarantee` — never a zero — and a country absent from FASTT has no `instantPayments`, which is not the same as having no instant payments. `country` for one entry, `countries` for a side-by-side; without either, ranks by `metric` (`depositGuaranteeUsd` default, or `instantPaymentsSince`, whose `sort=lowest` lists the longest-running first), optionally narrowed by `access`, with countries lacking the metric in `excluded`. `internationalOptions` describes the kinds of cross-border account and what protects the money — categories only, never a named provider. For information only — not financial advice; banks set their own onboarding policies and every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'PT'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'description': 'Defaults to highest, or lowest for instantPaymentsSince (longest-running first).'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Maximum rows in a ranking.'}, 'access': {'enum': ['yes', 'restricted', 'no'], 'type': 'string', 'description': 'Narrow a ranking to one non-resident access rule.'}, 'metric': {'enum': ['depositGuaranteeUsd', 'instantPaymentsSince'], 'type': 'string', 'default': 'depositGuaranteeUsd', 'description': 'Ranking metric when no country is given.'}, 'country': {'type': 'string', 'description': 'ISO alpha-2 code for a single country, e.g. PT.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, at least two, e.g. GB,TH,NG.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array'}, 'caveats': {'type': 'array'}, 'excluded': {'type': 'array'}, 'attribution': {'type': 'object'}, 'internationalOptions': {'type': 'array'}}}

build_pay_range

Build a defensible pay range for a role in a country

Returns a floor, midpoint and ceiling salary for a broad occupation and seniority in a country, anchored on ILO's measured earnings where they exist and on the modelled national wage ladder where they do not — `basis` says which. Built for the employer side of pay transparency: since 7 June 2026 the EU Pay Transparency Directive has required a starting salary or pay range in the job advert. IT IS NOT LEGAL ADVICE AND DOES NOT CERTIFY COMPLIANCE — it is a market range from official statistics, and every response carries a `caveats` array saying so, which should be reproduced alongside any figure quoted from it. Seniority is applied as a percentile offset within the country's own distribution rather than a fixed multiplier, so the same level means the same position locally rather than the same ratio. The gender pay gap for the occupation is reported beside the range and never folded into it. ISCO-08 major groups are broad families of work, not job titles.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'DE', 'seniority': 'senior', 'occupation': 'professionals'}], 'required': ['country'], 'properties': {'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (case-insensitive).'}, 'seniority': {'enum': ['entry', 'mid', 'senior', 'lead'], 'type': 'string', 'description': "Defaults to 'mid'. An unrecognised value is rejected."}, 'occupation': {'enum': ['total', 'armed-forces', 'managers', 'professionals', 'technicians', 'clerical', 'services-sales', 'agricultural', 'craft', 'operators', 'elementary'], 'type': 'string', 'description': "ISCO-08 major group. Defaults to 'total' (all occupations). An unrecognised value is rejected, never widened to the default."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'year': {'type': 'number'}, 'basis': {'type': 'string', 'description': "'measured' or 'modelled' — never blurred."}, 'floor': {'type': 'object', 'properties': {'annualUsd': {'type': 'number'}, 'monthlyUsd': {'type': 'number'}, 'percentile': {'type': 'number'}}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present. Reproduce these with any quoted figure.'}, 'ceiling': {'type': 'object', 'properties': {'annualUsd': {'type': 'number'}, 'monthlyUsd': {'type': 'number'}, 'percentile': {'type': 'number'}}}, 'country': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}}}, 'midpoint': {'type': 'object', 'properties': {'annualUsd': {'type': 'number'}, 'monthlyUsd': {'type': 'number'}, 'percentile': {'type': 'number'}}}, 'seniority': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}}}, 'occupation': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}}}, 'genderGapPct': {'type': 'number'}, 'occupationMedianMonthlyUsd': {'type': 'number'}}}

calculate_ppp

Calculate Purchasing Power Parity

Given a US-denominated annual income and a target country code, returns the effective local purchasing power (income / pppIndex), the lifestyle equilibrium cost (income * pppIndex), and the purchasing power ratio (1 / pppIndex). Figures use real PPP data (World Bank, IMF, OECD, Penn World Table) relative to a US baseline of 1.0.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'income': 100000, 'target': 'TH'}], 'required': ['income', 'target'], 'properties': {'city': {'type': 'string', 'description': "Optional city slug (e.g. 'london', 'san-francisco') for a sub-national Capital-to-Rural adjustment: multiplies the national price level by a per-city factor (curated overrides / US-metro BEA RPP / population-tier heuristic). Unknown slug = national figure."}, 'income': {'type': 'number', 'minimum': 0, 'description': 'Nominal annual income, denominated against the US baseline.'}, 'source': {'enum': ['consensus', 'worldbank', 'imf', 'oecd', 'pwt', 'worldbank-cons', 'bigmac', 'factbook'], 'type': 'string', 'default': 'consensus', 'description': "PPP dataset to draw figures from. 'consensus' = per-country median across the GDP-based providers (recommended default); 'worldbank' = World Bank GDP price level; 'imf' = IMF WEO implied PPP; 'oecd' = OECD PPP-for-GDP (members + key partners only); 'pwt' = Penn World Table; 'worldbank-cons' = World Bank household-consumption price level; 'bigmac' = The Economist Big Mac index (single-good consumer PPP, ~40 countries); 'factbook' = CIA World Factbook derived price level for ~100 micro-states/territories the macro sources ignore (coarse). Defaults to 'consensus' if omitted."}, 'target': {'enum': ['US', 'AR', 'AU', 'BR', 'CA', 'CL', 'CN', 'CO', 'CZ', 'DK', 'EG', 'FR', 'DE', 'GR', 'HU', 'IN', 'ID', 'IE', 'IT', 'JP', 'KR', 'MY', 'MX', 'NL', 'NZ', 'NG', 'NO', 'PH', 'PL', 'PT', 'SA', 'SG', 'ZA', 'ES', 'SE', 'CH', 'TH', 'TR', 'AE', 'GB', 'VN'], 'type': 'string', 'description': 'ISO 3166-1 alpha-2 target country code (case-insensitive). Available codes depend on the chosen source.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'source': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}}}, 'target': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}, 'currency': {'type': 'string'}, 'pppIndex': {'type': 'number'}}}, 'metrics': {'type': 'object', 'properties': {'purchasingPowerRatio': {'type': 'number'}, 'effectivePurchasingPower': {'type': 'number'}, 'lifestyleEquilibriumCost': {'type': 'number'}}}}}

calculate_runway

Runway multiplier from relocating (bootstrap buffer)

For founders/freelancers stretching savings: computes how many extra months of runway relocating to a cheaper hub buys. Burn is split into fixed (location-independent — subscriptions, debt, insurance) and local; only the local slice scales by the target's cost-of-living ratio (city-level where a curated hub is given, else national, incl. Factbook-only countries). Returns the home baseline plus each hub's monthly burn, runway months, extra months, run-out date and the ×multiplier. Estimates from purchasing-power data, not financial advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'burn': 3000, 'home': 'GB', 'fixed': 800, 'savings': 20000, 'targets': 'TH:chiang-mai,GE', 'currency': 'GBP'}], 'required': ['savings', 'burn', 'targets'], 'properties': {'burn': {'type': 'number', 'description': 'Total current monthly burn at home (in `currency`).'}, 'home': {'type': 'string', 'description': 'Home country alpha-2 code. Default US.'}, 'fixed': {'type': 'number', 'description': "Location-independent slice of burn (0…burn) that won't fall when you move."}, 'savings': {'type': 'number', 'description': 'Total savings (in `currency`).'}, 'targets': {'type': 'string', 'description': '1–3 hubs, comma-separated: COUNTRY or COUNTRY:citySlug (e.g. TH:chiang-mai,AR:buenos-aires,GE).'}, 'currency': {'type': 'string', 'description': 'ISO code for the money inputs (e.g. GBP). Default USD.'}, 'homeCity': {'type': 'string', 'description': 'Optional curated home-city slug.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'home': {'type': 'object', 'properties': {'runsOut': {'type': 'string'}, 'runwayMonths': {'type': 'number'}}}, 'hubs': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Sorted by extra months; each has runwayMonths, extraMonths, multiplier, monthlyBurnUsd, runsOut, priceRatio and a coverage note when approximate.'}, 'fixedFloorMonths': {'type': ['number', 'null'], 'description': 'Runway cap even at zero local cost (savings ÷ fixed burn).'}}}

calculate_wage_bands

Benchmark local salary bands (min, median, top 10%)

Models a country's wage distribution as log-normal, calibrated from World Bank GNI per capita (mean) and the Gini index (spread: sigma = sqrt(2)*normInv((Gini+1)/2)), then returns the survival floor (essentials), statutory minimum (ILOSTAT where available, else curated; null where none exists), median (p50), comfortable (p75), top 10% (p90) and top 1% (p99) bands — each monthly and annual, USD and local currency. Optional `salary` locates a pay figure on the curve (percentile + out-earns %); `percentile` returns that exact threshold wage. Model estimates for benchmarking, not payroll data.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'PL', 'percentile': 90}], 'required': ['country'], 'properties': {'salary': {'type': 'number', 'minimum': 0, 'description': 'Your salary to locate on the distribution. Values over 20000 are read as annual (÷12), else monthly.'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (case-insensitive).'}, 'percentile': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Return the exact wage threshold at this percentile (e.g. 90 for the top-10% floor).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'bands': {'type': 'object', 'properties': {'top1': {'type': 'object'}, 'top10': {'type': 'object'}, 'median': {'type': 'object'}, 'minimum': {'type': ['object', 'null']}, 'survival': {'type': 'object'}, 'comfortable': {'type': 'object'}}}, 'model': {'type': 'object', 'properties': {'gini': {'type': 'number'}, 'sigma': {'type': 'number'}, 'meanMonthly': {'type': 'number'}}}, 'country': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}}}, 'standing': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'percentile': {'type': 'number'}}}, 'atPercentile': {'type': 'object'}}}

check_residency

Check tax-residency day counts

Count distinct days of presence per country per calendar year and evaluate the generic 183-day rule, the US Substantial Presence Test (weighted 3-year formula), and the UK 183-day tax-year test. Early-warning day counter — not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'stays': [{'exit': '2026-04-02', 'entry': '2026-01-10', 'country': 'PT'}]}], 'required': ['stays'], 'properties': {'stays': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'entry', 'exit'], 'properties': {'exit': {'type': 'string', 'format': 'date'}, 'entry': {'type': 'string', 'format': 'date'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}}, 'additionalProperties': False}, 'minItems': 1}, 'referenceDate': {'type': 'string', 'format': 'date', 'description': "Optional 'as of' date. Defaults to today (UTC)."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'countries': {'type': 'array', 'items': {'type': 'object', 'properties': {'country': {'type': 'string'}, 'rule183': {'type': 'object', 'properties': {'remaining': {'type': 'number'}, 'triggered': {'type': 'boolean'}}}, 'daysThisYear': {'type': 'number'}}}}}}

check_schengen

Check a Schengen 90/180-day visa itinerary

Validate a set of trips against the Schengen Area rule: a non-EU visitor may be present at most 90 days within any rolling 180-day window. Entry and exit days both count as days of presence; overlapping trips are de-duplicated. Returns days used in the current window, days remaining, an overall compliance flag, and the exact first overstay date (if any).

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'trips': [{'exit': '2025-03-01', 'entry': '2025-01-01'}]}], 'required': ['trips'], 'properties': {'trips': {'type': 'array', 'items': {'type': 'object', 'required': ['entry', 'exit'], 'properties': {'exit': {'type': 'string', 'format': 'date', 'description': 'Exit date, ISO YYYY-MM-DD (>= entry).'}, 'entry': {'type': 'string', 'format': 'date', 'description': 'Entry date, ISO YYYY-MM-DD.'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'List of Schengen stays.'}, 'plannedEntry': {'type': 'string', 'format': 'date', 'description': 'Optional planned entry date. When set, the response adds plan: { maxStay, latestExit, fullResetDate } — the longest compliant stay starting on that date.'}, 'referenceDate': {'type': 'string', 'format': 'date', 'description': "Optional 'as of' date (ISO YYYY-MM-DD). Defaults to today (UTC)."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'daysUsed': {'type': 'number'}, 'compliant': {'type': 'boolean'}, 'windowStart': {'type': 'string'}, 'daysRemaining': {'type': 'number'}, 'referenceDate': {'type': 'string'}, 'maxDaysInWindow': {'type': 'number'}, 'firstOverstayDate': {'type': ['string', 'null']}}}

check_tax_residency_risk

Check tax-residency risk for remote work abroad

Remote Worker Tax Trap radar: evaluates how close a stay is to triggering tax residency (183-day rule with per-country variations across 43 tax jurisdictions) and estimates the tax owed on the FULL annual income if the threshold is crossed — comparing the standard resident effective rate against the country's special expat/nomad regime (Spain's Beckham Law 24%, Portugal's IFICI 20%, Italy's impatriati, territorial/remittance systems, …). Optionally computes leave-by/residency dates from an arrival date and warns where the Schengen 90/180 tourist limit bites first. Early-warning estimates — not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'days': 120, 'income': 80000, 'country': 'ES'}], 'required': ['country', 'days', 'income'], 'properties': {'days': {'type': 'number', 'maximum': 366, 'minimum': 0, 'description': 'Days of presence in the relevant counting period.'}, 'income': {'type': 'number', 'minimum': 0, 'description': 'Gross annual income (USD) the residency cliff would expose.'}, 'arrival': {'type': 'string', 'format': 'date', 'description': 'Optional arrival date — adds leaveBy and residencyDate to the response.'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (case-insensitive).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'risk': {'enum': ['safe', 'warning', 'triggered'], 'type': 'string'}, 'dates': {'type': 'object', 'properties': {'leaveBy': {'type': 'string'}, 'residencyDate': {'type': 'string'}}}, 'projection': {'type': 'object', 'properties': {'regime': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'note': {'type': 'string'}, 'taxUsd': {'type': 'number'}, 'savingUsd': {'type': 'number'}}}, 'cheapest': {'type': 'string'}, 'standard': {'type': 'object', 'properties': {'taxUsd': {'type': 'number'}, 'effectiveRate': {'type': 'number'}}}}}, 'daysRemaining': {'type': 'number'}, 'thresholdDays': {'type': 'number'}, 'pctOfThreshold': {'type': 'number'}, 'schengenWarning': {'type': 'string'}}}

check_travel_residency

Unified Schengen + tax-residency + tax-cost tracker

The comprehensive engine: from one travel itinerary it returns (1) Schengen 90/180 tourist-visa status (days used/remaining, first overstay, longest compliant stay), (2) per-country tax-residency risk on each country's OWN threshold and basis — the 183-day rule, Cyprus's conditional 60-day rule (flagged only when you're not 183+ resident elsewhere), the US Substantial Presence Test and the UK tax-year test — with safe days left, leave-by dates and a safe/warning/triggered rating, and (3) with an optional income, the tax cost of triggering residency at the standard rate vs an expat regime. Supersedes check_schengen / check_residency / check_tax_residency_risk (all still available). Early-warning day math — not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'stays': [{'exit': '2026-07-28', 'entry': '2026-01-10', 'country': 'ES'}], 'income': 120000}], 'required': ['stays'], 'properties': {'stays': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'entry', 'exit'], 'properties': {'exit': {'type': 'string', 'format': 'date'}, 'entry': {'type': 'string', 'format': 'date'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}}, 'additionalProperties': False}, 'minItems': 1}, 'income': {'type': 'number', 'description': 'Optional gross annual income (USD) — enables the tax-cost projection for at-risk countries.'}, 'referenceDate': {'type': 'string', 'format': 'date', 'description': "Optional 'as of' date. Defaults to today (UTC)."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'summary': {'type': 'object', 'properties': {'worstRisk': {'type': 'string'}, 'triggeredCount': {'type': 'number'}, 'schengenBreached': {'type': 'boolean'}}}, 'schengen': {'type': ['object', 'null'], 'description': '90/180 status when any Schengen stay exists: daysUsed, daysRemaining, compliant, firstOverstayDate, maxStayFromRef.'}, 'countries': {'type': 'array', 'items': {'type': 'object', 'properties': {'risk': {'enum': ['safe', 'warning', 'triggered'], 'type': 'string'}, 'country': {'type': 'string'}, 'daysUsed': {'type': 'number'}, 'secondary': {'type': 'object', 'description': 'Conditional lower rule (e.g. Cyprus-60) with conditionMet/triggered.'}, 'ukTaxYear': {'type': 'object'}, 'safeDaysLeft': {'type': 'number'}, 'taxProjection': {'type': 'object', 'description': 'Standard vs regime tax cost when income was supplied.'}, 'thresholdDays': {'type': 'number'}, 'usSubstantialPresence': {'type': 'object'}}}}, 'referenceDate': {'type': 'string'}}}

compare_banking_access

Banking access by country (Findex)

Whether adults there can bank: the share of adults (15+) with an account at a bank, another financial institution or a mobile-money provider, from the World Bank's Global Findex — a triennial household survey, so the survey year travels with each figure — plus personal remittances received as a share of GDP. Given `countries` (two or more), side by side; without, the 41-country spine ranked by `metric` (`account` or `remittancesReceived`). Account ownership says whether adults CAN bank, not whether a newcomer can open an account — that depends on residency and documentation rules this tool does not cover. A missing figure is absent and dropped from rankings, never 0.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'GB,NG,IN'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['account', 'remittancesReceived'], 'type': 'string', 'default': 'account', 'description': 'Ranking metric. Ignored when `countries` is given.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,NG,IN"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_business_entry

Days and cost to register a company, and the new-company rate, by country

How long and how much it takes to register a limited company: World Bank B-READY's calendar days and cost to complete company entry for a domestic and a foreign-owned company (cost in local currency with a USD conversion at the site's FX snapshot), whether paid-in minimum capital is required, whether sectors are closed to full private ownership, whether a national-employee quota applies, and whether registration is online with an e-signature, fees payable online and a unique business id assigned — plus the World Bank Entrepreneurship Database's new limited-liability companies per 1,000 working-age adults. B-READY is a rotating cohort: 22 of the 41 spine countries are in the 2025 edition, and a country outside it answers with the new-company rate alone and a caveat naming the gap; a country with neither is NO_DATA. `country` for one, `countries` to compare, neither ranks by `metric` (daysDomestic default; costDomesticUsd, daysForeign, costForeignUsd, density). Published rates and facts on the dates shown, for information only — not tax, legal or immigration advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'PT'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'description': 'Default lowest for days and cost, highest for density.'}, 'limit': {'type': 'number', 'minimum': 1}, 'metric': {'enum': ['daysDomestic', 'costDomesticUsd', 'daysForeign', 'costForeignUsd', 'density'], 'type': 'string', 'default': 'daysDomestic'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'entry': {'type': 'object'}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'activity': {'type': 'object'}, 'attribution': {'type': 'object'}}}

compare_childcare_cost

Net childcare cost for a couple and a single parent, by country

What full-time centre-based childcare costs a family after benefits and tax, from OECD's tax-benefit model (two children aged 2 and 3, no social assistance or rent supplement): a couple both earning 100% of the average wage and a single parent earning 67%, each as a share of household disposable income, of the average wage, and in local currency per year. OECD members only — 22 of the 41 spine countries at the vintage floor; the rest return NO_DATA naming the gap, never a modelled figure. `country` for one, `countries` to compare, neither ranks by `household` (couple default; singleParent) and `unit` (pctDisposableIncome default; pctAverageWage), cheapest first unless `sort=highest`. Published cost figures, for information only; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'GB'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'unit': {'enum': ['pctDisposableIncome', 'pctAverageWage'], 'type': 'string', 'default': 'pctDisposableIncome'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}, 'household': {'enum': ['couple', 'singleParent'], 'type': 'string', 'default': 'couple'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'year': {'type': 'number'}, 'couple': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}, 'singleParent': {'type': 'object'}}}

compare_climate

Compare climate normals and comfortable days

Monthly climate normals from ERA5 reanalysis (2015-2024) via Open-Meteo: mean daily maximum and minimum temperature, average monthly rainfall, and a count of comfortable days. Pass `city` (slug) or `country` (alpha-2) for one place's twelve months — a country answers through a named representative city, because a country does not have one climate. Otherwise cities are ranked by comfortable days, for a single `month` (1-12) or across the year; the seasonal question is the one people actually have, and an annual total hides it. A comfortable day has a maximum between 18 and 27 C with under 1 mm of rain — a STATED PREFERENCE, not an objective measure: it is temperate-biased and scores hot destinations low on terms they did not agree to, so mean maximum and rainfall travel with every row for callers who want to rank on those instead. ERA5 is reanalysis rather than station observation, which makes it complete and comparable across countries.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'limit': 15, 'month': 1}], 'properties': {'city': {'type': 'string', 'description': 'City slug (e.g. "lisbon"). Returns that city\'s twelve months.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many cities.'}, 'month': {'type': 'number', 'maximum': 12, 'minimum': 1, 'description': 'Rank a single month. Omit to rank on the whole year.'}, 'country': {'type': 'string', 'description': "ISO alpha-2. Returns the representative city's months, naming which city."}, 'minComfortDays': {'type': 'number', 'minimum': 0, 'description': 'Filter: minimum comfortable days in the ranked window.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'city': {'type': 'object'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'month': {'type': ['number', 'null']}, 'updated': {'type': 'string'}}}

compare_connectivity

Compare measured internet quality by country

Measured connection quality per country from Cloudflare Radar: median download and upload (Mbps), median idle latency and jitter (ms), and a call-quality verdict derived from latency and jitter rather than bandwidth — a video call fails on latency and jitter long before it fails on throughput, which is why a download figure alone cannot answer “can I work from here”. Aggregated from real connections over a 28-day window, not crowdsourced or self-reported. Coverage is wider than the site's country pages (~200 locations), so this answers for places with no page here. A country Radar has too little data for is absent, never zero.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'sort': 'latency', 'maxLatency': 100}], 'properties': {'sort': {'enum': ['download', 'upload', 'latency', 'jitter'], 'type': 'string', 'default': 'download', 'description': 'Metric to rank by. Bandwidth sorts high-to-low; latency and jitter sort low-to-high, because “better” runs in opposite directions.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'maxLatency': {'type': 'number', 'minimum': 0, 'description': 'Filter: maximum median idle latency, ms (e.g. 100).'}, 'minDownload': {'type': 'number', 'minimum': 0, 'description': 'Filter: minimum median download, Mbps (e.g. 50).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'country': {'type': 'string'}, 'quality': {'enum': ['excellent', 'good', 'usable', 'poor', 'unknown'], 'type': 'string'}, 'jitterMs': {'type': 'number'}, 'latencyMs': {'type': 'number'}, 'uploadMbps': {'type': 'number'}, 'downloadMbps': {'type': 'number'}}}}, 'sort': {'type': 'string'}, 'updated': {'type': 'string'}}}

compare_contract

Compare contractor vs employee net take-home

Compute gross-to-net parity between a self-employed contractor hourly rate and an employee (W2/EOR) hourly rate, accounting for self-employment/income tax and self-paid health insurance, and return the break-even contractor rate. Uses transparent effective-rate tax presets per country, all overridable. Estimates only — not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'US', 'employeeRate': 70, 'contractorRate': 100}], 'required': ['contractorRate', 'employeeRate'], 'properties': {'hours': {'type': 'number', 'description': 'Hours per week (default 40).'}, 'ctRate': {'type': 'number', 'description': 'Override contractor effective tax rate, percent (e.g. 32).'}, 'health': {'type': 'number', 'description': 'Annual self-paid health insurance (USD); defaults to the country preset.'}, 'country': {'enum': ['US', 'GB', 'DE', 'FR', 'ES', 'NL', 'PT', 'EE', 'CA', 'AU', 'IN', 'AE', 'IT', 'GR', 'IE', 'DK', 'SE', 'NO', 'CH', 'CZ', 'PL', 'HU', 'TR', 'JP', 'KR', 'CN', 'SG', 'MY', 'TH', 'VN', 'ID', 'PH', 'NZ', 'SA', 'EG', 'ZA', 'NG', 'MX', 'BR', 'AR', 'CL', 'CO'], 'type': 'string', 'default': 'US', 'description': 'Country code for tax presets.'}, 'empRate': {'type': 'number', 'description': 'Override employee effective tax rate, percent (e.g. 24).'}, 'taxMode': {'enum': ['flat', 'brackets'], 'type': 'string', 'description': "'brackets' uses progressive 2025 schedules (US and GB only; falls back to flat elsewhere — response echoes the mode)."}, 'expenses': {'type': 'number', 'description': 'Annual business expenses (USD, default 0).'}, 'employeeRate': {'type': 'number', 'minimum': 0, 'description': 'Employee/W2/EOR hourly rate (USD).'}, 'employeeWeeks': {'type': 'number', 'description': 'Employee paid weeks (default 52).'}, 'contractorRate': {'type': 'number', 'minimum': 0, 'description': 'Self-employed hourly rate (USD).'}, 'contractorWeeks': {'type': 'number', 'description': 'Contractor paid/billable weeks (default 48).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'employee': {'type': 'object', 'properties': {'net': {'type': 'number'}, 'tax': {'type': 'number'}, 'gross': {'type': 'number'}}}, 'contractor': {'type': 'object', 'properties': {'net': {'type': 'number'}, 'tax': {'type': 'number'}, 'gross': {'type': 'number'}}}, 'breakevenRate': {'type': 'number'}, 'netDifference': {'type': 'number'}, 'contractorProfitable': {'type': 'boolean'}}}

compare_countries

Compare two countries' cost of living

Side-by-side comparison of two countries: US-relative price levels across every dataset (World Bank, IMF, OECD, Penn World Table, consumption basket), the consensus ratio, percent difference, and $100k salary equivalence in both directions.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'a': 'DE', 'b': 'TH'}], 'required': ['a', 'b'], 'properties': {'a': {'type': 'string', 'description': 'First ISO 3166-1 alpha-2 country code (case-insensitive).'}, 'b': {'type': 'string', 'description': 'Second ISO 3166-1 alpha-2 country code (must differ from a).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'ratioAtoB': {'type': 'number'}, 'salary100k': {'type': 'object', 'properties': {'aToB': {'type': 'number'}, 'bToA': {'type': 'number'}}}, 'pctDifference': {'type': 'number'}}}

compare_country_risk

Compare country risk (INFORM, EC JRC)

INFORM Risk from the European Commission's Joint Research Centre: a 0-10 composite where HIGHER IS WORSE, plus the three dimensions behind it — hazard (exposure to earthquakes, floods, cyclones, drought, conflict), vulnerability (how exposed the population is) and copingCapacity (whether institutions and infrastructure could respond). The last is usually the one that matters when choosing where to live: two countries can face the same earthquake and have completely different outcomes. Safest-first by default. Covers 191 countries, far wider than this site's country pages. A country INFORM does not score is ABSENT, never zero — zero is the safest possible value and would rank an unassessed country first. Deliberately not folded into any other ranking here: risk flags, it never silently reweights a cost or livability score.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'limit': 20, 'maxRisk': 3}], 'properties': {'sort': {'enum': ['risk', 'hazard', 'vulnerability', 'copingCapacity'], 'type': 'string', 'default': 'risk', 'description': 'Dimension to sort by. maxRisk always filters on the composite.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'country': {'type': 'string', 'description': "ISO alpha-2 for a single country's scores."}, 'maxRisk': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Keep only countries at or below this composite score.'}, 'descending': {'type': 'boolean', 'default': False, 'description': 'True lists the most dangerous first.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'entry': {'type': 'object'}, 'release': {'type': 'string'}, 'updated': {'type': 'string'}}}

compare_effective_tax

Effective corporate tax rate beside the statutory rate, by country

What a company's investment is actually taxed at: OECD's forward-looking effective average tax rate (EATR), effective marginal rate (EMTR) and cost of capital for a composite investment under fixed interest and inflation, beside the statutory combined corporate rate from the Rules hub, with the gap in points — what allowances and incentives are worth. `country` for one, `countries` for a side-by-side, neither ranks by `metric` (eatr default; emtr, costOfCapital, gap), lowest first unless `sort=highest`. 39 of the 41 spine countries are modelled; the Philippines and the UAE keep their statutory rate with a caveat and never a borrowed effective rate. A property of the tax system, not any company's bill. Published rates and facts on the dates shown, for information only — not tax, legal or immigration advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'DE'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['eatr', 'emtr', 'costOfCapital', 'gap'], 'type': 'string', 'default': 'eatr', 'description': 'Ranking metric when neither `country` nor `countries` is given.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'gapPct': {'type': 'number'}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'effective': {'type': 'object'}, 'attribution': {'type': 'object'}, 'statutoryCombinedPct': {'type': 'number'}}}

compare_egov

UN E-Government Development Index and its components, by country

How much of government can be done online: the UN E-Government Development Index (0–1) and its three components — Online Service Index, Telecommunication Infrastructure Index, Human Capital Index — for all 41 spine countries, read from the UN E-Government Knowledgebase's country pages because no data file is published. The index measures what government provides online and the infrastructure and skills to use it, not whether a newcomer can use it (most services need a national id or residence first). The survey is biennial and the caveat names its year. `country`, `countries`, or a ranking by `index` (egdi default; osi, tii, hci), highest first unless `sort=lowest`. Published figures, for information only; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'KR'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'highest'}, 'index': {'enum': ['egdi', 'osi', 'tii', 'hci'], 'type': 'string', 'default': 'egdi'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'hci': {'type': 'number'}, 'osi': {'type': 'number'}, 'tii': {'type': 'number'}, 'egdi': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'year': {'type': 'number'}, 'index': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_food_cost

Measured cost of a healthy diet, by country, and how far modelled grocery prices are from it

What eating a healthy diet costs per person per day, MEASURED: the World Bank's Food Prices for Nutrition series (the cheapest locally available foods that meet a healthy-diet standard, from International Comparison Program retail prices), 165 of the 186 spine countries. Returns the cost in local currency (dailyLocal) and USD (dailyUsd, monthlyUsd), the share of people who cannot afford it (unaffordable.pct, on its own year), the diet's split across six food groups as percentage shares for the single year published, and how this site's MODELLED grocery prices compare: vsUsMeasured and vsUsModelled are each a multiple of the US, and modelError = modelled ÷ measured (below 1, the model understates food there). A ranking also returns modelErrorSummary for the whole site. Where the local figure does not convert consistently at the site's exchange rate (a parallel market, a recent devaluation, a currency change) the dollar figure and the comparison are withheld and a caveat says why; a country with no survey is NO_DATA, never zero. It is a least-cost diet, not what a typical or expat household spends, and it feeds no total. `country` for one, `countries` to compare, neither ranks by `metric` (dailyUsd default, or unaffordablePct), cheapest first unless `sort=highest`. Published cost figures, for information only; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'TH'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Maximum rows in a ranking.'}, 'metric': {'enum': ['dailyUsd', 'unaffordablePct'], 'type': 'string', 'default': 'dailyUsd'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'dailyUsd': {'type': 'number'}, 'excluded': {'type': 'array'}, 'dailyLocal': {'type': 'number'}, 'modelError': {'type': 'number'}, 'attribution': {'type': 'object'}, 'modelErrorSummary': {'type': 'object'}}}

compare_health_capacity

Doctors, nurses and hospital beds per 10,000, by country

How much health system there is per person: medical doctors and nursing and midwifery personnel per 10,000 (WHO Global Health Observatory) and hospital beds per 10,000 (WHO, or OECD where newer — the row names its source), beside the UHC service-coverage index. Density is not access: it says how much exists, not whether a visitor can use it or what it costs. Newest observation at the site's vintage floor; 36 of the 41 spine countries carry doctors and nurses, 31 beds; an older figure is absent, never served as current. `country` for one, `countries` to compare, neither ranks by `metric` (doctors default; nurses, beds), highest first unless `sort=lowest`. Published figures, for information only; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'DE'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'highest'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['doctors', 'nurses', 'beds'], 'type': 'string', 'default': 'doctors'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'uhcIndex': {'type': 'number'}, 'bedsPer10k': {'type': 'object'}, 'attribution': {'type': 'object'}, 'nursesPer10k': {'type': 'object'}, 'doctorsPer10k': {'type': 'object'}}}

compare_healthcare

Compare Healthcare Costs & Exposure

Healthcare cost and financial exposure across 41 countries: out-of-pocket spend per person per year (US$), out-of-pocket as a share of all health spending, total health spend per capita (PPP international $), government funding share, physicians per 1,000 and dentists per 10,000. Figures are MEASURED from World Bank and WHO Global Health Observatory series, never derived from a price index: scaling healthcare by a country's general price level overstates costs abroad by 1.2x-5.4x, because health prices do not track the price level (the US is an outlier and several countries deliberately price healthcare below their own economies). Share and burden are separate facts and both are returned - the US pays only ~11% out of pocket, a low share, but the highest absolute amount. Dental is reported as ACCESS (dentist density), not price: no free citable source publishes procedure prices. National averages, not a quote for any individual's care. Not medical, insurance or financial advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'sort': 'outOfPocket', 'country': 'TH'}], 'required': [], 'properties': {'sort': {'enum': ['outOfPocket', 'spend', 'exposure', 'doctors', 'dentists'], 'type': 'string', 'default': 'outOfPocket', 'description': "Metric to rank by. 'outOfPocket' = out-of-pocket spend per person per year (default, the figure a person actually pays); 'spend' = total health spend per capita; 'exposure' = out-of-pocket as a share of health spending; 'doctors' = physicians per 1,000 (ranked best-first); 'dentists' = dentists per 10,000 (best-first)."}, 'country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 country code (case-insensitive). Echoes that country's row and its rank under the active sort."}, 'maxOutOfPocketPct': {'type': 'number', 'minimum': 0, 'description': 'Optional filter: keep only countries where households pay at most this percentage of health spending directly.'}, 'minPhysiciansPer1000': {'type': 'number', 'minimum': 0, 'description': 'Optional filter: keep only countries with at least this many physicians per 1,000 people.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'number'}, 'vsUs': {'type': 'number', 'description': 'Out-of-pocket spend relative to the US, 0-1.'}, 'entry': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'years': {'type': 'object', 'description': 'Reference year per metric; vintages differ.'}, 'country': {'type': 'string'}, 'metrics': {'type': 'object', 'properties': {'outOfPocketPct': {'type': 'number'}, 'dentistsPer10000': {'type': 'number'}, 'physiciansPer1000': {'type': 'number'}, 'spendPerCapitaPpp': {'type': 'number'}, 'governmentSharePct': {'type': 'number'}, 'outOfPocketPerCapitaUsd': {'type': 'number'}}}}}}}, 'description': 'Countries under the active sort, best first.'}, 'focus': {'type': 'object', 'description': "The requested country's row, when `country` was given."}, 'updated': {'type': 'string', 'description': 'ISO date the underlying data was last refreshed.'}, 'excluded': {'type': 'number', 'description': 'Countries removed by filters or missing the sorted metric.'}, 'attribution': {'type': 'object', 'description': 'Sources, a quotable citation and a permalink.'}}}

compare_housing

Compare Housing Costs & Affordability

Housing cost and affordability across countries, built for remote workers. Returns monthly rent plus TWO ratios that together answer the real question: rent as a share of the LOCAL median wage (are locals priced out?) and as a share of YOUR remote income (can you afford it?). The gap between them - `arbitrageGap`, in percentage points - is the single number saying whether a place is cheap FOR YOU; pass `remoteIncome` to get it. Also returns price-to-income and price-to-rent as a percentage of each country's OWN long-run average (OECD), and mortgage rates (ECB, euro area only; absent elsewhere rather than estimated). IMPORTANT: those affordability percentages compare a country with its own history, NOT with other countries - 127 for Spain means 27% less affordable than Spain's norm, not 27% dearer than Germany. Every rent carries `rentBasis`: 'measured' where a real Eurostat city figure exists (Spain, Portugal, Switzerland only) or 'modelled' from the site's price basket, which understates housing by up to ~40% where housing has decoupled from the general price level. National averages; not financial advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'sort': 'affordability', 'remoteIncome': 6000}], 'required': [], 'properties': {'sort': {'enum': ['affordability', 'rent', 'localBurden', 'priceToIncome'], 'type': 'string', 'default': 'affordability', 'description': "'affordability' = rent as a share of your remote income, lowest first (falls back to raw rent when no income given); 'rent' = monthly rent; 'localBurden' = rent as a share of the local median wage; 'priceToIncome' = price-to-income vs long-run average."}, 'flatM2': {'type': 'number', 'minimum': 0, 'description': 'Flat size in m² used to convert measured per-m² rents. Default 70; echoed back so the assumption is visible.'}, 'country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 code; echoes that country's row and rank."}, 'remoteIncome': {'type': 'number', 'minimum': 0, 'description': 'Your monthly income in USD, earned remotely. Enables rentPctOfYourIncome and arbitrageGap; omit for the local-only view.'}, 'maxRentPctOfIncome': {'type': 'number', 'minimum': 0, 'description': 'Optional filter: keep only countries where rent is at most this percentage of your remote income. Requires remoteIncome.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'years': {'type': 'object'}, 'country': {'type': 'string'}, 'metrics': {'type': 'object', 'properties': {'mortgageRatePct': {'type': 'number'}, 'housingPriceLevelEu': {'type': 'number'}, 'priceToRentVsLongRun': {'type': 'number'}, 'priceToIncomeVsLongRun': {'type': 'number'}}}, 'rentBasis': {'enum': ['measured', 'modelled'], 'type': 'string'}, 'arbitrageGap': {'type': 'number', 'description': 'Percentage points by which rent sits lighter on you than on a local.'}, 'measuredCities': {'type': 'number'}, 'rentMonthlyUsd': {'type': 'number'}, 'rentPctOfYourIncome': {'type': 'number'}, 'rentPctOfLocalMedian': {'type': 'number'}}}}, 'focus': {'type': 'object'}, 'updated': {'type': 'string'}, 'excluded': {'type': 'number'}, 'attribution': {'type': 'object'}}}

compare_inflation

Inflation, interest and real rates by country

What money earns or loses in real terms. Given `countries` (two or more ISO alpha-2 codes), returns side by side: consumer-price inflation (World Bank, latest annual, plus the IMF's monthly year-on-year figure where available), the central-bank policy rate (BIS, newest month; the ECB's single rate for euro-area members, flagged `viaEuroArea`), deposit and lending rates (World Bank, where published), and the real rates the engine computes from them by the exact Fisher relation — only when the nominal rate and the inflation figure are within a year of each other. Without `countries`, ranks the 41-country spine by one `metric`. A country missing a metric lacks the key and is dropped from a ranking, never scored 0. Real rates are ex post (last year's inflation), not expectations; a projection at the latest rate is flat, not a forecast.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'GB,DE,TR'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['inflation', 'policyRate', 'depositRate', 'lendingRate', 'realDepositRate', 'realPolicyRate'], 'type': 'string', 'default': 'inflation', 'description': 'Ranking metric. Ignored when `countries` is given.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,DE,TR"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_occupation_pay

Measured pay by occupation (ILO), and the gender gap in each

MEASURED gross monthly earnings of employees by ISCO-08 major occupation group, from ILOSTAT — median and mean, in USD, PPP dollars and local currency, for 35 countries (a median is published for most of them). This is the site's only measured wage series; calculate_wage_bands is MODELLED, and the two are not interchangeable. Each row also carries the female-vs-male pay gap for that occupation (positive means women earn less; negative values are real and are kept) and where the occupation's median sits on the country's modelled national wage ladder. Employees only — excludes the self-employed and informal workers, which is why these diverge most from GNI-derived estimates in countries with large informal sectors. Before tax. The ten ISCO-08 major groups are broad families of work, not job titles: one group covers a surgeon and a junior developer alike. Countries with no ILO data return NO_DATA rather than a modelled substitute.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'GB', 'occupation': 'professionals'}], 'required': ['country'], 'properties': {'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (case-insensitive).'}, 'occupation': {'enum': ['total', 'armed-forces', 'managers', 'professionals', 'technicians', 'clerical', 'services-sales', 'agricultural', 'craft', 'operators', 'elementary'], 'type': 'string', 'description': 'Narrow the response to one ISCO-08 major group. Omit for the whole table.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'gapPct': {'type': 'number'}, 'meanMonthlyUsd': {'type': 'number'}, 'medianMonthlyPpp': {'type': 'number'}, 'medianMonthlyUsd': {'type': 'number'}, 'modelledPercentile': {'type': 'number'}}}}, 'year': {'type': 'number', 'description': 'ILO reference year — one year across every occupation in the country.'}, 'basis': {'type': 'string', 'description': "Always 'measured' on success."}, 'country': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}}}, 'modelRatio': {'type': 'number', 'description': 'measured / modelled for the country. Above 1: the model understates local pay.'}, 'measuredMedianMonthlyUsd': {'type': 'number'}, 'modelledMedianMonthlyUsd': {'type': 'number'}}}

compare_pension_systems

State pension systems: retirement ages, replacement rates, years in retirement, by country

What the state pension system looks like there, from OECD Pensions at a Glance (members and G20 partners, 33 of the 41 spine countries). Give `country` for one: normal retirement age now and for a 22-year-old entering today, by sex; net and gross replacement rates for a full-career average earner at 50/100/200% of the average wage under mandatory schemes; expected years after leaving work; the share of pensioners below half of median income; the average tax rate on an average pension; the old-age to working-age ratio and public pension spending; plus World Bank life expectancy and the 65+ share for all 41 — and WBL's statutory retirement age beside them, which stands alone for the eight countries OECD does not cover (no replacement rate is ever borrowed). Give `countries` (two or more) for a side-by-side, or neither for the spine ranked by `metric`. Projection rows (2060+) are excluded. A country missing a metric lacks the key and is dropped from a ranking, never scored 0. Published rules and modelled figures on the dates shown, for information only — entitlements depend on a person's record and consulates decide; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'DE'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored otherwise.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['retirementAgeMen', 'retirementAgeWomen', 'futureRetirementAgeMen', 'netReplacement100', 'grossReplacement100', 'yearsAfterExit', 'oldAgePoverty', 'lifeExpectancy', 'over65Pct'], 'type': 'string', 'default': 'netReplacement100', 'description': 'Ranking metric when neither `country` nor `countries` is given.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code for the full profile (e.g. "DE").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side. Ignored when `country` is given.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}, 'replacement': {'type': 'object'}, 'retirementAge': {'type': 'object'}, 'statutoryRetirementAge': {'type': 'object'}}}

compare_public_holidays

Shared working days and public holidays by country

Two questions in one. Given `countries` (two or more), returns the working days those places genuinely SHARE in a year — weekdays on which nobody is on a public holiday — which is the number a distributed team actually plans against and the half of the question timezone-overlap tools never answer: a London/Tokyo team loses roughly three working weeks a year to non-overlapping holidays. Without `countries`, ranks countries by nationwide public holidays. Weekend holidays are excluded (they cost nobody a working day) and regional holidays are counted separately from national ones. Covers 204 countries, but NOT India, Thailand, Malaysia, the UAE or Saudi Arabia — those return NO_DATA rather than an empty calendar, because “no data” and “no holidays” are opposite claims.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'GB,JP'}], 'properties': {'sort': {'enum': ['most', 'fewest'], 'type': 'string', 'default': 'most', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'year': {'type': 'number', 'description': 'Calendar year. Defaults to the first year in the dataset.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,JP"). Omit to get a ranking instead of an overlap.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'year': {'type': 'number'}, 'lostDays': {'type': 'number'}, 'weekdays': {'type': 'number'}, 'countries': {'type': 'array', 'items': {'type': 'object'}}, 'lostDates': {'type': 'array', 'items': {'type': 'string'}}, 'sharedWorkingDays': {'type': 'number'}}}

compare_safety_stats

Homicide rate, PM2.5 and disaster risk by country

Measured danger once there. Given `countries` (two or more ISO alpha-2 codes), returns side by side: intentional homicides per 100,000 (UNODC via World Bank WDI) and mean annual PM2.5 exposure in µg/m³ (WDI), each with its observation year, and the INFORM disaster-risk score and band composed for context. Without `countries`, ranks the 41-country spine by one `metric` (`homicide` default, `pm25`), lowest first. Only observations at or after the newest WDI vintage are held; a country whose newest figure is older lacks the key and is dropped from the ranking, never scored 0 — the UK's newest homicide observation predates the floor, so it has no homicide figure here. Homicide counts intentional killings only, not petty crime or road deaths; PM2.5 is a national population-weighted mean. Official sources on the dates shown, for information only — conditions change; check the source before travelling. Every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'DE,BR,ZA'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['homicide', 'pm25'], 'type': 'string', 'default': 'homicide', 'description': 'Ranking metric. Ignored when `countries` is given.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,BR,ZA"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_tax_burden

Hours on tax compliance, VAT refund weeks and the rate firms report paying, by country

How much work paying tax is, from World Bank B-READY's Taxation topic (firm surveys in the largest business city): median hours spent on tax compliance a year, the share of firms filing and paying electronically, weeks to a final audit report and to a VAT refund, the share citing a too-long refund process, the share of social-security taxes in labour cost, and the effective income-based rate firms REPORT paying — which is neither the statutory rate (Rules hub) nor OECD's modelled effective rate (Business hub's tax tab), and the caveat keeps the three apart. 22 of the 41 spine countries; outside the cohort is NO_DATA. `country`, `countries`, or a ranking by `metric` (complianceHours default; vatRefundWeeks, auditWeeks, reportedEffectiveRatePct), lowest first unless `sort=highest`. Published rates and facts, for information only — not tax or legal advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'PT'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['complianceHours', 'vatRefundWeeks', 'auditWeeks', 'reportedEffectiveRatePct'], 'type': 'string', 'default': 'complianceHours'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}, 'vatRefundWeeks': {'type': 'number'}, 'complianceHours': {'type': 'number'}, 'reportedEffectiveRatePct': {'type': 'number'}}}

compare_tax_rates

Statutory corporate and top income-tax rates by country

Statutory tax schedules from the OECD, compared or ranked. Given `countries` (two or more ISO alpha-2 codes), returns side by side the corporate income-tax rate (combined central plus average sub-national, central only, and a small-business rate where one exists; OECD Corporate Tax Statistics, all 41 spine countries) and, for OECD members, the top personal income-tax rate with the earnings threshold at which it starts as a multiple of the average wage, plus the marginal rate with employee social contributions at that point (OECD Tax Database, 26 of the spine). Without `countries`, ranks the spine by one `metric`. A country OECD's PIT flow does not cover has no `personal` block and is dropped from a PIT ranking, never scored 0. Rates are statutory, not effective: incentives, surtaxes and special regimes are outside the data, and this does not replace the blended take-home profiles behind `compare_contract`. Statutory figures for information only — not legal or tax advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'DE,IE,TH'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['corporateCombined', 'corporateCentral', 'smallBusiness', 'pitTop', 'pitThreshold', 'pitMarginalAtThreshold'], 'type': 'string', 'default': 'corporateCombined', 'description': 'Ranking metric. Ignored when `countries` is given.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,IE,TH"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_total_cost

Total Cost of Living vs Your Income

What a month actually costs in each of 41 countries on a stated income, and what is left over. Sums four lines that are kept from overlapping: rent (measured Eurostat city rents, HUD Fair Market Rents, or the price basket where neither covers a country), the everyday basket EXCLUDING rent (the basket normally contains rent — roughly half of it — so adding a separate housing figure to the full basket would overstate a total by ~60%), out-of-pocket healthcare, and income tax plus employee social contributions on that income. VAT is already inside the basket prices (purchasing-power data derives from surveyed purchaser prices) and is therefore never added. Tax assumes you become tax-resident and are taxed locally, single filer, no deductions; special regimes such as Portugal's IFICI are reported separately where they would be cheaper. Estimates for comparison — not a quote and not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'sort': 'remaining', 'income': 6000}], 'required': ['income'], 'properties': {'sort': {'enum': ['total', 'remaining', 'rent', 'tax', 'share'], 'type': 'string', 'default': 'total', 'description': "Ranking. 'remaining' = most left over first; 'share' = smallest share of your income."}, 'income': {'type': 'number', 'description': 'Monthly income in USD. Required — the tool is a subtraction.'}, 'country': {'type': 'string', 'description': "ISO 3166-1 alpha-2; echoes that country's row and rank as `focus`."}, 'maxPctOfIncome': {'type': 'number', 'description': 'Keep only countries whose total is at or below this share of income (%).'}}}

compare_trade_customs

Days to clear customs and cost to comply with trade rules, by country

How long goods take to clear the border and what compliance costs, from World Bank B-READY's International Trade topic (firm-survey averages in the largest business city): days for exported and imported goods to clear all border agencies, the typical cost of complying with export and import requirements as a share of goods value, and the share of firms exporting by parcel. B-READY is a rotating cohort — 22 of the 41 spine countries in the 2025 edition — and a country outside it is NO_DATA, never a borrowed figure. `country`, `countries`, or a ranking by `metric` (importDays default; exportDays, importCostPct, exportCostPct), lowest first unless `sort=highest`. Published rates and facts, for information only — not tax, legal or customs advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'PT'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['importDays', 'exportDays', 'importCostPct', 'exportCostPct'], 'type': 'string', 'default': 'importDays'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'exportDays': {'type': 'number'}, 'importDays': {'type': 'number'}, 'attribution': {'type': 'object'}, 'exportCostPct': {'type': 'number'}, 'importCostPct': {'type': 'number'}}}

compare_vat

VAT and GST rates by country, with the authority page each was read from

Standard and reduced VAT/GST rates for the 41-country spine, hand-curated from each national tax authority's published page and served with that page's URL and the date it was checked, so a figure can be verified rather than trusted. Given `countries` (two or more ISO alpha-2 codes), returns each country's tax kind and name, standard rate, reduced rates where the authority lists them, registration threshold where known, and its source; an entry read from a secondary source because the authority's page could not be fetched is marked `confidence: "secondary"`. Without `countries`, ranks standard rates lowest first. Countries with no single national rate — the US (state sales taxes), Brazil (state and federal taxes in transition to a dual VAT) and Malaysia (sales and service tax) — are described by `kind`, excluded from the ranking and named in `excluded`, never given 0%. Reviewed at least yearly; not a live feed. Statutory figures for information only — not legal or tax advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'GB,US,DE'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'lowest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,US,DE"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'excluded': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

compare_working_time

Working hours and paid parental leave, by country

Two questions in one. Given `countries` (two or more ISO alpha-2 codes), returns side by side: mean weekly hours actually worked per employed person (ILOSTAT, newest year from 2023), average annual hours actually worked (OECD, members only), and the paid leave the law gives mothers and fathers in calendar days with who pays (World Bank Women, Business and the Law 2026). Without `countries`, ranks the 41-country spine by one `metric` — weeklyHours, annualHours, maternityDays or paternityDays; `sort=fewest` inverts. A country missing a metric lacks the key, and is dropped from a ranking rather than scored zero. OECD's annual-hours series is NOT comparable across countries, by OECD's own statement — the wording travels with every response that carries the figure. Weekly hours average full- and part-time workers together. Leave is what the law provides, not take-up; a legal score below 1 marks a partial provision. Statutory minimum ANNUAL leave is deliberately absent: no citable structured source exists.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'countries': 'DE,US,TH'}], 'properties': {'sort': {'enum': ['most', 'fewest'], 'type': 'string', 'default': 'most', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['weeklyHours', 'annualHours', 'maternityDays', 'paternityDays'], 'type': 'string', 'default': 'weeklyHours', 'description': 'Ranking metric. Ignored when `countries` is given.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,US,TH"). Omit to get a ranking instead.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'metric': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

country_dossier

One country, every hub: the headline figures

The three to six headline figures each hub owns for one country, in one call: price level vs the US and datasets covering it (compare); monthly essentials, health out-of-pocket spending and — with `income` — what is left after costs (costs); modelled median and minimum wage, ILOSTAT measured median, pension replacement rate (earn); safety and healthcare-access scores, rule of law, disaster risk, comfortable days, tax-residency threshold, passport rank, nomad-visa programmes (move); public holidays, latency and download speed, employer contribution loading, weekly hours, paid maternity leave (work); inflation, policy rate, banked adults, remittance corridors surveyed (money); combined corporate tax rate, top income-tax rate and where it starts, standard VAT rate (absent for the US — state sales taxes are not a 0% VAT), the Women, Business and the Law index and retirement ages for men and women (rules); FCDO and US State Department advice levels, the yellow-fever certificate position, homicide rate and PM2.5 exposure with their years (safety); retirement ages for men and women (OECD, else WBL), the net replacement rate, life expectancy and the kind of retiree visa (retire). Effective average corporate tax rate, standard withholding on dividends, days to register a company (absent outside the B-READY cohort) and the kind of founder visa (business). Since 5 Sep 2026 the sections also carry doctors per 10,000 (safety), the couple's net childcare cost as a share of income (costs), days for imports to clear customs and hours on tax compliance (business), the E-Government index (work), and the foreign-ownership band for property and the kind of student visa (move) — each absent where its source does not cover the country. Every figure carries the id of the source that produced it, `tools` names the MCP tool to call for detail per section, and `sources` lists only what was actually included. A section or figure the site has no data for is ABSENT, never null — Thailand has no OECD employer rate and no holiday calendar, so its `work` section lacks those keys. About 5-8 KB. Built for agents that would otherwise call a dozen tools to answer "tell me about moving to Portugal". From 13 Sep 2026 `rules` also carries `minAnnualLeaveDays` and `noticeEmployerMinWeeks` (tool `employment_rules`) and `safety` carries `drivesOn` and `bacLimitPct` (tool `driving_rules`), each absent where the register sets none.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'income': 5000, 'country': 'PT'}], 'required': ['country'], 'properties': {'income': {'type': 'number', 'minimum': 1, 'description': 'Gross monthly income in USD. Optional; unlocks the total-cost figures.'}, 'country': {'type': 'string', 'description': 'ISO alpha-2 code (e.g. "PT").'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'tools': {'type': 'object'}, 'country': {'type': 'object'}, 'sources': {'type': 'array', 'items': {'type': 'object'}}, 'updated': {'type': 'string'}, 'sections': {'type': 'object'}, 'attribution': {'type': 'object'}}}

driving_rules

Road rules before you drive — side, speed limits, alcohol limit, equipment, IDP

What a visitor needs before driving in each of the 41 spine countries: which side of the road, the national default urban, rural and motorway speed limits in the unit signed there (`speedUnit` km/h or mph, never converted), the blood-alcohol limit for ordinary drivers in g/100 ml (`bacNote` for novice and professional limits; 0 is a real zero-tolerance rule), equipment the law requires carried from a fixed vocabulary, and whether an International Driving Permit is needed (`idpRequired`, from GOV.UK's per-country table for a UK photocard licence; absent where that table is silent) — a hand-curated register with the authority's page and check date per row, added 13 Sep 2026; secondary-sourced entries are marked `confidence: "secondary"`. A limit not set nationally is ABSENT, never zero (Germany's motorways, US and Canadian limits). `country` for one entry, `countries` for a side-by-side; without either, ranks by `metric` (`speedMotorway` default, `speedUrban`, `speedRural`, `bacLimitPct`), highest first unless `sort=lowest`, optionally filtered by `drivesOn` and `idpRequired`; mph limits are ordered by their km/h equivalent for the sort only. For information only; conditions change — every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'FR'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'description': 'Highest first (default) or lowest first.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['speedMotorway', 'speedUrban', 'speedRural', 'bacLimitPct'], 'type': 'string', 'description': 'Ranking metric when neither country nor countries is given.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'drivesOn': {'enum': ['left', 'right'], 'type': 'string', 'description': 'Restrict the ranking to one side of the road.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}, 'idpRequired': {'enum': ['true', 'false'], 'type': 'string', 'description': 'Restrict the ranking by whether an International Driving Permit is needed.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'source': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'drivesOn': {'type': 'string'}, 'excluded': {'type': 'array', 'items': {'type': 'string'}}, 'checkedOn': {'type': 'string'}, 'speedUnit': {'type': 'string'}, 'speedRural': {'type': 'number'}, 'speedUrban': {'type': 'number'}, 'attribution': {'type': 'object'}, 'bacLimitPct': {'type': 'number'}, 'idpRequired': {'type': 'boolean'}, 'speedMotorway': {'type': 'number'}, 'requiredEquipment': {'type': 'array', 'items': {'type': 'string'}}}}

employment_rules

Statutory employment floors — annual leave, notice, probation, weekly hours

The minimums a job's law sets in each of the 41 spine countries: paid annual leave in days with its `basis` (`working` or `calendar`, never converted), the minimum notice an employer and an employee must give in weeks (`noticeNote` where it rises with tenure), the probation ceiling in months and the ordinary weekly-hours ceiling — a hand-curated register with the labour authority's page and check date per row, added 13 Sep 2026; an entry read from secondary reporting because the official page could not be fetched is marked `confidence: "secondary"`. A fact the law does not set is ABSENT, never zero (the US sets no paid leave, notice or hours ceiling); federal countries carry the federal floor. `country` for one entry, `countries` for a side-by-side; without either, ranks by `metric` (`minAnnualLeaveDays` default, `noticeEmployerMinWeeks`, `probationMaxMonths`, `maxWeeklyHours`), most first unless `sort=fewest`, with the countries that set no figure in `excluded`. Statutory floors only — contracts and collective agreements usually give more. For information only — not legal advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'DE'}], 'properties': {'sort': {'enum': ['most', 'fewest'], 'type': 'string', 'description': 'Most first (default) or fewest first.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'metric': {'enum': ['minAnnualLeaveDays', 'noticeEmployerMinWeeks', 'probationMaxMonths', 'maxWeeklyHours'], 'type': 'string', 'description': 'Ranking metric when neither country nor countries is given.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'basis': {'type': 'string'}, 'source': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'excluded': {'type': 'array', 'items': {'type': 'string'}}, 'checkedOn': {'type': 'string'}, 'attribution': {'type': 'object'}, 'maxWeeklyHours': {'type': 'number'}, 'minAnnualLeaveDays': {'type': 'number'}, 'probationMaxMonths': {'type': 'number'}, 'noticeEmployeeMinWeeks': {'type': 'number'}, 'noticeEmployerMinWeeks': {'type': 'number'}}}

estimate_employer_cost

Employer cost of a hire, by country

What a hire actually costs the employer: the gross wage plus the employer's own social security contributions at the rate OECD Taxing Wages publishes (single earner, no children, 100% of the average wage), applied as a flat rate — the figure employer-of-record services quote for a fee. Pass `gross` (annual USD) for your own figure; without it the wage is the pay-range midpoint for the `occupation` and `seniority`, and `basis` says whether that wage is measured (ILOSTAT) or modelled. Employee-side rates and OECD's tax wedge are returned for context and never applied. Without `country`, ranks the spine by employer contribution rate. Coverage is the 25 spine countries OECD measures; the other sixteen return NO_DATA, never a 0% rate (New Zealand's 0% is real: it has no employer contributions). Every response carries caveats — contribution ceilings, excluded schemes — and it is not payroll or legal advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'gross': 60000, 'country': 'DE'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored when `country` is given.'}, 'gross': {'type': 'number', 'minimum': 1, 'description': 'Gross annual wage in USD. When omitted, the pay-range midpoint is used.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'country': {'type': 'string', 'description': 'ISO alpha-2 code (e.g. "DE"). Omit for a ranking.'}, 'seniority': {'enum': ['entry', 'mid', 'senior', 'lead'], 'type': 'string', 'description': 'Seniority for the default wage (default `mid`). Ignored when `gross` is given.'}, 'occupation': {'type': 'string', 'description': 'ISCO-08 major group id for the default wage (default `total`). Ignored when `gross` is given.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'oecd': {'type': 'object'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'wage': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'country': {'type': 'object'}, 'employee': {'type': 'object'}, 'employer': {'type': 'object'}, 'taxWedge': {'type': 'number'}, 'attribution': {'type': 'object'}}}

estimate_micro_costs

Estimate everyday prices in two countries (Pint & Property Index)

Estimates local prices for a 32-item everyday basket (rent, pint of beer, groceries, transport, gym, …) in two countries, derived as usPrice × pppIndex^elasticity — non-tradables like rent swing harder across borders than world-priced goods like petrol (Balassa-Samuelson-style model). Returns per-item prices in USD and local currency, category subtotals, and a single-person monthly budget rollup. Model estimates, not price quotes.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'base': 'GB', 'target': 'TH'}], 'required': ['base', 'target'], 'properties': {'base': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code to compare FROM (case-insensitive).'}, 'source': {'enum': ['consensus', 'worldbank', 'imf', 'oecd', 'pwt', 'worldbank-cons', 'bigmac', 'factbook'], 'type': 'string', 'description': 'Optional dataset override. Defaults to the consumption basket (worldbank-cons) when it covers both countries, else consensus; the response echoes the source used.'}, 'target': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code to compare TO (must differ from base).'}, 'baseCity': {'type': 'string', 'description': "Optional city slug for the base side (sub-national cost adjustment, e.g. 'london'). Enables intra-country city comparisons like London vs Hull."}, 'targetCity': {'type': 'string', 'description': "Optional city slug for the target side (e.g. 'hull')."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'base': {'type': 'object', 'properties': {'usd': {'type': 'number'}}}, 'item': {'type': 'object'}, 'target': {'type': 'object', 'properties': {'usd': {'type': 'number'}}}, 'pctDiff': {'type': 'number'}}}}, 'source': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'auto': {'type': 'boolean'}}}, 'monthlyBudget': {'type': 'object', 'properties': {'base': {'type': 'number'}, 'target': {'type': 'number'}, 'pctDiff': {'type': 'number'}}}, 'categoryTotals': {'type': 'array', 'items': {'type': 'object'}}}}

find_country_fit

Which country fits me — ranked by your own weights

Ranks countries by a fit score that blends the livability composite (internet speed, safety, healthcare access, air quality, English — measured, each with its own source year) with how far a monthly budget in USD goes against modelled essentials, using 0–10 weights per dimension (`cost`, `internet`, `safety`, `healthcare`, `air`, `english`; default 5 each). Region, budget and visa are FILTERS, never weights: `region` (a World Bank region name), `withinBudget` (default true; false keeps countries the budget does not cover), `needsVisa` (an eligible digital nomad visa on the budget). Each row carries the fit, quality and cost scores, modelled essentials, budget ratio and the nomad visa matched. A ranking of published figures against the weights given, not a recommendation; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'cost': 6, 'budget': 2500, 'safety': 9, 'healthcare': 8}], 'properties': {'air': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for air (default 5).'}, 'cost': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for cost (default 5).'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Maximum rows (default 10).'}, 'budget': {'type': 'number', 'default': 3000, 'minimum': 1, 'description': 'Monthly budget in USD.'}, 'region': {'enum': ['East Asia & Pacific', 'Europe & Central Asia', 'Latin America & Caribbean', 'Middle East, North Africa, Afghanistan & Pakistan', 'North America', 'South Asia', 'Sub-Saharan Africa'], 'type': 'string', 'description': 'Keep only countries in this World Bank region.'}, 'safety': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for safety (default 5).'}, 'english': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for english (default 5).'}, 'internet': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for internet (default 5).'}, 'needsVisa': {'type': 'boolean', 'description': 'Keep only countries with a digital nomad visa the budget meets.'}, 'healthcare': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Weight 0–10 for healthcare (default 5).'}, 'withinBudget': {'type': 'boolean', 'default': True, 'description': 'Keep only countries whose modelled essentials fit inside the budget.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'inputs': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'excluded': {'type': 'object'}, 'attribution': {'type': 'object'}}}

find_fire_locations

Find where a portfolio can fund early retirement

Geo-arbitrage FIRE analysis: given a portfolio and safe withdrawal rate, returns every country where the passive income sustains a lean ($32k US-equivalent/yr), comfortable ($55k), upper ($90k), or luxury ($150k) lifestyle at local purchasing-power prices — plus FIRE numbers per tier, nomad-visa income-floor eligibility, local-currency income, an SWR sensitivity band, (with savings/coast params) years until each country unlocks, and — where covered — a `statePension` overlay with the OECD net pension replacement rate (safety net from pension age; not subtracted from the FIRE numbers). Estimates only — not financial advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'swr': 0.04, 'portfolio': 400000}], 'required': ['portfolio'], 'properties': {'swr': {'type': 'number', 'default': 0.04, 'description': 'Safe withdrawal rate as fraction (0.04) or percent (4). Default 0.04.'}, 'coast': {'enum': ['1'], 'type': 'string', 'description': 'Set to 1 for Coast-FIRE mode (project growth with zero further savings).'}, 'return': {'type': 'number', 'description': 'Expected real annual return, fraction (0.05) or percent (5). Default 0.05.'}, 'source': {'enum': ['consensus', 'worldbank', 'imf', 'oecd', 'pwt', 'worldbank-cons', 'bigmac', 'factbook'], 'type': 'string', 'default': 'consensus'}, 'savings': {'type': 'number', 'description': 'Monthly savings (USD) — enables the years-to-FIRE planner.'}, 'portfolio': {'type': 'number', 'minimum': 0, 'description': 'Total investable portfolio (USD).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'visa': {'type': 'object'}, 'coverage': {'type': 'number'}, 'tierCosts': {'type': 'object'}, 'fireNumbers': {'type': 'object'}, 'yearsToTier': {'type': 'object'}, 'achievedTier': {'enum': ['lean', 'comfortable', 'upper', 'luxury', None], 'type': ['string', 'null']}}}}, 'sensitivity': {'type': 'array', 'items': {'type': 'object'}}, 'annualIncome': {'type': 'number'}, 'monthlyIncome': {'type': 'number'}}}

find_founder_visas

Founder, start-up and investor visas, matched to available funds

Which of the 41 spine countries would let a founder in, and on what terms — a hand-curated register of founder/start-up routes, investor routes and `kind: "none"` entries, each with its one published money figure and what it is for (`minFunds.basis`: an investment to make, subsistence funds to hold, or funding raised from investors), whether an endorsing body must approve the project, duration, renewability, a path-to-residency flag, the official page it was read from and the check date; an entry read from secondary reporting because the official site could not be fetched is marked `confidence: "secondary"`. Give `funds` with optional `currency` for a match: routes the funds reach, near misses within 25%, routes needing money raised from investors rather than held, routes with no published figure, exclusions with the reason, and the countries with no route. Or `country` for one entry, `countries` for a side-by-side. Thresholds are compared in USD at the site's FX snapshot; endorsement and business-plan tests are not modelled, and programmes pause and reprice. Published rates and facts on the dates shown, for information only — not tax, legal or immigration advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'funds': 50000, 'currency': 'GBP'}], 'properties': {'funds': {'type': 'number', 'minimum': 1, 'description': 'Funds available to commit, in `currency`.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code for a single entry.'}, 'currency': {'type': 'string', 'default': 'USD', 'description': 'ISO 4217 code of `funds` (e.g. "GBP").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'kind': {'type': 'string'}, 'none': {'type': 'array', 'items': {'type': 'string'}}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'qualify': {'type': 'array', 'items': {'type': 'object'}}, 'nearMiss': {'type': 'array', 'items': {'type': 'object'}}, 'attribution': {'type': 'object'}, 'fundingRaised': {'type': 'array', 'items': {'type': 'object'}}}}

find_meeting_slot

Score team timezone friction + find the meeting window

Given a set of cities/timezones and each participant's local working hours, find the longest UTC window where everyone is simultaneously within their working day (DST-accurate), AND score the team's overall timezone friction. Returns the overlap in UTC and in each participant's local time (or null with the best partial coverage), plus a `friction` block: a 0–100 score, grade (Effortless/Manageable/Strained/Broken), daily shared hours, coverage, and the `loneWolf` — the member whose removal would free the most team overlap. Useful for scheduling and for hiring/team-composition decisions.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'zones': ['Europe/London', 'America/New_York', 'Australia/Sydney']}], 'required': ['zones'], 'properties': {'end': {'type': 'number', 'default': 1080, 'description': 'Default working-window end, minutes from local midnight (default 1080 = 18:00).'}, 'date': {'type': 'string', 'format': 'date', 'description': 'Reference date (ISO YYYY-MM-DD) for DST. Defaults to today (UTC).'}, 'hours': {'type': 'string', 'description': "Optional per-zone overrides aligned to `zones`, e.g. '540-1080;420-720'."}, 'start': {'type': 'number', 'default': 540, 'description': 'Default working-window start, minutes from local midnight (default 540 = 09:00).'}, 'zones': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': "IANA timezone identifiers, e.g. 'Europe/London'."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'overlap': {'type': ['object', 'null'], 'properties': {'local': {'type': 'array', 'items': {'type': 'object', 'properties': {'end': {'type': 'string'}, 'label': {'type': 'string'}, 'start': {'type': 'string'}, 'offset': {'type': 'number'}, 'timeZone': {'type': 'string'}}}}, 'endUtc': {'type': 'number'}, 'startUtc': {'type': 'number'}, 'endUtcLabel': {'type': 'string'}, 'startUtcLabel': {'type': 'string'}, 'durationMinutes': {'type': 'number'}}}, 'friction': {'type': 'object', 'properties': {'grade': {'enum': ['Effortless', 'Manageable', 'Strained', 'Broken'], 'type': 'string'}, 'score': {'type': 'number', 'description': '0–100; higher is less friction.'}, 'coverage': {'type': 'object', 'properties': {'of': {'type': 'number'}, 'simultaneous': {'type': 'number'}}}, 'loneWolf': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'timeZone': {'type': 'string'}, 'gainMinutes': {'type': 'number'}}, 'description': 'Present when N≥3 and dropping one member frees ≥2h of overlap.'}, 'overlapMinutes': {'type': 'number'}, 'dailyOverlapHours': {'type': 'number'}}}, 'referenceDate': {'type': 'string'}, 'bestPartialCount': {'type': 'number'}}}

find_nomad_visas

Match income to digital nomad visas

Digital-nomad visa Income Matcher: given a monthly remote income (any currency) and household size, computes each program's real income threshold (base plus its published per-dependent uplift) and returns the programs you qualify for plus the near misses just out of reach — with duration, renewability, tax notes and official source URLs. Curated summaries — verify with the official source before applying.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'income': 4000, 'children': 1, 'currency': 'EUR', 'partners': 1}], 'properties': {'income': {'type': 'number', 'description': 'Your gross monthly income (in `currency`, default USD).'}, 'children': {'type': 'number', 'description': "Number of dependent children (each adds the program's child uplift)."}, 'currency': {'type': 'string', 'description': 'ISO currency code for `income` (e.g. EUR, GBP, INR). Defaults to USD.'}, 'partners': {'enum': [0, 1], 'type': 'number', 'description': "1 if bringing a partner (raises each program's threshold by its partner uplift)."}, 'renewable': {'enum': ['1'], 'type': 'string', 'description': 'Set to 1 to require renewable programs.'}, 'residency': {'enum': ['1'], 'type': 'string', 'description': 'Set to 1 to require a path to permanent residency.'}, 'minDuration': {'type': 'number', 'description': 'Minimum program duration in months.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'total': {'type': 'number'}, 'matches': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Programs you qualify for; each carries requiredUsd (household threshold) and shortfallUsd (≤0).'}, 'updated': {'type': 'string'}, 'household': {'type': 'object', 'properties': {'children': {'type': 'number'}, 'partners': {'type': 'number'}}}, 'incomeUsd': {'type': 'number', 'description': 'Your income converted to USD, used for matching.'}, 'nearMisses': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Programs within ~$1,000/mo of qualifying, closest first.'}}}

find_retirement_visas

Retirement and passive-income visas, matched to a monthly income

Which of the 41 spine countries would let a retiree in, and on what terms — a hand-curated register of retiree, passive-income and deposit routes (kind), each with minimum age, monthly income or deposit threshold in its own currency, duration, renewability, a path-to-residency flag, the official page it was read from and the check date; an entry read from secondary reporting because the official site could not be fetched is marked `confidence: "secondary"`, and countries with no route are `kind: "none"` with a line saying why. Give `income` (monthly) with optional `currency`, `age` and `savings` for a match: routes the income reaches, near misses within 25%, deposit routes (judged only when `savings` is given — a pension says nothing about a fixed deposit), routes with no published figure, exclusions with the reason, and the countries with no route. Or `country` for one entry, `countries` for a side-by-side. Thresholds are compared in USD at the site's FX snapshot; dependants raise them. Published rules and modelled figures on the dates shown, for information only — entitlements depend on a person's record and consulates decide; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'age': 62, 'income': 1500, 'currency': 'GBP'}], 'properties': {'age': {'type': 'number', 'maximum': 120, 'minimum': 18, 'description': 'Applicant age; routes with a higher minimum are excluded.'}, 'income': {'type': 'number', 'minimum': 1, 'description': 'Monthly income to match, in `currency`.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code for a single entry.'}, 'savings': {'type': 'number', 'minimum': 0, 'description': 'Lump sum available, in `currency`; unlocks deposit routes.'}, 'currency': {'type': 'string', 'default': 'USD', 'description': 'ISO 4217 code of `income` and `savings` (e.g. "GBP").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'kind': {'type': 'string'}, 'none': {'type': 'array', 'items': {'type': 'string'}}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'qualify': {'type': 'array', 'items': {'type': 'object'}}, 'nearMiss': {'type': 'array', 'items': {'type': 'object'}}, 'attribution': {'type': 'object'}, 'depositRoutes': {'type': 'array', 'items': {'type': 'object'}}}}

find_student_visas

Student visas matched to the funds a student can show

Student-visa routes for the 41 spine countries — a hand-curated register of the funds a student must show (amount, currency, per month or year), the work hours allowed in term, the post-study stay in months, a path-to-residency flag, the official page it was read from and the check date; secondary-sourced entries are marked, and countries with no route are `kind: "none"`. No tuition figures: no citable structured source exists. Give `funds` with optional `currency` and `per` (year default; month) for a match: routes the funds reach, near misses within 25%, routes with no published figure, exclusions with the reason, and the countries with no route. Or `country` for one entry, `countries` for a side-by-side. Funds are compared per year in USD at the site's FX snapshot; figures move each academic year. Published rules for information only — not immigration advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'funds': 20000, 'currency': 'GBP'}], 'properties': {'per': {'enum': ['year', 'month'], 'type': 'string', 'default': 'year'}, 'funds': {'type': 'number', 'minimum': 1, 'description': 'Living funds the student can show, in `currency`, for `per`.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'currency': {'type': 'string', 'default': 'USD'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'kind': {'type': 'string'}, 'none': {'type': 'array', 'items': {'type': 'string'}}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'qualify': {'type': 'array', 'items': {'type': 'object'}}, 'nearMiss': {'type': 'array', 'items': {'type': 'object'}}, 'attribution': {'type': 'object'}, 'unpublished': {'type': 'array', 'items': {'type': 'object'}}}}

health_prep

Vaccines, yellow-fever certificate and malaria, by country

What to sort out with a travel clinic, as facts from TravelHealthPro (NaTHNaC, the UK's national travel-health centre) with the source page linked per row: the yellow-fever certificate position (required for all arrivals, required when arriving from a risk country, or none), whether the country itself carries yellow-fever risk, the vaccine names recommended for most UK travellers and for some, and whether malaria guidance exists — plus the health-risk names the FCDO lists. Give `country` for one country or `countries` (two or more) for a side-by-side. Facts only, never NaTHNaC's prose; the reasoning is at the linked page. These are recommendations for UK travellers and depend on itinerary and medical history — a clinic decides for a person. The UK itself is NO_DATA (no FCDO page, so no link), never an empty list. Official sources on the dates shown, for information only — conditions change; check the source before travelling. Every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'BR'}], 'properties': {'country': {'type': 'string', 'description': 'One ISO alpha-2 code (e.g. "BR").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more. Ignored when `country` is given.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'malaria': {'type': 'boolean'}, 'attribution': {'type': 'object'}, 'vaccinesMost': {'type': 'array', 'items': {'type': 'string'}}, 'vaccinesSome': {'type': 'array', 'items': {'type': 'string'}}, 'yellowFeverCertificate': {'type': 'string'}}}

legal_profile

Women, Business and the Law: what the statute says, by country

The World Bank's Women, Business and the Law reading of each country's statute (2026 edition, 41 spine countries). Give `country` for one country: the Legal Frameworks index (0-100), eight topic scores (mobility, workplace, pay, marriage, parenthood, entrepreneurship, assets, pension), the coded answers grouped by topic — can a woman choose where to live, travel abroad, get a job the same way as a man, is equal pay for work of equal value mandated, can she obtain a divorce and head a household, own and inherit equally, open a business and access credit without discrimination — and the full, partial and mandatory retirement ages for men and women. Give `countries` (two or more) for the index, topics and ages side by side, or neither for the spine ranked by `metric` (`index`, a topic, `retirementAgeMen`, `retirementAgeWomen`). A partial answer keeps WBL's fraction as `{partial}` rather than rounding to yes or no; a true says the provision exists in law, not that it is enforced. Statutory figures for information only — not legal or tax advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'SA'}], 'properties': {'sort': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Ranking direction. Ignored when `countries` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'metric': {'enum': ['index', 'mobility', 'workplace', 'pay', 'marriage', 'parenthood', 'entrepreneurship', 'assets', 'pension', 'retirementAgeMen', 'retirementAgeWomen'], 'type': 'string', 'default': 'index', 'description': 'Ranking metric when neither `country` nor `countries` is given.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code for the full profile (e.g. "SA").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side comparison. Ignored when `country` is given.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'law': {'type': 'object'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'index': {'type': 'number'}, 'topics': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'edition': {'type': 'number'}, 'retirement': {'type': 'object'}, 'attribution': {'type': 'object'}}}

list_datasets

Every dataset on the site, and when it last changed

The registry of every dataset behind the site's figures — price levels, wages, housing, healthcare, holidays, working time, inflation, remittance prices, and the rest. Each carries `updated`, the date it was last REBUILT (a fetcher ran, or a person reviewed it), and — where the dataset knows it — `vintage`, what the figures themselves describe: a year, an edition, a quarter, or the source's own publication date. THE TWO ARE DIFFERENT AND OFTEN YEARS APART: exchange rates rebuilt in 2026 are 2025 annual averages, and city rents rebuilt in 2026 are from 2023. Judge how current a figure is by `vintage` and fall back to `updated` only where `vintage` is absent, which means the dataset has none of its own — a curated register's vintage is the day a person read the authority's page. Also says whether it is FETCHED by a script or REVIEWED by a person, the page it appears on, and the refresh script. With `since` (YYYY-MM-DD), `changed` lists only the datasets rebuilt strictly after that date, so an agent that cached a figure can decide what to re-fetch instead of re-fetching everything. Pure: `since` comes from the caller. Carries no figures and therefore no attribution block; each dataset's provenance travels with the tool that serves it.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'since': '2026-09-01'}], 'properties': {'since': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Return only datasets changed strictly after this date (YYYY-MM-DD). Omit for all.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'count': {'type': 'number'}, 'since': {'type': ['string', 'null']}, 'newest': {'type': ['string', 'null']}, 'changed': {'type': 'array', 'items': {'type': 'object'}}, 'datasets': {'type': 'array', 'items': {'type': 'object'}}, 'changedCount': {'type': 'number'}}}

localize_salary

Localize a salary for fair pay across borders

Convert a base salary from a home country into a cost-of-living-fair local equivalent: S_local = S_base × (I_target / I_home), where I is a US-relative price level. Omit `target` to receive a localized salary matrix across every country in the source — useful for pricing one offer across many markets. Returns USD purchasing-power equivalents, not currency-converted amounts.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'base': 150000, 'home': 'US', 'source': 'consensus', 'target': 'ES'}], 'required': ['base', 'home'], 'properties': {'base': {'type': 'number', 'minimum': 0, 'description': 'Base annual salary in the home country (USD-denominated).'}, 'home': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 home country code the base salary is expressed in (case-insensitive).'}, 'source': {'enum': ['consensus', 'worldbank', 'imf', 'oecd', 'pwt', 'worldbank-cons', 'bigmac', 'factbook'], 'type': 'string', 'default': 'consensus', 'description': "PPP dataset to draw figures from. Defaults to 'consensus' if omitted."}, 'target': {'type': 'string', 'description': 'Optional ISO 3166-1 alpha-2 target country code. Omit to localize across all countries in the source.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'home': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}, 'pppIndex': {'type': 'number'}}}, 'input': {'type': 'object', 'properties': {'baseSalary': {'type': 'number'}}}, 'source': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}}}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'local': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'fxRate': {'type': 'number'}, 'fxYear': {'type': 'number'}, 'currency': {'type': 'string'}}, 'description': "The figure in the target's local currency at market FX (omitted when no rate is known or target is USD)."}, 'ratio': {'type': 'number'}, 'target': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}, 'currency': {'type': 'string'}, 'pppIndex': {'type': 'number'}}}, 'localEquivalent': {'type': 'number'}}}}}}

passport_power

Passport visa-free access score and global rank

Passport Power: for a given country's passport, returns the visa-free-access score (visa-free + visa-on-arrival + eTA destinations), global rank and percentile among all ~199 passports, and the full destination breakdown by access type with names resolved. Omit country for the ranked league table. Reference data from the open imorte/passport-index-data (public domain) — confirm entry rules with the destination authority before travel.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'SG'}], 'properties': {'country': {'type': 'string', 'description': 'Passport country alpha-2 code (e.g. US, GB, SG). Omit for the full league table.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'passport': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'counts': {'type': 'object'}, 'destinations': {'type': 'object'}, 'mobilityScore': {'type': 'number'}}}, 'resolved': {'type': 'object'}, 'percentile': {'type': 'number'}, 'totalPassports': {'type': 'number'}}}

pension_abroad

What a pension is worth abroad, and how fast it erodes

A fixed pension paid from one country and spent in another, after the exchange rate, the destination's price level and the destination's inflation. Converts `amount` in `currency` at the site's FX snapshot, re-prices it at the destination through the PPP engine (the same price-level comparison as calculate_ppp), and projects it flat at the destination's latest annual inflation for `years` (1-40, default 10), returning what it is worth there today and after the period, in USD and local currency, with the share of purchasing power lost. Without `amount`, the origin's typical state pension is used — OECD's net replacement rate for an average earner on the modelled median wage — and `basis` says so; 33 origins have a rate, the rest need `amount`. Holds the pension and the exchange rate fixed and says so; many state pensions are uprated, and some are frozen for expatriates in particular countries. Not financial advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'to': 'PT', 'from': 'GB', 'years': 10, 'amount': 1000, 'currency': 'GBP'}], 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Country it will be spent in, ISO alpha-2 (e.g. "PT").'}, 'from': {'type': 'string', 'description': 'Country the pension is paid from, ISO alpha-2 (e.g. "GB").'}, 'years': {'type': 'number', 'maximum': 40, 'minimum': 1, 'description': 'Years to project (whole number, default 10).'}, 'amount': {'type': 'number', 'minimum': 1, 'description': "Monthly pension in `currency`. Omit for the origin's typical state pension."}, 'currency': {'type': 'string', 'description': 'ISO 4217 code of `amount` (default USD).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'to': {'type': 'object'}, 'from': {'type': 'object'}, 'years': {'type': 'number'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'pension': {'type': 'object'}, 'erosionPct': {'type': 'number'}, 'attribution': {'type': 'object'}, 'inflationPct': {'type': 'number'}, 'worthTodayUsd': {'type': 'number'}, 'worthTodayLocal': {'type': 'number'}, 'worthAfterYearsUsd': {'type': 'number'}, 'worthAfterYearsLocal': {'type': 'number'}}}

plan_team_calendar

Team calendar: shared working days and hours across countries

When a distributed team can actually all work. Joins the two halves no free tool puts together: the weekdays on which NOBODY is on a public holiday (the engine behind compare_public_holidays) and the daily working-hour overlap across the members' time zones (the engine behind find_meeting_slot), evaluated on 15 January and 15 July so daylight-saving asymmetry is visible, and multiplied into conservative shared working hours per year. Members are ISO alpha-2 country codes; each country is placed in the time zone of its representative city, and countries spanning several zones (US, CA, BR, MX, AU, ID) are flagged `multiZone` — append `@IANA/Zone` to override (e.g. `US@America/Chicago`). Covers the 41-country spine EXCEPT India, Thailand, Malaysia, the UAE and Saudi Arabia, which have no published holiday calendar and return NO_DATA naming them rather than a calendar with no holidays. Working-hour windows are a stated assumption (09:00-18:00 local unless given), not a measurement; annual leave is not modelled.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'members': 'GB,DE,US'}], 'required': ['members'], 'properties': {'end': {'type': 'number', 'description': 'Default local working-window end, minutes from midnight (default 1080 = 18:00).'}, 'year': {'type': 'number', 'description': 'Calendar year for the holiday calendar. Defaults to the first year in the dataset.'}, 'hours': {'type': 'string', 'description': 'Per-member `start-end` overrides, semicolon-separated and aligned with `members`; leave a slot empty to keep the default (e.g. "540-1080;;420-720").'}, 'start': {'type': 'number', 'description': 'Default local working-window start for every member, minutes from midnight (default 540 = 09:00).'}, 'members': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, each optionally `CC@IANA/Zone` (e.g. "GB,JP,US@America/Chicago").'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'days': {'type': 'object'}, 'year': {'type': 'number'}, 'hours': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'members': {'type': 'array', 'items': {'type': 'object'}}, 'attribution': {'type': 'object'}, 'sharedWorkingHoursPerYear': {'type': 'number'}}}

property_rules

Can a foreigner buy a home there — ownership band, restrictions, transfer tax

Whether a foreigner may buy residential property in each of the 41 spine countries: an ownership band (`free`, `restricted`, `leasehold-only`, `prohibited`), the main restrictions in a sentence, whether land itself may be owned, and the headline transfer tax a buyer pays with a note on surcharges and fees — a hand-curated register with the official page and check date per row; an entry read from secondary reporting because the official page could not be fetched is marked `confidence: "secondary"`. `country` for one entry, `countries` for a side-by-side; without either, all 41 ranked free-first then by transfer tax, optionally within one `band`. Rules change by decree and by region (Canada's ban runs to 2027, Australia's established-home ban to March 2027, Saudi Arabia's new law from January 2026). Published rules for information only — not legal advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'TH'}], 'properties': {'band': {'enum': ['free', 'restricted', 'leasehold-only', 'prohibited'], 'type': 'string', 'description': 'Restrict the ranking to one ownership band.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'source': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'checkedOn': {'type': 'string'}, 'attribution': {'type': 'object'}, 'restrictions': {'type': 'string'}, 'transferTaxPct': {'type': 'number'}, 'foreignOwnership': {'type': 'string'}}}

rank_livability

Rank countries by quality of life vs cost

Quality-of-Life vs Cost matrix: ranks 41 countries by a user-weighted composite of livability metrics (median broadband Mbps, safety, healthcare, air quality, English usability — curated country-level data replacing the discontinued Teleport API) against the monthly cost of single-person essentials at local purchasing-power prices. Returns per-country composite and value scores, lifestyle label for your budget (comfortable → like royalty), nomad-visa eligibility, and days-to-tax-residency. Curated estimates — verify locally.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'maxBudget': 3000, 'minInternet': 80}], 'properties': {'budget': {'type': 'number', 'default': 3000, 'minimum': 0, 'description': 'Monthly budget (USD) — drives lifestyle labels and visa eligibility.'}, 'weights': {'type': 'string', 'description': 'Five comma-separated 0–10 weights: internet,safety,healthcare,air,english (default 5,5,5,5,5).'}, 'maxBudget': {'type': 'number', 'minimum': 0, 'description': 'Filter: keep countries whose monthly essentials cost ≤ this (USD).'}, 'minSafety': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Filter: minimum safety score, 0–100.'}, 'minInternet': {'type': 'number', 'minimum': 0, 'description': 'Filter: minimum median broadband, Mbps (e.g. 80).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'visa': {'type': 'object'}, 'entry': {'type': 'object'}, 'composite': {'type': 'number'}, 'lifestyle': {'enum': ['out of budget', 'comfortable', 'very comfortable', 'like royalty'], 'type': 'string'}, 'valueScore': {'type': 'number'}, 'essentialsUsd': {'type': 'number'}, 'taxThresholdDays': {'type': 'number'}}}}, 'excluded': {'type': 'number'}}}

remittance_cost

Cost of sending money home, by corridor

What it costs to send money from one country to another, from the World Bank's Remittance Prices Worldwide survey (newest quarter, CC BY 4.0): the mean total cost — fee plus exchange-rate margin — of sending USD 200 and USD 500 across the providers surveyed on that corridor, the cheapest provider found, and how many were surveyed. With `amount` (USD), a quote at the nearer of the two surveyed bands (below USD 350 uses the 200 figures), and the response says which. Give `from` AND `to` for one corridor; only one of them for a ranking of surveyed corridors out of a sender or into a receiver, cheapest first. The survey covers ~350 high-volume corridors (~46 sending countries, ~96 receiving); a pair it does not survey returns NO_DATA, never a figure borrowed from a neighbour. Your own quote will differ by provider, payment method and day.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'to': 'IN', 'from': 'GB', 'amount': 500}], 'properties': {'to': {'type': 'string', 'description': 'Receiving country, ISO alpha-2 (e.g. "IN").'}, 'from': {'type': 'string', 'description': 'Sending country, ISO alpha-2 (e.g. "GB").'}, 'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest', 'description': 'Ranking direction when only one of `from`/`to` is given.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many corridors in a ranking.'}, 'amount': {'type': 'number', 'minimum': 1, 'description': "Amount to send, USD. Optional; without it the corridor's survey figures are returned unquoted."}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'quote': {'type': 'object'}, 'period': {'type': 'string'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'corridor': {'type': 'object'}, 'providers': {'type': 'number'}, 'attribution': {'type': 'object'}, 'avgCost200Pct': {'type': 'number'}, 'avgCost500Pct': {'type': 'number'}, 'cheapestCost200Pct': {'type': 'number'}}}

required_rate

Compute the required freelance hourly rate

Given a desired annual net income, compute the freelance hourly and day rate required after taxes, self-paid health insurance, weeks off, and billable utilization. Uses the same per-country effective-rate presets as compare_contract; all overridable. Estimates only — not tax advice.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'US', 'weeksOff': 6, 'desiredNet': 100000, 'utilization': 0.7}], 'required': ['desiredNet'], 'properties': {'hours': {'type': 'number', 'description': 'Hours per week (default 40).'}, 'health': {'type': 'number', 'description': 'Annual self-paid health insurance (USD); defaults to the country preset.'}, 'country': {'enum': ['US', 'GB', 'DE', 'FR', 'ES', 'NL', 'PT', 'EE', 'CA', 'AU', 'IN', 'AE', 'IT', 'GR', 'IE', 'DK', 'SE', 'NO', 'CH', 'CZ', 'PL', 'HU', 'TR', 'JP', 'KR', 'CN', 'SG', 'MY', 'TH', 'VN', 'ID', 'PH', 'NZ', 'SA', 'EG', 'ZA', 'NG', 'MX', 'BR', 'AR', 'CL', 'CO'], 'type': 'string', 'default': 'US'}, 'taxRate': {'type': 'number', 'description': 'Override effective tax rate, percent (e.g. 32).'}, 'expenses': {'type': 'number', 'description': 'Annual business expenses (USD, default 0).'}, 'weeksOff': {'type': 'number', 'description': 'Unpaid weeks off per year (default 4).'}, 'desiredNet': {'type': 'number', 'minimum': 1, 'description': 'Desired annual net take-home (USD).'}, 'utilization': {'type': 'number', 'description': 'Billable share of working hours, 0–1 (default 0.75).'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'dayRate': {'type': 'number'}, 'hourlyRate': {'type': 'number'}, 'billableHours': {'type': 'number'}, 'requiredGross': {'type': 'number'}}}

retire_on_budget

How far a monthly pension goes, country by country

Does a fixed monthly pension cover a month of local essentials. Given `amount` and `currency` (default GBP 1,500), returns every spine country ranked by coverage — the pension in USD divided by the country's MODELLED monthly essentials (the site's price basket scaled by the PPP price level, checked against real series and wrong both ways) — with the essentials figure, healthcare out-of-pocket per person per month (World Bank / WHO), life expectancy (World Bank) and the kind of retiree visa the country offers beside each row. Coverage is an ordering, not a budget; the pension is taken as fixed at the site's FX snapshot. Different from `pension_abroad`, which re-prices a pension against the origin's price level to say what it is worth relative to home. Published rules and modelled figures on the dates shown, for information only — entitlements depend on a person's record and consulates decide; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'amount': 1500, 'currency': 'GBP'}], 'properties': {'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries.'}, 'amount': {'type': 'number', 'default': 1500, 'minimum': 1, 'description': 'Monthly pension, in `currency`.'}, 'currency': {'type': 'string', 'default': 'GBP', 'description': 'ISO 4217 code of `amount`.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'pension': {'type': 'object'}, 'attribution': {'type': 'object'}}}

select_region

Select the lowest-latency cloud host region

Given a user-population breakdown, find the cloud host region that minimizes population-weighted round-trip latency (argmin_j Σ_i P_i × L_ij), and compute the optimal multi-region split (each user region routed to its nearest host). Latency is estimated from great-circle distance via a fibre-propagation model, not measured.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'users': 'US-East:40,UK:30,Germany:30'}], 'required': ['users'], 'properties': {'hosts': {'type': 'string', 'description': "Optional comma-separated host region ids to restrict candidates (e.g. 'us-east-1,eu-west-2')."}, 'users': {'type': 'string', 'description': "Comma-separated region:percent pairs (percentages auto-normalize), e.g. 'US-East:40,UK:30,Germany:30'. Region ids: US-East, US-West, Canada, Brazil, UK, Germany, France, Spain, Nigeria, South-Africa, UAE, India, Singapore, China, Japan, Australia."}, 'provider': {'enum': ['AWS', 'GCP', 'Azure'], 'type': 'string', 'description': 'Optional cloud provider filter, applied before the hosts whitelist.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'best': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'city': {'type': 'string'}, 'provider': {'type': 'string'}, 'weightedMs': {'type': 'number'}}}, 'split': {'type': 'object', 'properties': {'hostsUsed': {'type': 'array', 'items': {'type': 'string'}}, 'weightedMs': {'type': 'number'}, 'improvementMs': {'type': 'number'}}}, 'ranking': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'weightedMs': {'type': 'number'}}}}}}

travel_advice

UK and US government travel advice, by country

What two governments say about going. Give `country` (ISO alpha-2) for one country: the UK FCDO's level (none, all-but-essential to parts, all-but-essential, all travel to parts, all travel) with its latest change and date, the FCDO's passport-validity and visa sentences for British citizens and the health risks it lists, and the US State Department's advisory level (1 exercise normal precautions to 4 do not travel) with its headline. Give `countries` (two or more) for the levels side by side, or neither for the 41-country spine ranked least-restricted first by FCDO level then US level (`sort=highest` inverts). The two governments grade differently and often disagree; neither is rescored. The FCDO publishes nothing for the UK and the State Department nothing for the US, so those blocks are absent with a caveat, never a made-up level, and a country with neither is excluded from the ranking. Official sources on the dates shown, for information only — conditions change; check the source before travelling. Every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'country': 'TH'}], 'properties': {'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest', 'description': 'Ranking direction when neither `country` nor `countries` is given: lowest = least restricted first.'}, 'limit': {'type': 'number', 'minimum': 1, 'description': 'Return at most this many countries in a ranking.'}, 'country': {'type': 'string', 'description': 'One ISO alpha-2 code for the full advice (e.g. "TH").'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO alpha-2 codes, two or more, for a side-by-side. Ignored when `country` is given.'}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'us': {'type': 'object'}, 'fcdo': {'type': 'object'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'excluded': {'type': 'array', 'items': {'type': 'string'}}, 'attribution': {'type': 'object'}}}

withholding_tax

Withholding tax on payments abroad, standard and treaty rate per corridor

What a company in `from` keeps back when it pays dividends, interest, royalties or technical fees to a recipient in `to`: OECD's standard withholding rates for the payer's country and, for the pair, the treaty rate where OECD publishes one, with the saving in points per income type. Direction is the payer's, never reversed; `from` equal to `to` is rejected. A pair with no published treaty rate reports the standard rate and says so — that is not the same as no treaty existing, and the treaty figure is the maximum the treaty allows (a residence certificate is usually needed). Without `from`, ranks all 41 by standard rate on `type` (dividends default). Standard rates for 41 of 41; treaty rates for about 1,300 payer–recipient pairs within the spine (the Philippines never appears as a payer). Published rates and facts on the dates shown, for information only — not tax, legal or immigration advice; every response says so first.

Read only Idempotent

Input schema

{'type': 'object', 'examples': [{'to': 'GB', 'from': 'TH'}], 'properties': {'to': {'type': 'string', 'description': "ISO alpha-2 code of the recipient's country; unlocks the treaty rate."}, 'from': {'type': 'string', 'description': "ISO alpha-2 code of the paying company's country."}, 'sort': {'enum': ['lowest', 'highest'], 'type': 'string', 'default': 'lowest'}, 'type': {'enum': ['dividends', 'interest', 'royalties', 'technicalFees'], 'type': 'string', 'default': 'dividends', 'description': 'Income type to rank by when `from` is not given.'}, 'limit': {'type': 'number', 'minimum': 1}}, 'additionalProperties': False}

Output schema

{'type': 'object', 'properties': {'ok': {'type': 'boolean'}, 'to': {'type': 'object'}, 'rows': {'type': 'array', 'items': {'type': 'object'}}, 'lines': {'type': 'array', 'items': {'type': 'object'}}, 'treaty': {'type': 'object'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}}, 'standard': {'type': 'object'}, 'attribution': {'type': 'object'}}}

Geo-Parity

What this MCP does

Tools

Recent tool changes

Similar MCP servers

mcp-server

AI 代理人任務中樞

Good Turn Studio (all tools)

FalaZuki Finance BR

XBOSS

Sirenic

taxsort-mcp

mcp