Geo-Parity

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

Cost of living, fair global pay, healthcare costs, nomad visas and tax residency. Free, no key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Geo-Parity": {
      "url": "https://geo-parity.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (62)

• compare_total_cost read-only

  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.

  Parameters:

  • income (required) — number — Monthly income in USD. Required — the tool is a subtraction.
  • sort — string — Ranking. 'remaining' = most left over first; 'share' = smallest share of your income.
  • country — string — ISO 3166-1 alpha-2; echoes that country's row and rank as `focus`.
  • maxPctOfIncome — number — Keep only countries whose total is at or below this share of income (%).

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

• calculate_ppp read-only

  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.

  Parameters:

  • income (required) — number — Nominal annual income, denominated against the US baseline.
  • target (required) — string — ISO 3166-1 alpha-2 target country code (case-insensitive). Available codes depend on the chosen source.
  • city — string — 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.
  • source — string — 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.

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

• localize_salary read-only

  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.

  Parameters:

  • base (required) — number — Base annual salary in the home country (USD-denominated).
  • home (required) — string — ISO 3166-1 alpha-2 home country code the base salary is expressed in (case-insensitive).
  • source — string — PPP dataset to draw figures from. Defaults to 'consensus' if omitted.
  • target — string — Optional ISO 3166-1 alpha-2 target country code. Omit to localize across all countries in the source.

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

• calculate_wage_bands read-only

  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.

  Parameters:

  • country (required) — string — ISO 3166-1 alpha-2 country code (case-insensitive).
  • salary — number — Your salary to locate on the distribution. Values over 20000 are read as annual (÷12), else monthly.
  • percentile — number — Return the exact wage threshold at this percentile (e.g. 90 for the top-10% floor).

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

• compare_occupation_pay read-only

  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.

  Parameters:

  • country (required) — string — ISO 3166-1 alpha-2 country code (case-insensitive).
  • occupation — string — Narrow the response to one ISCO-08 major group. Omit for the whole table.

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

• build_pay_range read-only

  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.

  Parameters:

  • country (required) — string — ISO 3166-1 alpha-2 country code (case-insensitive).
  • seniority — string — Defaults to 'mid'. An unrecognised value is rejected.
  • occupation — string — ISCO-08 major group. Defaults to 'total' (all occupations). An unrecognised value is rejected, never widened to the default.

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

• check_schengen read-only

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

  Parameters:

  • trips (required) — array — List of Schengen stays.
  • plannedEntry — string — Optional planned entry date. When set, the response adds plan: { maxStay, latestExit, fullResetDate } — the longest compliant stay starting on that date.
  • referenceDate — string — Optional 'as of' date (ISO YYYY-MM-DD). Defaults to today (UTC).

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

• find_meeting_slot read-only

  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.

  Parameters:

  • zones (required) — array — IANA timezone identifiers, e.g. 'Europe/London'.
  • end — number — Default working-window end, minutes from local midnight (default 1080 = 18:00).
  • date — string — Reference date (ISO YYYY-MM-DD) for DST. Defaults to today (UTC).
  • hours — string — Optional per-zone overrides aligned to `zones`, e.g. '540-1080;420-720'.
  • start — number — Default working-window start, minutes from local midnight (default 540 = 09:00).

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

• compare_contract read-only

  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.

  Parameters:

  • contractorRate (required) — number — Self-employed hourly rate (USD).
  • employeeRate (required) — number — Employee/W2/EOR hourly rate (USD).
  • hours — number — Hours per week (default 40).
  • ctRate — number — Override contractor effective tax rate, percent (e.g. 32).
  • health — number — Annual self-paid health insurance (USD); defaults to the country preset.
  • country — string — Country code for tax presets.
  • empRate — number — Override employee effective tax rate, percent (e.g. 24).
  • taxMode — string — 'brackets' uses progressive 2025 schedules (US and GB only; falls back to flat elsewhere — response echoes the mode).
  • expenses — number — Annual business expenses (USD, default 0).
  • employeeWeeks — number — Employee paid weeks (default 52).
  • contractorWeeks — number — Contractor paid/billable weeks (default 48).

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

