# cityparity — Cost-of-Living & Quality-of-Life Comparison (remote · mcp.cityparity.com)

Cost-of-living & quality-of-life comparison: take-home pay, equivalent salary, safety-net deltas.

- Trust score: 67/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.cityparity.com`: 67/100 (this document), [markdown](https://verifymcp.io/servers/com-cityparity-cityparity/mcp.md), [page](https://verifymcp.io/servers/com-cityparity-cityparity/mcp)

## Channel facts

- Endpoint: `https://mcp.cityparity.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1399 tokens (~233/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http com-cityparity-cityparity https://mcp.cityparity.com/mcp
```

### Codex

```toml
[mcp_servers.com-cityparity-cityparity]
url = "https://mcp.cityparity.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-cityparity-cityparity": {
      "type": "remote",
      "url": "https://mcp.cityparity.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-cityparity-cityparity --url https://mcp.cityparity.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-cityparity-cityparity:
    url: "https://mcp.cityparity.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-cityparity-cityparity": {
      "type": "http",
      "url": "https://mcp.cityparity.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 67, 0)

- [security] Tool “get_city_summary” rewrote its description, which is the text the model reads
- [security] Tool “get_safety_net” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 206 → 233

### 2026-08-02 (score 67, 0)

- [security] Tool “get_safety_net” rewrote its description, which is the text the model reads

### 2026-07-31 (score 67, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-29 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 64, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 63)

First indexed and scored.

## MCP tools (6)

### `compare_cities` (~340 tokens)

Compare two cities for a household

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.

Input parameters:

- `advanced` (object): Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults.
- `gross_salary` (number, required): User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo).
- `household` (object): Family structure: working-age partner and dependent children. Omit for a single person with no kids.
- `living` (object): Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending.
- `score_weights` (object): Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20.
- `source_city` (string, required): City slug for the user's current city. Use list_cities to discover valid slugs (e.g. 'nyc', 'seattle', 'tokyo').
- `target_city` (string, required): City slug for the destination city.

Output parameters:

- `equivalence` (object)
- `meta` (object)
- `non_cash_deltas` (array)
- `quality_score` (object)
- `source` (object)
- `target`

### `list_cities` (~107 tokens)

List supported cities by country

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.

Input parameters:

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

Output parameters:

- `count` (integer)
- `country_count` (integer)
- `groups` (array)

### `get_city_summary` (~187 tokens)

Get a one-city profile

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

Input parameters:

- `city` (string, required): City slug. Use list_cities to discover valid slugs.

Output parameters:

- `compensation_index` (number|null)
- `cost_snapshot` (object)
- `country` (string)
- `currency` (string)
- `data_last_updated_field` (string|null)
- `data_year_range` (string|null)
- `govt_benefits` (object)
- `inbound_tax_regime`
- `methodology_url` (string)
- `name` (string)
- `safety_net` (object)
- `slug` (string)
- `tax` (object)

### `rank_cities` (~265 tokens)

Rank cities by composite quality score

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.

Input parameters:

- `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.
- `limit` (integer): Max results to return. Default 10.
- `scenario` (object): Override the default ranking scenario. The same scenario is applied to every city so scores are comparable.
- `weights` (object): Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20.

Output parameters:

- `considered` (integer)
- `methodology_url` (string)
- `ranked` (array)
- `scenario_used` (object)
- `skipped` (array)
- `weights` (object)

### `get_safety_net` (~255 tokens)

Look up family safety net for several cities

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, 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. Check parental_leave_basis (percentage / flat / mixed / unpaid) before making any claim about pay. 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.

Input parameters:

- `cities` (array, required): Array of city slugs (1-20). Use list_cities to discover valid slugs.

Output parameters:

- `cities` (array)
- `methodology_url` (string)
- `not_found` (array)
- `score_basis` (object)

### `get_inbound_tax_regime` (~181 tokens)

Look up inbound-worker tax regime for a city

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

Input parameters:

- `city` (string, required): City slug. Use list_cities to discover valid slugs. Most cities return regime=null because their country has no special inbound-worker tax regime.

Output parameters:

- `city` (string)
- `country` (string)
- `disclaimer` (string)
- `methodology_url` (string)
- `regime`
- `slug` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-cityparity-cityparity/mcp#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 67
- 2026-07-31: 67
- 2026-07-30: 66
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 64
- 2026-07-26: 63

## Links

- Remote endpoint: https://mcp.cityparity.com/mcp
- Repository: https://github.com/summerstateofmind/cityparity
- Changelog RSS feed: https://verifymcp.io/servers/com-cityparity-cityparity/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-cityparity-cityparity/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-cityparity-cityparity/mcp