Suggest cities for me
suggest_citiesRank all published cities by the current profile: top five not already in cities, with their two biggest observed score contributions. Same inputs as compare_cities; cities may be empty. Fixed scoring by default; Weather uses your nice-day definition. Missing lines do not count there: check coverage before deciding.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "suggest_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 | No | Already chosen cities to exclude, if any | |
| 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 |
|---|---|---|---|
| reportVersion | Yes | The report's shape version (now 2.0) |