cityparity — Cost-of-Living & Quality-of-Life Comparison

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

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
97%
命名品質
93%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

根據工具定義與協定合規性的自動化分析。

上下文成本

~5,392Token(工具定義)
~8.4 KB典型回應大小
顯著的注意力影響(128k 上下文的 4.21%)

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案:

{
  "mcpServers": {
    "cityparity": {
      "url": "https://mcp.cityparity.com/mcp"
    }
  }
}

遠端端點

https://mcp.cityparity.com/mcpstreamable-http

它能做什麼

工具清單

工具(6)

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢compare_cities(source_city, target_city, gross_salary, household, living, ...)

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",
  "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 city; e.g. Seattle defaults to 'car', Oslo defaults 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#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "source": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "gross_income": {
          "type": "number"
        },
        "effective_tax_rate": {
          "type": "number"
        },
        "after_tax_income": {
          "type": "number"
        },
        "taxes": {
          "type": "object",
          "properties": {},
          "additionalProperties": true
        },
        "costs": {
          "type": "object",
          "properties": {
            "housing": {
              "type": "number"
            },
            "healthcare": {
              "type": "number"
            },
            "childcare": {
              "type": "number"
            },
            "food": {
              "type": "number"
            },
            "transit": {
              "type": "number"
            },
            "discretionary": {
              "type": "number"
            },
            "travel_home": {
              "type": "number"
            },
            "property_tax": {
              "type": "number"
            }
          },
          "required": [
            "housing",
            "healthcare",
            "childcare",
            "food",
            "transit",
            "discretionary",
            "travel_home",
            "property_tax"
          ],
          "additionalProperties": false
        },
        "govt_benefits": {
          "type": "number"
        },
        "net_cash_annual": {
          "type": "number"
        }
      },
      "required": [
        "city",
        "slug",
        "currency",
        "gross_income",
        "effective_tax_rate",
        "after_tax_income",
        "taxes",
        "costs",
        "govt_benefits",
        "net_cash_annual"
      ],
      "additionalProperties": false
    },
    "target": {
      "$ref": "#/properties/source"
    },
    "equivalence": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "solved",
            "no_solution"
          ]
        },
        "target_salary_needed": {
          "type": [
            "number",
            "null"
          ]
        },
        "household_gross": {
          "type": [
            "number",
            "null"
          ]
        },
        "explanation": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "target_salary_needed",
        "household_gross",
        "explanation"
      ],
      "additionalProperties": false
    },
    "non_cash_deltas": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "direction": {
            "type": "string",
            "enum": [
              "up",
              "down"
            ]
          },
          "metric": {
            "type": "string"
          },
          "delta": {
            "type": "number"
          },
          "text": {
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "direction",
          "metric",
          "delta",
          "text"
        ],
        "additionalProperties": false
      }
    },
    "quality_score": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "meta": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    }
  },
  "required": [
    "source",
    "target",
    "equivalence",
    "non_cash_deltas",
    "quality_score",
    "meta"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_cities(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",
  "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,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "country_count": {
      "type": "integer"
    },
    "groups": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "cities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "name"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "country",
          "cities"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "count",
    "country_count",
    "groups"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_city_summary(city)

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

輸入結構描述

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "City slug. Use list_cities to discover valid slugs."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "compensation_index": {
      "type": [
        "number",
        "null"
      ]
    },
    "tax": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "cost_snapshot": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "safety_net": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "govt_benefits": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "inbound_tax_regime": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "data_last_updated_field": {
      "type": [
        "string",
        "null"
      ]
    },
    "data_year_range": {
      "type": [
        "string",
        "null"
      ]
    },
    "methodology_url": {
      "type": "string"
    }
  },
  "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"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢rank_cities(weights, filter, scenario, limit)

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",
  "properties": {
    "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."
    },
    "filter": {
      "type": "object",
      "properties": {
        "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."
        },
        "region": {
          "type": "string",
          "enum": [
            "europe",
            "asia",
            "north_america",
            "south_america",
            "oceania"
          ],
          "description": "Restrict to one region."
        },
        "has_universal_healthcare": {
          "type": "boolean",
          "description": "If true, only return cities with universal healthcare; if false, only without."
        },
        "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."
        },
        "exclude_cities": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 64
          },
          "maxItems": 100,
          "description": "Skip these specific city slugs from the result."
        }
      },
      "additionalProperties": false,
      "description": "Restrict which cities are ranked, by country, region, universal-healthcare flag, or explicit include/exclude slug lists. Omit to rank all supported cities."
    },
    "scenario": {
      "type": "object",
      "properties": {
        "gross_salary_usd": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 5000000,
          "description": "USD-equivalent salary to model in each city (converts to local currency). Default 100000."
        },
        "has_partner": {
          "type": "boolean",
          "description": "Default false."
        },
        "partner_gross_salary_usd": {
          "type": "number",
          "minimum": 0,
          "maximum": 5000000,
          "description": "Required when has_partner=true."
        },
        "kids_ages": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0,
            "maximum": 25
          },
          "maxItems": 10,
          "description": "Default []."
        },
        "bedrooms": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5,
          "description": "Default 2."
        },
        "housing_mode": {
          "type": "string",
          "enum": [
            "rent",
            "own",
            "own_outright"
          ],
          "description": "Default rent."
        },
        "lifestyle": {
          "type": "string",
          "enum": [
            "frugal",
            "typical",
            "generous"
          ],
          "description": "Default typical."
        }
      },
      "additionalProperties": false,
      "description": "Override the default ranking scenario. The same scenario is applied to every city so scores are comparable."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results to return. Default 10."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "ranked": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer"
          },
          "slug": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "total_score": {
            "type": "number"
          },
          "dimensions": {
            "type": "object",
            "properties": {
              "financial": {
                "type": "number"
              },
              "healthcare": {
                "type": "number"
              },
              "vacation": {
                "type": "number"
              },
              "childcare": {
                "type": "number"
              },
              "safety_net": {
                "type": "number"
              }
            },
            "required": [
              "financial",
              "healthcare",
              "vacation",
              "childcare",
              "safety_net"
            ],
            "additionalProperties": false
          },
          "net_cash_annual_local": {
            "type": "number"
          },
          "net_cash_annual_usd": {
            "type": "number"
          },
          "effective_tax_rate": {
            "type": "number"
          },
          "universal_healthcare": {
            "type": "boolean"
          },
          "parental_leave_weeks": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "rank",
          "slug",
          "city",
          "country",
          "currency",
          "total_score",
          "dimensions",
          "net_cash_annual_local",
          "net_cash_annual_usd",
          "effective_tax_rate",
          "universal_healthcare"
        ],
        "additionalProperties": false
      }
    },
    "considered": {
      "type": "integer"
    },
    "skipped": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "reason"
        ],
        "additionalProperties": false
      }
    },
    "weights": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "scenario_used": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "methodology_url": {
      "type": "string"
    }
  },
  "required": [
    "ranked",
    "considered",
    "skipped",
    "weights",
    "scenario_used",
    "methodology_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_safety_net(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",
  "properties": {
    "cities": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "minItems": 1,
      "maxItems": 20,
      "description": "Array of city slugs (1-20). Use list_cities to discover valid slugs."
    }
  },
  "required": [
    "cities"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "cities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "parental_leave_weeks": {
            "type": [
              "number",
              "null"
            ]
          },
          "parental_leave_paid_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "parental_leave_basis": {
            "type": "string",
            "enum": [
              "percentage",
              "flat",
              "capped",
              "mixed",
              "unpaid",
              "unknown",
              "none"
            ]
          },
          "parental_leave_flat": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "weeks": {
                    "type": "number"
                  },
                  "weekly_amount": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "label": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "weeks",
                  "weekly_amount",
                  "currency",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "parental_leave_capped": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "weeks": {
                    "type": "number"
                  },
                  "pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "cap_amount": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "cap_period": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "income_eligibility_ceiling": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "label": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "weeks",
                  "pct",
                  "cap_amount",
                  "cap_period",
                  "currency",
                  "income_eligibility_ceiling",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "parental_leave_effective_pct_at_benchmark": {
            "type": [
              "number",
              "null"
            ]
          },
          "parental_leave_summary": {
            "type": "string"
          },
          "parental_leave_note": {
            "type": [
              "string",
              "null"
            ]
          },
          "universal_healthcare": {
            "type": "boolean"
          },
          "vacation_days_statutory": {
            "type": [
              "number",
              "null"
            ]
          },
          "public_holidays": {
            "type": [
              "number",
              "null"
            ]
          },
          "public_holidays_effective": {
            "type": [
              "number",
              "null"
            ]
          },
          "public_holidays_substitute_day": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "string",
                    "const": "partial"
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "sick_leave_policy": {
            "type": [
              "string",
              "null"
            ]
          },
          "sick_leave": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "statutory": {
                    "type": "boolean"
                  },
                  "waiting_days": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "tenure_months": {
                    "type": "number"
                  },
                  "scales_with_tenure": {
                    "type": "boolean"
                  },
                  "reference_period": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "paid_weeks": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "phases": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true
                    }
                  },
                  "note": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "statutory",
                  "waiting_days",
                  "tenure_months",
                  "scales_with_tenure",
                  "reference_period",
                  "paid_weeks",
                  "phases",
                  "note"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "safety_net_score": {
            "type": "number"
          }
        },
        "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"
        ],
        "additionalProperties": false
      }
    },
    "not_found": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "score_basis": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "methodology_url": {
      "type": "string"
    }
  },
  "required": [
    "cities",
    "methodology_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_inbound_tax_regime(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",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "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."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "regime": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string"
            },
            "duration_years": {
              "type": [
                "number",
                "null"
              ]
            },
            "reduction_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "flat_rate": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_income": {
              "type": [
                "number",
                "null"
              ]
            },
            "note": {
              "type": [
                "string",
                "null"
              ]
            },
            "eligibility_summary": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "type",
            "duration_years",
            "reduction_pct",
            "flat_rate",
            "max_income",
            "note",
            "eligibility_summary"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "methodology_url": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "city",
    "country",
    "regime",
    "methodology_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本6 個工具
已驗證未記錄版本6 個工具
已驗證未記錄版本6 個工具