Cost-of-living & quality-of-life comparison: take-home pay, equivalent salary, safety-net deltas.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Compare two cities for one household: take-home pay, full cost breakdown, the equivalent target salary needed to match source net cash, non-cash lifestyle deltas (vacation, parental leave, healthcare), and a 0-100 quality score on five weighted dimensions. Use this for a head-to-head between two named cities; for a single city call get_city_summary, and to rank many cities call rank_cities. Read-only, no side effects; returns a text summary plus structured JSON. RSU income is NOT a parameter; RSU is treated as source-only because grants typically do not follow you across employers.
City slug for the user's current city. Use list_cities to discover valid slugs (e.g. 'nyc', 'seattle', 'tokyo').
City slug for the destination city.
User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo).
Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending.
Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults.
Family structure: working-age partner and dependent children. Omit for a single person with no kids.
Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20.
Compare two cities for one household: take-home pay, full cost breakdown, the equivalent target salary needed to match source net cash, non-cash lifestyle deltas (vacation, parental leave, healthcare), and a 0-100 quality score on five weighted dimensions. Use this for a head-to-head between two named cities; for a single city call get_city_summary, and to rank many cities call rank_cities. Read-only, no side effects; returns a text summary plus structured JSON. RSU income is NOT a parameter; RSU is treated as source-only because grants typically do not follow you across employers.
| Argument | Type | Description |
|---|---|---|
| living | object | Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending. |
| advanced | object | Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults. |
| household | object | Family structure: working-age partner and dependent children. Omit for a single person with no kids. |
| source_city* | string | City slug for the user's current city. Use list_cities to discover valid slugs (e.g. 'nyc', 'seattle', 'tokyo'). |
| target_city* | string | City slug for the destination city. |
| gross_salary* | number | User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo). |
| score_weights | object | Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source_city",
"target_city",
"gross_salary"
],
"properties": {
"living": {
"type": "object",
"properties": {
"bedrooms": {
"type": "integer",
"maximum": 5,
"minimum": 0,
"description": "Bedroom count for the household. Default 2."
},
"lifestyle": {
"enum": [
"frugal",
"typical",
"generous"
],
"type": "string",
"description": "Spending multiplier on food and discretionary categories. Default typical (1.0×)."
},
"housing_mode": {
"enum": [
"rent",
"own",
"own_outright"
],
"type": "string",
"description": "Whether the household rents or owns. Default rent."
}
},
"description": "Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending.",
"additionalProperties": false
},
"advanced": {
"type": "object",
"properties": {
"age_bracket": {
"enum": [
"18-24",
"25-34",
"35-44",
"45-54",
"55-64"
],
"type": "string",
"description": "Affects US healthcare premium multipliers. Default 25-34."
},
"trips_home_per_year": {
"type": "integer",
"maximum": 12,
"minimum": 0,
"description": "Round trips back to source country per year (target-only cost). Default 1."
},
"apply_inbound_regime": {
"type": "boolean",
"description": "Apply the destination country's special inbound-worker tax regime if available (Italy impatriati, Portugal IFICI, Belgium expat, Poland B2B ryczałt, Greece inbound). Default false. Applies only on the target side."
},
"source_transit_choice": {
"enum": [
"car",
"transit"
],
"type": "string",
"description": "Default depends on city; e.g. Seattle defaults to 'car', Oslo defaults to 'transit'."
},
"target_transit_choice": {
"enum": [
"car",
"transit"
],
"type": "string",
"description": "Same as above for the target city."
},
"retirement_contrib_pct": {
"type": "number",
"maximum": 50,
"minimum": 0,
"description": "Percentage of gross diverted to retirement (pre-tax for US 401k). Default 6."
}
},
"description": "Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults.",
"additionalProperties": false
},
"household": {
"type": "object",
"properties": {
"kids_ages": {
"type": "array",
"items": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"maxItems": 10,
"description": "Ages of dependent children, e.g. [3, 7]. Empty array or omitted if no kids."
},
"has_partner": {
"type": "boolean",
"description": "Whether the user has a working-age partner. Defaults to false."
},
"partner_gross_salary": {
"type": "number",
"maximum": 50000000,
"minimum": 0,
"description": "Partner's annual gross salary in the SOURCE city's currency. REQUIRED when has_partner=true."
},
"partner_works_in_source": {
"type": "boolean",
"description": "Whether the partner currently earns in the source city. REQUIRED when has_partner=true; cityparity does not default this because spouse-per-city working status materially changes the math (e.g. US childcare may exceed a second income, while Nordic subsidies make the second income viable)."
},
"partner_works_in_target": {
"type": "boolean",
"description": "Whether the partner would earn in the target city after relocation. REQUIRED when has_partner=true."
}
},
"description": "Family structure: working-age partner and dependent children. Omit for a single person with no kids.",
"additionalProperties": false
},
"source_city": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "City slug for the user's current city. Use list_cities to discover valid slugs (e.g. 'nyc', 'seattle', 'tokyo')."
},
"target_city": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "City slug for the destination city."
},
"gross_salary": {
"type": "number",
"maximum": 50000000,
"description": "User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo).",
"exclusiveMinimum": 0
},
"score_weights": {
"type": "object",
"properties": {
"vacation": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"childcare": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"financial": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"healthcare": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"safety_net": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"description": "Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20.",
"additionalProperties": false
}
},
"additionalProperties": false
}Concise profile of one city: currency, tax shape (bracket count + top rate + payroll/national insurance), headline costs (rent / groceries / transit / childcare), safety-net values (parental leave, vacation, universal healthcare), and data freshness. Lighter than compare_cities; use when the user is asking about one place rather than a comparison. On parental leave, quote safety_net.parental_leave_summary rather than building your own sentence: some countries (Ireland, Australia, the UK, Czechia, part of Sweden) pay a flat weekly cash sum instead of a share of salary, so parental_leave_paid_pct is 0 or partial for them and stating it alone would wrongly call their leave unpaid. safety_net.avg_commute_minutes is a ONE-WAY commute, a single leg rather than a daily round trip: report it as "about N minutes each way", and double it yourself if the user asked what they spend commuting per day. It is door to door, averaged over every commuter regardless of mode, for the metro area, and excludes people who work from home. Childcare monthly fields are raw rates before modeled help. When childcare_income_tested or child_benefits_income_tested is present, use compare_cities with household income and child ages to price the rules; a flat subsidy or allowance alone is incomplete. Read-only, no side effects; returns a text summary plus structured JSON.
| Argument | Type | Description |
|---|---|---|
| city* | string | City slug. Use list_cities to discover valid slugs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "City slug. Use list_cities to discover valid slugs."
}
},
"additionalProperties": false
}Look up a city's inbound-worker tax regime, the special reduced-tax schemes for relocating workers that general cost-of-living tools do not surface. Returns regime=null when the country has no modeled regime, which is most cities. Modeled across 13 regimes in Belgium, Denmark, Germany, Greece, Ireland, Italy, Netherlands, Norway, Poland, Portugal, Spain, Sweden and the UK. Roughly half grant an actual reduction (a reduction_pct or a flat_rate) and the rest are note-only: the regime exists but grants a relocating employee nothing, so reduction_pct and flat_rate are null and the take-home is computed on ordinary tax. Each entry returns the mechanic, duration, income cap if any, and a note stating the salary floor where one exists and which eligibility conditions we do not test. Read-only, no side effects; returns a text summary plus structured JSON.
| Argument | Type | Description |
|---|---|---|
| city* | string | City slug. Use list_cities to discover valid slugs. Most cities return regime=null because their country has no special inbound-worker tax regime. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "City slug. Use list_cities to discover valid slugs. Most cities return regime=null because their country has no special inbound-worker tax regime."
}
},
"additionalProperties": false
}Batch lookup of safety-net values for 1 to 20 cities at once: parental leave weeks + how it is paid, universal healthcare flag, vacation days, public holidays (public_holidays is the count the statute lists; public_holidays_effective is how many of those fall on a working day once you account for whether the country replaces a weekend holiday, so quote the effective figure whenever you compare two places on time off), plus each city's safety_net dimension score (0-100) for relative strength. This is the only tool that accepts many cities in one call: use it to line several places up on family / leave / healthcare benefits. On parental leave, quote parental_leave_summary rather than composing your own line from parental_leave_paid_pct: Ireland, Australia, the UK, Czechia and part of Sweden pay a flat weekly cash sum instead of a share of salary, so their headline percentage is 0 or partial and reading it alone would wrongly call their leave unpaid; Germany pays a percentage up to a monthly cap (parental_leave_capped) and pays nothing at all above a household-income ceiling. Check parental_leave_basis (percentage / flat / capped / mixed / unpaid) before making any claim about pay. On sick pay, quote sick_leave_policy rather than composing your own line from sick_leave.phases: it is the STATUTORY FLOOR for someone in their first year of service, phases run one AFTER another rather than stacking, and the durations carry units that differ by country (Slovenia counts working days, Denmark counts calendar days), so sick_leave.paid_weeks is deliberately null wherever the phases are measured against different reference periods and no single total exists. For one city's full profile (tax shape + costs + safety net together) call get_city_summary instead; for a two-city head-to-head that includes cost-of-living use compare_cities. Read-only, no side effects; returns a text summary plus structured JSON.
| Argument | Type | Description |
|---|---|---|
| cities* | array | Array of city slugs (1-20). Use list_cities to discover valid slugs. |
List all city slugs supported by cityparity, grouped by country. Call this first to discover valid slugs before any other tool; the optional country filter narrows to one country. Read-only, no side effects; returns a text summary plus structured JSON.
| Argument | Type | Description |
|---|---|---|
| country | string | Optional case-insensitive country filter. Use the canonical name as stored in city_data.country (e.g. "Norway", "USA", "United Kingdom"). If omitted, returns all countries. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country": {
"type": "string",
"maxLength": 64,
"description": "Optional case-insensitive country filter. Use the canonical name as stored in city_data.country (e.g. \"Norway\", \"USA\", \"United Kingdom\"). If omitted, returns all countries."
}
},
"additionalProperties": false
}Rank supported cities by composite quality-of-life score across five weighted dimensions (financial, healthcare, vacation, childcare, safety_net). Returns top N (default 10), with filters for country, countries, region (europe/asia/north_america/south_america/oceania), has_universal_healthcare, include_cities, and exclude_cities. Use this to shortlist across many cities; for a head-to-head between two named cities use compare_cities. The same scenario is applied to every city so scores are directly comparable (default: single person, 2BR rent, $100k USD-equivalent gross). Read-only, no side effects; returns a text summary plus structured JSON.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results to return. Default 10. |
| filter | object | Restrict which cities are ranked, by country, region, universal-healthcare flag, or explicit include/exclude slug lists. Omit to rank all supported cities. |
| weights | object | Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20. |
| scenario | object | Override the default ranking scenario. The same scenario is applied to every city so scores are comparable. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results to return. Default 10."
},
"filter": {
"type": "object",
"properties": {
"region": {
"enum": [
"europe",
"asia",
"north_america",
"south_america",
"oceania"
],
"type": "string",
"description": "Restrict to one region."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "Restrict to one country (case-insensitive match against city_data.country, e.g. \"Germany\", \"USA\", \"United Kingdom\")."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 50,
"description": "Restrict to multiple countries."
},
"exclude_cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 100,
"description": "Skip these specific city slugs from the result."
},
"include_cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 100,
"description": "Restrict to a specific set of city slugs. Combined with other filters via intersection."
},
"has_universal_healthcare": {
"type": "boolean",
"description": "If true, only return cities with universal healthcare; if false, only without."
}
},
"description": "Restrict which cities are ranked, by country, region, universal-healthcare flag, or explicit include/exclude slug lists. Omit to rank all supported cities.",
"additionalProperties": false
},
"weights": {
"type": "object",
"properties": {
"vacation": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"childcare": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"financial": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"healthcare": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"safety_net": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"description": "Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20.",
"additionalProperties": false
},
"scenario": {
"type": "object",
"properties": {
"bedrooms": {
"type": "integer",
"maximum": 5,
"minimum": 0,
"description": "Default 2."
},
"kids_ages": {
"type": "array",
"items": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"maxItems": 10,
"description": "Default []."
},
"lifestyle": {
"enum": [
"frugal",
"typical",
"generous"
],
"type": "string",
"description": "Default typical."
},
"has_partner": {
"type": "boolean",
"description": "Default false."
},
"housing_mode": {
"enum": [
"rent",
"own",
"own_outright"
],
"type": "string",
"description": "Default rent."
},
"gross_salary_usd": {
"type": "number",
"maximum": 5000000,
"description": "USD-equivalent salary to model in each city (converts to local currency). Default 100000.",
"exclusiveMinimum": 0
},
"partner_gross_salary_usd": {
"type": "number",
"maximum": 5000000,
"minimum": 0,
"description": "Required when has_partner=true."
}
},
"description": "Override the default ranking scenario. The same scenario is applied to every city so scores are comparable.",
"additionalProperties": false
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cities"
],
"properties": {
"cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 20,
"minItems": 1,
"description": "Array of city slugs (1-20). Use list_cities to discover valid slugs."
}
},
"additionalProperties": false
}