CityParity MCP
An MCP server providing tools for cost-of-living and quality-of-life comparisons, allowing AI agents to compare cities, retrieve city summaries, rank locations, and analyze safety-net deltas and tax regimes.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.cityparity.com/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to cityparity.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Compare cost of living between two cities
- Get a summary of a specific city's quality of life
- Rank cities based on cost or safety metrics
- Retrieve inbound tax regime information
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- cityparity 0.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
compare_cities — 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.
{
"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 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": {
"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
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source",
"target",
"equivalence",
"non_cash_deltas",
"quality_score",
"meta"
],
"properties": {
"meta": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"source": {
"type": "object",
"required": [
"city",
"slug",
"currency",
"gross_income",
"effective_tax_rate",
"after_tax_income",
"taxes",
"costs",
"govt_benefits",
"net_cash_annual"
],
"properties": {
"city": {
"type": "string"
},
"slug": {
"type": "string"
},
"costs": {
"type": "object",
"required": [
"housing",
"healthcare",
"childcare",
"food",
"transit",
"discretionary",
"travel_home",
"property_tax"
],
"properties": {
"food": {
"type": "number"
},
"housing": {
"type": "number"
},
"transit": {
"type": "number"
},
"childcare": {
"type": "number"
},
"healthcare": {
"type": "number"
},
"travel_home": {
"type": "number"
},
"property_tax": {
"type": "number"
},
"discretionary": {
"type": "number"
}
},
"additionalProperties": false
},
"taxes": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"currency": {
"type": "string"
},
"gross_income": {
"type": "number"
},
"govt_benefits": {
"type": "number"
},
"net_cash_annual": {
"type": "number"
},
"after_tax_income": {
"type": "number"
},
"effective_tax_rate": {
"type": "number"
}
},
"additionalProperties": false
},
"target": {
"$ref": "#/properties/source"
},
"equivalence": {
"type": "object",
"required": [
"status",
"target_salary_needed",
"household_gross",
"explanation"
],
"properties": {
"status": {
"enum": [
"solved",
"no_solution"
],
"type": "string"
},
"explanation": {
"type": "string"
},
"household_gross": {
"type": [
"number",
"null"
]
},
"target_salary_needed": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"quality_score": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"non_cash_deltas": {
"type": "array",
"items": {
"type": "object",
"required": [
"direction",
"metric",
"delta",
"text"
],
"properties": {
"note": {
"type": "string"
},
"text": {
"type": "string"
},
"delta": {
"type": "number"
},
"metric": {
"type": "string"
},
"direction": {
"enum": [
"up",
"down"
],
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_cities — 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.
{
"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
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"count",
"country_count",
"groups"
],
"properties": {
"count": {
"type": "integer"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"country",
"cities"
],
"properties": {
"cities": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
}
},
"country": {
"type": "string"
}
},
"additionalProperties": false
}
},
"country_count": {
"type": "integer"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_city_summary — 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. 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.
{
"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
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug",
"name",
"country",
"currency",
"compensation_index",
"tax",
"cost_snapshot",
"safety_net",
"govt_benefits",
"inbound_tax_regime",
"data_last_updated_field",
"data_year_range",
"methodology_url"
],
"properties": {
"tax": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"safety_net": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cost_snapshot": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"govt_benefits": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"data_year_range": {
"type": [
"string",
"null"
]
},
"methodology_url": {
"type": "string"
},
"compensation_index": {
"type": [
"number",
"null"
]
},
"inbound_tax_regime": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"data_last_updated_field": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}rank_cities — 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.
{
"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": [
"ranked",
"considered",
"skipped",
"weights",
"scenario_used",
"methodology_url"
],
"properties": {
"ranked": {
"type": "array",
"items": {
"type": "object",
"required": [
"rank",
"slug",
"city",
"country",
"currency",
"total_score",
"dimensions",
"net_cash_annual_local",
"net_cash_annual_usd",
"effective_tax_rate",
"universal_healthcare"
],
"properties": {
"city": {
"type": "string"
},
"rank": {
"type": "integer"
},
"slug": {
"type": "string"
},
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"dimensions": {
"type": "object",
"required": [
"financial",
"healthcare",
"vacation",
"childcare",
"safety_net"
],
"properties": {
"vacation": {
"type": "number"
},
"childcare": {
"type": "number"
},
"financial": {
"type": "number"
},
"healthcare": {
"type": "number"
},
"safety_net": {
"type": "number"
}
},
"additionalProperties": false
},
"total_score": {
"type": "number"
},
"effective_tax_rate": {
"type": "number"
},
"net_cash_annual_usd": {
"type": "number"
},
"parental_leave_weeks": {
"type": [
"number",
"null"
]
},
"universal_healthcare": {
"type": "boolean"
},
"net_cash_annual_local": {
"type": "number"
}
},
"additionalProperties": false
}
},
"skipped": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"reason"
],
"properties": {
"slug": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"additionalProperties": false
}
},
"weights": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"considered": {
"type": "integer"
},
"scenario_used": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"methodology_url": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_safety_net — 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 (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.
{
"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
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cities",
"methodology_url"
],
"properties": {
"cities": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"city",
"country",
"parental_leave_weeks",
"parental_leave_paid_pct",
"universal_healthcare",
"vacation_days_statutory",
"public_holidays",
"public_holidays_effective",
"public_holidays_substitute_day",
"sick_leave_policy",
"safety_net_score"
],
"properties": {
"city": {
"type": "string"
},
"slug": {
"type": "string"
},
"country": {
"type": "string"
},
"sick_leave": {
"anyOf": [
{
"type": "object",
"required": [
"statutory",
"waiting_days",
"tenure_months",
"scales_with_tenure",
"reference_period",
"paid_weeks",
"phases",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"phases": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"statutory": {
"type": "boolean"
},
"paid_weeks": {
"type": [
"number",
"null"
]
},
"waiting_days": {
"type": [
"number",
"null"
]
},
"tenure_months": {
"type": "number"
},
"reference_period": {
"type": [
"string",
"null"
]
},
"scales_with_tenure": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"public_holidays": {
"type": [
"number",
"null"
]
},
"safety_net_score": {
"type": "number"
},
"sick_leave_policy": {
"type": [
"string",
"null"
]
},
"parental_leave_flat": {
"anyOf": [
{
"type": "object",
"required": [
"weeks",
"weekly_amount",
"currency",
"label"
],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"weeks": {
"type": "number"
},
"currency": {
"type": [
"string",
"null"
]
},
"weekly_amount": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"parental_leave_note": {
"type": [
"string",
"null"
]
},
"parental_leave_basis": {
"enum": [
"percentage",
"flat",
"capped",
"mixed",
"unpaid",
"unknown",
"none"
],
"type": "string"
},
"parental_leave_weeks": {
"type": [
"number",
"null"
]
},
"universal_healthcare": {
"type": "boolean"
},
"parental_leave_capped": {
"anyOf": [
{
"type": "object",
"required": [
"weeks",
"pct",
"cap_amount",
"cap_period",
"currency",
"income_eligibility_ceiling",
"label"
],
"properties": {
"pct": {
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"weeks": {
"type": "number"
},
"currency": {
"type": [
"string",
"null"
]
},
"cap_amount": {
"type": [
"number",
"null"
]
},
"cap_period": {
"type": [
"string",
"null"
]
},
"income_eligibility_ceiling": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"parental_leave_summary": {
"type": "string"
},
"parental_leave_paid_pct": {
"type": [
"number",
"null"
]
},
"vacation_days_statutory": {
"type": [
"number",
"null"
]
},
"public_holidays_effective": {
"type": [
"number",
"null"
]
},
"public_holidays_substitute_day": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": "partial"
}
]
},
{
"type": "null"
}
]
},
"parental_leave_effective_pct_at_benchmark": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"not_found": {
"type": "array",
"items": {
"type": "string"
}
},
"score_basis": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"methodology_url": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_inbound_tax_regime — 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 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.
{
"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
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug",
"city",
"country",
"regime",
"methodology_url"
],
"properties": {
"city": {
"type": "string"
},
"slug": {
"type": "string"
},
"regime": {
"anyOf": [
{
"type": "object",
"required": [
"type",
"duration_years",
"reduction_pct",
"flat_rate",
"max_income",
"note",
"eligibility_summary"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"flat_rate": {
"type": [
"number",
"null"
]
},
"max_income": {
"type": [
"number",
"null"
]
},
"reduction_pct": {
"type": [
"number",
"null"
]
},
"duration_years": {
"type": [
"number",
"null"
]
},
"eligibility_summary": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"country": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"methodology_url": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
- 2026-11-09: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 294 ms
- 95th percentile latency
- 294 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 294 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http cityparity-mcp https://mcp.cityparity.com/mcpCodex
codex mcp add cityparity-mcp --url https://mcp.cityparity.com/mcpCursor
{
"mcpServers": {
"cityparity-mcp": {
"url": "https://mcp.cityparity.com/mcp"
}
}
}Cline
{
"mcpServers": {
"cityparity-mcp": {
"type": "streamableHttp",
"url": "https://mcp.cityparity.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"cityparity-mcp": {
"type": "http",
"url": "https://mcp.cityparity.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http cityparity-mcp https://mcp.cityparity.com/mcpClaude Desktop
https://mcp.cityparity.com/mcpWindsurf
{
"mcpServers": {
"cityparity-mcp": {
"serverUrl": "https://mcp.cityparity.com/mcp"
}
}
}Let your agent find its tools
Find servers like CityParity MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run CityParity MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.