cityparity — Cost-of-Living & Quality-of-Life Comparison
v0.1.0Cost-of-living & quality-of-life comparison: take-home pay, equivalent salary, safety-net deltas.
Endpoint health
online- Last checked
- 11/20/2026, 6:16:51 AM
- Latency
- 119 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.cityparity%2Fcityparity
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.cityparity/cityparity": {
"url": "https://mcp.cityparity.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
6 shown · authentication unknown
Compare two cities for a household
compare_cities
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.
Schema valid · SHA-256 958d6d692b0a…
View input schema
{ "type": "object", "properties": { "source_city": { "type": "string", "minLength": 1, "maxLength": 64, "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", "minLength": 1, "maxLength": 64, "description": "City slug for the destination city." }, "gross_salary": { "type": "number", "exclusiveMinimum": 0, "maximum": 50000000, "description": "User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo)." }, "household": { "type": "object", "properties": { "has_partner": { "type": "boolean", "description": "Whether the user has a working-age partner. Defaults to false." }, "partner_gross_salary": { "type": "number", "minimum": 0, "maximum": 50000000, "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." }, "kids_ages": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 25 }, "maxItems": 10, "description": "Ages of dependent children, e.g. [3, 7]. Empty array or omitted if no kids." } }, "additionalProperties": false, "description": "Family structure: working-age partner and dependent children. Omit for a single person with no kids." }, "living": { "type": "object", "properties": { "housing_mode": { "type": "string", "enum": [ "rent", "own", "own_outright" ], "description": "Whether the household rents or owns. Default rent." }, "bedrooms": { "type": "integer", "minimum": 0, "maximum": 5, "description": "Bedroom count for the household. Default 2." }, "lifestyle": { "type": "string", "enum": [ "frugal", "typical", "generous" ], "description": "Spending multiplier on food and discretionary categories. Default typical (1.0×)." } }, "additionalProperties": false, "description": "Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending." }, "advanced": { "type": "object", "properties": { "retirement_contrib_pct": { "type": "number", "minimum": 0, "maximum": 50, "description": "Percentage of gross diverted to retirement (pre-tax for US 401k). Default 6." }, "age_bracket": { "type": "string", "enum": [ "18-24", "25-34", "35-44", "45-54", "55-64" ], "description": "Affects US healthcare premium multipliers. Default 25-34." }, "trips_home_per_year": { "type": "integer", "minimum": 0, "maximum": 12, "description": "Round trips back to source country per year (target-only cost). Default 1." }, "source_transit_choice": { "type": "string", "enum": [ "car", "transit" ], "description": "Default depends on the city, the same rule the cityparity calculator uses: 'car' (the city's annual car-ownership cost) where the metro is car-dependent, 'transit' (a monthly pass per traveller) everywhere else. Seattle defaults to 'car', Oslo and New York to 'transit'." }, "target_transit_choice": { "type": "string", "enum": [ "car", "transit" ], "description": "Same as above for the target city." }, "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." } }, "additionalProperties": false, "description": "Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults." }, "score_weights": { "type": "object", "properties": { "financial": { "type": "number", "minimum": 0, "maximum": 100 }, "healthcare": { "type": "number", "minimum": 0, "maximum": 100 }, "vacation": { "type": "number", "minimum": 0, "maximum": 100 }, "childcare": { "type": "number", "minimum": 0, "maximum": 100 }, "safety_net": { "type": "number", "minimum": 0, "maximum": 100 } }, "additionalProperties": false, "description": "Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20." } }, "required": [ "source_city", "target_city", "gross_salary" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }
Connections
streamable-http
https://mcp.cityparity.com/mcp