• select_region read-only

  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.

  Parameters:

  • users (required) — string — 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.
  • hosts — string — Optional comma-separated host region ids to restrict candidates (e.g. 'us-east-1,eu-west-2').
  • provider — string — Optional cloud provider filter, applied before the hosts whitelist.

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

• compare_countries read-only

  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.

  Parameters:

  • a (required) — string — First ISO 3166-1 alpha-2 country code (case-insensitive).
  • b (required) — string — Second ISO 3166-1 alpha-2 country code (must differ from a).

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

• required_rate read-only

  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.

  Parameters:

  • desiredNet (required) — number — Desired annual net take-home (USD).
  • hours — number — Hours per week (default 40).
  • health — number — Annual self-paid health insurance (USD); defaults to the country preset.
  • country — string
  • taxRate — number — Override effective tax rate, percent (e.g. 32).
  • expenses — number — Annual business expenses (USD, default 0).
  • weeksOff — number — Unpaid weeks off per year (default 4).
  • utilization — number — Billable share of working hours, 0–1 (default 0.75).

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

• check_residency read-only

  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.

  Parameters:

  • stays (required) — array
  • referenceDate — string — Optional 'as of' date. Defaults to today (UTC).

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

• check_travel_residency read-only

  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.

  Parameters:

  • stays (required) — array
  • income — number — Optional gross annual income (USD) — enables the tax-cost projection for at-risk countries.
  • referenceDate — string — Optional 'as of' date. Defaults to today (UTC).

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

• find_fire_locations read-only

  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.

  Parameters:

  • portfolio (required) — number — Total investable portfolio (USD).
  • swr — number — Safe withdrawal rate as fraction (0.04) or percent (4). Default 0.04.
  • coast — string — Set to 1 for Coast-FIRE mode (project growth with zero further savings).
  • return — number — Expected real annual return, fraction (0.05) or percent (5). Default 0.05.
  • source — string
  • savings — number — Monthly savings (USD) — enables the years-to-FIRE planner.

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

• estimate_micro_costs read-only

  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.

  Parameters:

  • base (required) — string — ISO 3166-1 alpha-2 country code to compare FROM (case-insensitive).
  • target (required) — string — ISO 3166-1 alpha-2 country code to compare TO (must differ from base).
  • source — string — Optional dataset override. Defaults to the consumption basket (worldbank-cons) when it covers both countries, else consensus; the response echoes the source used.
  • baseCity — string — Optional city slug for the base side (sub-national cost adjustment, e.g. 'london'). Enables intra-country city comparisons like London vs Hull.
  • targetCity — string — Optional city slug for the target side (e.g. 'hull').

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

• check_tax_residency_risk read-only

  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.

  Parameters:

  • country (required) — string — ISO 3166-1 alpha-2 country code (case-insensitive).
  • days (required) — number — Days of presence in the relevant counting period.
  • income (required) — number — Gross annual income (USD) the residency cliff would expose.
  • arrival — string — Optional arrival date — adds leaveBy and residencyDate to the response.

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

• rank_livability read-only

  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.

  Parameters:

  • budget — number — Monthly budget (USD) — drives lifestyle labels and visa eligibility.
  • weights — string — Five comma-separated 0–10 weights: internet,safety,healthcare,air,english (default 5,5,5,5,5).
  • maxBudget — number — Filter: keep countries whose monthly essentials cost ≤ this (USD).
  • minSafety — number — Filter: minimum safety score, 0–100.
  • minInternet — number — Filter: minimum median broadband, Mbps (e.g. 80).

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

• compare_healthcare read-only

  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.

  Parameters:

  • sort — string — 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 — string — Optional ISO 3166-1 alpha-2 country code (case-insensitive). Echoes that country's row and its rank under the active sort.
  • maxOutOfPocketPct — number — Optional filter: keep only countries where households pay at most this percentage of health spending directly.
  • minPhysiciansPer1000 — number — Optional filter: keep only countries with at least this many physicians per 1,000 people.

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

