Compare two cities for a household
compare_citiesGet a detailed head-to-head comparison of two cities: take-home pay, full cost breakdown, equivalent target salary, non-cash lifestyle deltas, and a quality score on five weighted dimensions for your household.
Instructions
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 Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source_city | Yes | City slug for the user's current city. Use list_cities to discover valid slugs (e.g. 'nyc', 'seattle', 'tokyo'). | |
| target_city | Yes | City slug for the destination city. | |
| gross_salary | Yes | User's annual gross salary in the SOURCE city's local currency (e.g. USD for Seattle, NOK for Oslo). | |
| household | No | Family structure: working-age partner and dependent children. Omit for a single person with no kids. | |
| living | No | Housing and spending assumptions. Omit to use defaults: rent, 2 bedrooms, typical spending. | |
| advanced | No | Optional fine-tuning: retirement contribution, age bracket, trips home, transit mode, and inbound tax regime. Omit to use defaults. | |
| score_weights | No | Override the composite-score weights. Defaults: financial 30, healthcare 20, vacation 15, childcare 15, safety_net 20. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | ||
| target | Yes | ||
| equivalence | Yes | ||
| non_cash_deltas | Yes | ||
| quality_score | Yes | ||
| meta | Yes |