Compare cities
compare_citiesRank any number of cities for a person or household: a verdict, the score out of 100 from their weights with points and reasons per line, must-pass lines as pass, fail or unknown, each earner's take-home pay and what is left after rent and spending, who can move there, how the set was scored, and what to add next. Every figure carries its source and period. Compact by default; detail "full" adds every tax line, childcare, health, leave and break-even.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cities": "<cities>"
},
"name": "compare_cities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| only | No | Score only these criteria; every other line gets weight 0 (each listed one keeps its `weights` value, else 100). For a one-line question: only ["nice_days"] with comfort {min:20,max:28} | |
| work | No | The person's kind of work, only if they said it: software (Software and IT), engineering (Engineering, not software), science (Research and science), medicine (Doctors and dentists), nursing (Nursing and care), teaching (Teaching and education), finance (Finance and accounting), law (Law), marketing (Marketing, design and media), office (Office and administration), sales (Sales and retail), hospitality (Hospitality and food), trades (Construction and trades), transport (Transport and logistics), public (Public sector), management (Management), founder (Founding a company). Adds what people in that work earn there and how many jobs its field holds to Work and ambition, and shares the group's weight by the kind's recipe (founder: young companies, developers, graduates); each city then says why in plain sentences (work). Leave out for the same Work and ambition as everyone | |
| limit | No | How many ranked cities to describe in the summary (default 10); the ranking counts the rest | |
| cities | Yes | City ids (e.g. turin-it) or names in any common spelling (Turin, Torino, 'Paris, FR'); a name two places share needs its country | |
| detail | No | "summary" (default): verdict, ranking, weighted lines with citations, money in brief, who can move there, notes, required unknowns and next inputs. "full": every line, tax line and source, for programs | |
| preset | No | Starting weights | |
| salary | No | Your gross yearly salary, the same everywhere | |
| comfort | No | Weather: what a nice day is, for criterion nice_days: the daytime temperature range, °C (default 18-30 on the feels-like temperature; basis "air" uses the air in the shade), then the tests a day must pass. Only the person's own words: rain and sky are on unless they drop them; humidity, wind and daylight only when they ask. All from ERA5 (Open-Meteo, CC BY 4.0) and the latitude | |
| housing | No | ||
| missing | No | In fixed scoring, missing lines do not count for that city. Only with opt-in relative scoring: lowest scores gaps at the lowest compared score, worst at 0, skip drops the line for all. Money is never imputed | |
| pension | No | Share of your gross paid into a pension, 0.05 = 5%: it leaves take-home pay and is shown as saving, not cost. Tax relief is modelled for CA (RRSP), CH (pillar 3a), CZ (pension savings (penzijní spoření)), DE (occupational pension (Entgeltumwandlung)), EE (third pillar), ES (plan de pensiones), FR (PER (plan d'épargne retraite)), GB (workplace or personal pension), HU (voluntary pension fund), IE (occupational pension or PRSA), IT (fondo pensione), JP (iDeCo), NL (workplace pension), NO (IPS (individual pension savings)), PT (PPR), SG (SRS), US (401(k)); elsewhere it is not modelled and the share is counted as saving with no relief (each city's money says which) | |
| regimes | No | Newcomer tax regime per country, ISO alpha-2 -> regime id from list_metrics_and_sources. None counts unless named here; a named one is a scenario until the person's facts and confirmations meet every condition | |
| savings | No | Savings in the display currency, for runway | |
| stances | No | Where the person stands on the position lines, which score a place by its distance from them: politics 0 (left) to 10 (right); abortion 0 not allowed or only to save her life, 1 also for her health or after rape, 2 also on social or economic grounds, 3 on request in the first weeks only, 4 on request to 10 weeks or later; couples_law 0 criminalised (same-sex relations a crime), 1 legal with no union in law, 2 civil union or partnership, 3 marriage. Pass only what the person told you or what you know they hold; never guess. A stance counts once its line has a weight (they are 0 by default) | |
| weights | No | Weight 0-100 per criterion, on top of the preset. Criteria: money_left, living_cost, right_to_live, nice_days, winter_light, sunshine, dry_days, clean_air, safety, long_life, health_costs, childcare, family_leave, happiness, builders, field_pay, field_jobs, young_companies, time_zone, flight_home, airport, public_transport, rail, short_commute, cycling, walkable, active_commute, way_out, sea, mountains, green, internet, english, international, doctors, jobs, degrees, developers, qol, clean_government, politics, abortion, couples_law, founders_run, coworking, climbing, swimming, beach, run_ride, muggy, grey, hot_nights, heat, snow, wind | |
| children | No | Children's ages: childcare after public support for under-6s (OECD), child credits and allowances where the tax uses them, health for each person | |
| personal | No | Your own 1-5 lines, scores keyed by city | |
| spending | No | Monthly spending on everything except housing, childcare and health, which are counted separately | |
| household | No | Everyone moving, you first. Anyone after you can bring their own pay; a spouse counts for joint filing even with none | |
| normalise | No | Default absolute: fixed city-local scores. Relative is opt-in: adding cities can change other scores, gap handling and the shared money basis. | |
| overrides | No | Your own numbers: city -> metric id -> value; money in the city's currency. health_premium is the household's premium a month (prefer healthPremium, which takes the period); childcare_cost is the household's own childcare a month (prefer childcareCost); childcare_net_couple_1 and similar replace the OECD reference figure, a year | |
| taxTweaks | No | Per-country tax tweaks keyed by ISO alpha-2 | |
| dealBreakers | No | Must-pass criterion ids, e.g. right_to_live, money_left: a city fails, passes, or is unknown (no figure, no passport or other right given); unknown ranks after every city that passes | |
| salaryByCity | No | Gross yearly salary per city (offers or estimates), keyed by city id or name | |
| childcareCost | No | What the household actually pays for childcare in a city, after support, keyed by city id or name, in the city's currency, with per "month" or "year": replaces the OECD reference figure | |
| healthPremium | No | The household's health insurance premium bought outside pay (US, CH, NL), keyed by city id or name, in the city's currency, with per "month" or "year" (a year is counted as a twelfth a month) | |
| paidChildcare | No | Whether the household pays for childcare for its children under 6 (default true). false: no childcare cost is counted. Ask when it matters: the default prices full-time care for an OECD reference household | |
| displayCurrency | No | Currency to show amounts in (default: the salary's, else EUR) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | How this set was scored: a line on another basis or left out for every city, periods that differ | |
| cities | Yes | ||
| detail | Yes | ||
| ranking | Yes | ||
| verdict | Yes | Who leads, qualified when a must-pass is unknown, when the lead is provisional, and when money was compared on another basis | |
| moneyBasis | Yes | The money line asked for and the basis it was compared on for every city | |
| assumptions | Yes | ||
| provisional | Yes | True when missing figures, partial money or money compared on another basis could still change who leads: say so | |
| reportVersion | Yes | The report's shape version (now 2.0) | |
| displayCurrency | Yes | ||
| requiredUnknowns | Yes | ||
| provisionalReasons | Yes |