Hosted MCP server · #30 most used on Smithery

cityparity

bissell-skyler/cityparity

cityparity compares two cities on the numbers that actually decide a move. Give it a salary and a family situation and it returns take-home pay, a full cost breakdown (housing, healthcare, childcare, food, transit, travel home, property tax), the equivalent salary you'd need in the target city, and the non-cash deltas people move for: statutory vacation, parental leave, and universal healthcare. It can also rank cities by a composite quality score and look up inbound-worker tax regimes (Italy impatriati, Portugal IFICI, and others). About 165 cities across 69 countries. Free, no API key, hosted Streamable HTTP.

Backend & APIs Research & science

Install ↓Smithery ↗Website ↗

Uses: 12k
Tools: 6
Runs: Hosted
Listed: 5mo ago

Get started

Add it to your agent

npx -y @smithery/cli@latest install bissell-skyler/cityparity --client claude

Swap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.

claude mcp add --transport http cityparity https://server.smithery.ai/bissell-skyler/cityparity/mcp

A hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.

[mcp_servers.cityparity]
url = "https://server.smithery.ai/bissell-skyler/cityparity/mcp"

Add to ~/.codex/config.toml.

{
  "mcpServers": {
    "cityparity": {
      "url": "https://server.smithery.ai/bissell-skyler/cityparity/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json.

{
  "servers": {
    "cityparity": {
      "type": "http",
      "url": "https://server.smithery.ai/bissell-skyler/cityparity/mcp"
    }
  }
}

Add to .vscode/mcp.json.

gemini mcp add --transport http cityparity https://server.smithery.ai/bissell-skyler/cityparity/mcp

Saved to .gemini/settings.json.

What it can do

6 tools

compare_cities7 paramsCompare two cities for one household: take-home pay, full cost breakdown, the equivalent target salary needed to match source net cash, n…

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; RS

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

list_cities1 paramList all city slugs supported by cityparity, grouped by country. Call this first to discover valid slugs before any other tool; the optio…

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.

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

get_city_summary1 paramConcise profile of one city: currency, tax shape (bracket count + top rate + payroll/national insurance), headline costs (rent / grocerie…

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. Read-only, no side effects; returns a text summary plus structured JSON.

Parameter	Type	Description
`city`	string	City slug. Use list_cities to discover valid slugs.

rank_cities4 paramsRank supported cities by composite quality-of-life score across five weighted dimensions (financial, healthcare, vacation, childcare, saf…

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 direc

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

get_safety_net1 paramLook up safety-net values (parental leave weeks + paid percentage, universal healthcare flag, vacation days, public holidays) for 1-20 ci…

Look up safety-net values (parental leave weeks + paid percentage, universal healthcare flag, vacation days, public holidays) for 1-20 cities, plus the safety_net dimension score (0-100) for relative strength. Use when the user is asking specifically about family / leave / healthcare benefits rather than a full cost-of-living comparison. Read-only, no side effects; returns a text summary plus structured JSON.

Parameter	Type	Description
`cities`	array	Array of city slugs (1-20). Use list_cities to discover valid slugs.

get_inbound_tax_regime1 paramLook up a city's inbound-worker tax regime, the special reduced-tax schemes for relocating workers that general cost-of-living tools do n…

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 null when the country has no modeled regime (most cities). Modeled regimes: Italy impatriati (Milan, Rome), Portugal IFICI (Lisbon, Porto), Belgium expat (Brussels), Poland B2B ryczałt (Warsaw, Kraków), Greece inbound (Athens). Each entry includes the mechanic (reduction percentage or flat rate), duration, income cap if any, and a conservati

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