• compare_housing read-only

  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.

  Parameters:

  • sort — string — '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 — number — Flat size in m² used to convert measured per-m² rents. Default 70; echoed back so the assumption is visible.
  • country — string — Optional ISO 3166-1 alpha-2 code; echoes that country's row and rank.
  • remoteIncome — number — Your monthly income in USD, earned remotely. Enables rentPctOfYourIncome and arbitrageGap; omit for the local-only view.
  • maxRentPctOfIncome — number — Optional filter: keep only countries where rent is at most this percentage of your remote income. Requires remoteIncome.

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

• find_nomad_visas read-only

  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.

  Parameters:

  • income — number — Your gross monthly income (in `currency`, default USD).
  • children — number — Number of dependent children (each adds the program's child uplift).
  • currency — string — ISO currency code for `income` (e.g. EUR, GBP, INR). Defaults to USD.
  • partners — number — 1 if bringing a partner (raises each program's threshold by its partner uplift).
  • renewable — string — Set to 1 to require renewable programs.
  • residency — string — Set to 1 to require a path to permanent residency.
  • minDuration — number — Minimum program duration in months.

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

• passport_power read-only

  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.

  Parameters:

  • country — string — Passport country alpha-2 code (e.g. US, GB, SG). Omit for the full league table.

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

• calculate_runway read-only

  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.

  Parameters:

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

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

• compare_connectivity read-only

  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.

  Parameters:

  • sort — string — Metric to rank by. Bandwidth sorts high-to-low; latency and jitter sort low-to-high, because “better” runs in opposite directions.
  • limit — number — Return at most this many countries.
  • maxLatency — number — Filter: maximum median idle latency, ms (e.g. 100).
  • minDownload — number — Filter: minimum median download, Mbps (e.g. 50).

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

• compare_public_holidays read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • year — number — Calendar year. Defaults to the first year in the dataset.
  • limit — number — Return at most this many countries in a ranking.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,JP"). Omit to get a ranking instead of an overlap.

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

• plan_team_calendar read-only

  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.

  Parameters:

  • members (required) — string — Comma-separated ISO alpha-2 codes, two or more, each optionally `CC@IANA/Zone` (e.g. "GB,JP,US@America/Chicago").
  • end — number — Default local working-window end, minutes from midnight (default 1080 = 18:00).
  • year — number — Calendar year for the holiday calendar. Defaults to the first year in the dataset.
  • hours — string — 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 — number — Default local working-window start for every member, minutes from midnight (default 540 = 09:00).

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

• estimate_employer_cost read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `country` is given.
  • gross — number — Gross annual wage in USD. When omitted, the pay-range midpoint is used.
  • limit — number — Return at most this many countries in a ranking.
  • country — string — ISO alpha-2 code (e.g. "DE"). Omit for a ranking.
  • seniority — string — Seniority for the default wage (default `mid`). Ignored when `gross` is given.
  • occupation — string — ISCO-08 major group id for the default wage (default `total`). Ignored when `gross` is given.

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

• compare_working_time read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric. Ignored when `countries` is given.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,US,TH"). Omit to get a ranking instead.

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

• compare_inflation read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric. Ignored when `countries` is given.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,DE,TR"). Omit to get a ranking instead.

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

• remittance_cost read-only

  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.

  Parameters:

  • to — string — Receiving country, ISO alpha-2 (e.g. "IN").
  • from — string — Sending country, ISO alpha-2 (e.g. "GB").
  • sort — string — Ranking direction when only one of `from`/`to` is given.
  • limit — number — Return at most this many corridors in a ranking.
  • amount — number — Amount to send, USD. Optional; without it the corridor's survey figures are returned unquoted.

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

• pension_abroad read-only

  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.

  Parameters:

  • from (required) — string — Country the pension is paid from, ISO alpha-2 (e.g. "GB").
  • to (required) — string — Country it will be spent in, ISO alpha-2 (e.g. "PT").
  • years — number — Years to project (whole number, default 10).
  • amount — number — Monthly pension in `currency`. Omit for the origin's typical state pension.
  • currency — string — ISO 4217 code of `amount` (default USD).

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

• compare_banking_access read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric. Ignored when `countries` is given.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,NG,IN"). Omit to get a ranking instead.

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

• banking_access read-only

  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.

  Parameters:

  • sort — string — Defaults to highest, or lowest for instantPaymentsSince (longest-running first).
  • limit — number — Maximum rows in a ranking.
  • access — string — Narrow a ranking to one non-resident access rule.
  • metric — string — Ranking metric when no country is given.
  • country — string — ISO alpha-2 code for a single country, e.g. PT.
  • countries — string — Comma-separated ISO alpha-2 codes, at least two, e.g. GB,TH,NG.

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

• compare_tax_rates read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric. Ignored when `countries` is given.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,IE,TH"). Omit to get a ranking instead.

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

• legal_profile read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric when neither `country` nor `countries` is given.
  • country — string — One ISO alpha-2 code for the full profile (e.g. "SA").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side comparison. Ignored when `country` is given.

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

• compare_vat read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "GB,US,DE"). Omit to get a ranking instead.

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

• travel_advice read-only

  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.

  Parameters:

  • sort — string — Ranking direction when neither `country` nor `countries` is given: lowest = least restricted first.
  • limit — number — Return at most this many countries in a ranking.
  • country — string — One ISO alpha-2 code for the full advice (e.g. "TH").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side. Ignored when `country` is given.

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

• health_prep read-only

  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.

  Parameters:

  • country — string — One ISO alpha-2 code (e.g. "BR").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more. Ignored when `country` is given.

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

• compare_safety_stats read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored when `countries` is given.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric. Ignored when `countries` is given.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more (e.g. "DE,BR,ZA"). Omit to get a ranking instead.

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

• compare_pension_systems read-only

  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.

  Parameters:

  • sort — string — Ranking direction. Ignored otherwise.
  • limit — number — Return at most this many countries in a ranking.
  • metric — string — Ranking metric when neither `country` nor `countries` is given.
  • country — string — One ISO alpha-2 code for the full profile (e.g. "DE").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side. Ignored when `country` is given.

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

• find_retirement_visas read-only

  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.

  Parameters:

  • age — number — Applicant age; routes with a higher minimum are excluded.
  • income — number — Monthly income to match, in `currency`.
  • country — string — One ISO alpha-2 code for a single entry.
  • savings — number — Lump sum available, in `currency`; unlocks deposit routes.
  • currency — string — ISO 4217 code of `income` and `savings` (e.g. "GBP").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• retire_on_budget read-only

  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.

  Parameters:

  • limit — number — Return at most this many countries.
  • amount — number — Monthly pension, in `currency`.
  • currency — string — ISO 4217 code of `amount`.

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

• compare_effective_tax read-only

  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.

  Parameters:

  • sort — string
  • limit — number — Return at most this many countries.
  • metric — string — Ranking metric when neither `country` nor `countries` is given.
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• withholding_tax read-only

  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.

  Parameters:

  • to — string — ISO alpha-2 code of the recipient's country; unlocks the treaty rate.
  • from — string — ISO alpha-2 code of the paying company's country.
  • sort — string
  • type — string — Income type to rank by when `from` is not given.
  • limit — number

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

• compare_business_entry read-only

  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.

  Parameters:

  • sort — string — Default lowest for days and cost, highest for density.
  • limit — number
  • metric — string
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more.

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

• find_founder_visas read-only

  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.

  Parameters:

  • funds — number — Funds available to commit, in `currency`.
  • country — string — One ISO alpha-2 code for a single entry.
  • currency — string — ISO 4217 code of `funds` (e.g. "GBP").
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• compare_health_capacity read-only

  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.

  Parameters:

  • sort — string
  • limit — number — Return at most this many countries.
  • metric — string
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• compare_childcare_cost read-only

  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.

  Parameters:

  • sort — string
  • unit — string
  • limit — number — Return at most this many countries.
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.
  • household — string

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

• compare_food_cost read-only

  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.

  Parameters:

  • sort — string
  • limit — number — Maximum rows in a ranking.
  • metric — string
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• compare_trade_customs read-only

  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.

  Parameters:

  • sort — string
  • limit — number — Return at most this many countries.
  • metric — string
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• compare_tax_burden read-only

  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.

  Parameters:

  • sort — string
  • limit — number — Return at most this many countries.
  • metric — string
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• compare_egov read-only

  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.

  Parameters:

  • sort — string
  • index — string
  • limit — number — Return at most this many countries.
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• property_rules read-only

  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.

  Parameters:

  • band — string — Restrict the ranking to one ownership band.
  • limit — number — Return at most this many countries.
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• employment_rules read-only

  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.

  Parameters:

  • sort — string — Most first (default) or fewest first.
  • limit — number — Return at most this many countries.
  • metric — string — Ranking metric when neither country nor countries is given.
  • country — string — One ISO alpha-2 code.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• driving_rules read-only

  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.

  Parameters:

  • sort — string — Highest first (default) or lowest first.
  • limit — number — Return at most this many countries.
  • metric — string — Ranking metric when neither country nor countries is given.
  • country — string — One ISO alpha-2 code.
  • drivesOn — string — Restrict the ranking to one side of the road.
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.
  • idpRequired — string — Restrict the ranking by whether an International Driving Permit is needed.

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

• find_student_visas read-only

  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.

  Parameters:

  • per — string
  • funds — number — Living funds the student can show, in `currency`, for `per`.
  • country — string — One ISO alpha-2 code.
  • currency — string
  • countries — string — Comma-separated ISO alpha-2 codes, two or more, for a side-by-side.

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

• find_country_fit read-only

  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.

  Parameters:

  • air — number — Weight 0–10 for air (default 5).
  • cost — number — Weight 0–10 for cost (default 5).
  • limit — number — Maximum rows (default 10).
  • budget — number — Monthly budget in USD.
  • region — string — Keep only countries in this World Bank region.
  • safety — number — Weight 0–10 for safety (default 5).
  • english — number — Weight 0–10 for english (default 5).
  • internet — number — Weight 0–10 for internet (default 5).
  • needsVisa — boolean — Keep only countries with a digital nomad visa the budget meets.
  • healthcare — number — Weight 0–10 for healthcare (default 5).
  • withinBudget — boolean — Keep only countries whose modelled essentials fit inside the budget.

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

• country_dossier read-only

  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.

  Parameters:

  • country (required) — string — ISO alpha-2 code (e.g. "PT").
  • income — number — Gross monthly income in USD. Optional; unlocks the total-cost figures.

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

• list_datasets read-only

  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.

  Parameters:

  • since — string — Return only datasets changed strictly after this date (YYYY-MM-DD). Omit for all.

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

• compare_climate read-only

  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.

  Parameters:

  • city — string — City slug (e.g. "lisbon"). Returns that city's twelve months.
  • limit — number — Return at most this many cities.
  • month — number — Rank a single month. Omit to rank on the whole year.
  • country — string — ISO alpha-2. Returns the representative city's months, naming which city.
  • minComfortDays — number — Filter: minimum comfortable days in the ranked window.

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

• compare_country_risk read-only

  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.

  Parameters:

  • sort — string — Dimension to sort by. maxRisk always filters on the composite.
  • limit — number — Return at most this many countries.
  • country — string — ISO alpha-2 for a single country's scores.
  • maxRisk — number — Keep only countries at or below this composite score.
  • descending — boolean — True lists the most dangerous first.

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

• arrival_cost read-only

  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.

  Parameters:

  • passport (required) — string — ISO alpha-2 of the traveller's passport, e.g. 'US'. Determines the entry route and therefore the fee.
  • destination (required) — string — 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.
  • income — number — Monthly remote income in USD. Optional; enables housing's income-relative view but is not needed for the arrival total.
  • depositMonths — number — Months of rent held as a deposit. Defaults to the site's stated assumption of 1; override it if you know the market.

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

Publisher website

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