ch.swisslivingindex/swiss-living-index

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Official Swiss data for all 26 cantons and 2,100 communes: tax, rent, health premiums, fuel, jobs.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "swiss-living-index": {
      "url": "https://swisslivingindex.ch/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (72)

• list_metrics read-only

  List every metric available for the 26 Swiss cantons: key, label, unit, official source and whether higher or lower is better. Call this first to find the metric key for rank_by_metric, get_canton or get_trend.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rent_index read-only

  Rent index per Swiss canton: BFS average rent of occupied rented flats (structural survey, existing rents, not asking rents) by canton and number of rooms with the 95% confidence interval, 2010 onwards, plus a size-standardised rent (DERIVED by Swiss Living Index: each canton weighted with one fixed Swiss mix of dwellings by rooms) as a level index (Switzerland = 100) and change index (first year = 100), growth over 5 years and since 2010, vacancy rate and the national CPI rent index. With canton: its full yearly series; without: all cantons ranked. Also the rent statistics Basel-Stadt (quarterly rent index, year-on-year), Geneva (rent index since 1995 and average rent by rooms; Geneva counts the kitchen as a room) and the city of Zurich (median and mean net rent for 2, 3 and 4 rooms, non-profit vs other, every two years) publish themselves, each with its own definition and licence.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• ahv_pension read-only

  Swiss AHV/AVS old-age pension (1st pillar): minimum and maximum monthly pension, the 13th AHV pension (first paid December 2026), couple cap, and with monthly_pension the yearly amount including the 13th. Use for any question about the state pension in Switzerland; for pillar 3a and pension-fund figures use pension_figures, for tax on a withdrawal capital_withdrawal_tax.

  Parameters:

  • canton — string — 2-letter abbreviation, optional: that canton's pension statistics
  • months — number — months with an old-age pension in the year, 1 to 12, default 12
  • monthly_pension — number — monthly old-age pension in CHF, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• school_holidays read-only

  School holidays of the compulsory schools (Volksschule) in the 26 Swiss cantons for the current and next school year, read from each canton's own sources (not the EDK list): autumn, Christmas, sports/carnival, spring/Easter as first and last weekday off, summer start, who sets the dates (whole canton, region of the capital, canton and communes, or communes), source links, a calendar file (.ics) per canton, and which cantons are on holiday this week. With canton: that canton; without: all.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tax_deadlines read-only

  Tax return filing rules for natural persons in the 26 Swiss cantons, read from each cantonal tax administration: ordinary filing deadline (or that the date printed on the return applies), deadline for the self-employed, free extension until, latest extension, extension fee, the online extension link, and the cantonal wording with source links. Rules of the current tax year; the cantons publish the next year in January/February. The date on the tax return is binding.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• pollen read-only

  Pollen in Switzerland from the MeteoSwiss pollen network (open data, CC BY 4.0; credit «Source: MeteoSwiss»): daily mean concentration (grains per m³, 6 to 6 UTC) of hazel, alder, birch, ash, beech, oak and grasses at the 15 stations for the last 14 days, and a pollen calendar derived from the last ten complete years (weekly means, main season, peak week). With canton (2-letter code): its nearest station; without: every station plus the national calendar by month.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• federal_votes read-only

  Results of every Swiss federal vote since 1981 (FSO open data; official titles in DE FR IT RM EN): without arguments the list of vote days with every proposal and its national result (yes %, turnout, cantons for and against, accepted); with date (YYYY-MM-DD) that day with the result of every canton; with date and commune (name or BFS number) or canton the result there; with commune alone that commune's results of the latest votes. Communes in today's boundaries (mapped by the FSO).

  Parameters:

  • date — string — vote day YYYY-MM-DD, optional
  • canton — string — 2-letter abbreviation, optional
  • commune — string — commune name or BFS number, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parliament_member read-only

  Members of the Swiss Federal Parliament (National Council 200, Council of States 46) from the Parliamentary Services' open data web service ws.parlament.ch, refreshed daily: council, canton, party, parliamentary group and function, seat number, career in both chambers since joining, year and place of birth as published (never the full date), occupations with employer, mandates, committees and delegations with function, declared interests (Art. 11 Parliament Act: organisation, legal form, body, function, paid or unpaid), the official e-mail address and own website shown on the parlament.ch profile, and social media accounts the member links from their own website (only accounts whose handle carries the member's name). With name (or part of it) or id: matching members in full; with canton, council (NR or SR) or party (abbreviation) only: the matching list. Neutral facts only: no ratings.

  Parameters:

  • id — integer — parlament.ch person number, optional
  • lang — string — de, fr or it for committee and interest labels (default de)
  • name — string — name or part of it, optional
  • party — string — party abbreviation (e.g. SP, SVP, FDP-Liberale, M-E, GRÜNE, glp), optional
  • canton — string — 2-letter abbreviation, optional
  • council — string — NR or SR, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parliament_vote read-only

  Votes of the Swiss National Council since 2007 (legislatures 48–52; Parliamentary Services, ws.parlament.ch; current legislature daily): every electronic vote with business number and title, bill, subject, what yes and no meant, time, totals (yes, no, abstain, excused, did not vote, presiding) and totals per parliamentary group. Without arguments: the final votes (Schlussabstimmungen) with result. With query (words of the title) or business (e.g. 26.033): matching votes. With id: that vote in full incl. how every member voted and the totals per canton. With member (name): add that member's decision to each listed vote. The Council of States' individual votes are not in the data service. For a popular initiative the final vote is on the federal decree carrying the recommendation, not on the initiative itself.

  Parameters:

  • id — integer — vote id, optional
  • query — string — words of the title, optional
  • member — string — member name, optional
  • business — string — business number like 26.033, optional
  • final_only — boolean — only final votes (default true without id/query/business)
  • legislature — integer — limit a search to one legislature (52 = 2023–2027, 51 = 2019–2023, 50, 49, 48 = 2007–2011); default: all downloaded

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parliament_and_people read-only

  Parliament next to the people: for every National Council final vote of the current legislature whose bill later went to a popular vote, the chamber's result (yes, no, abstain, by group) next to the national popular result (yes %, accepted). Matched only on the exact title (the initiative title in «…», or the act title without «vom <date>»); unmatched items are left out rather than guessed. For an initiative a yes in the chamber is a yes to the federal decree with its recommendation, not to the initiative. Commune and canton results: federal_votes with the date.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parliament_session read-only

  Sessions of the Swiss Parliament in the current legislature (Parliamentary Services, ws.parlament.ch): dates, sittings of each chamber, number of speeches, speaking time in total and by parliamentary group per chamber (Federal Council separately), the items debated longest, and the final votes of the session. Without session: the list of sessions. Speaking time = end minus start of each speech in the Official Bulletin, without remarks from the chair.

  Parameters:

  • session — integer — session id (e.g. 5215), optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parliament_business read-only

  The path of a Swiss parliamentary item (Geschäft) that reached a National Council final vote in the current legislature: title, type, responsible department, submission date, topics, the dated status history (submitted, in committee, planned, final vote, done), the debate days in each chamber with number of speeches and speaking time and the link to the Official Bulletin, the final vote result and, where it went to the people, the popular vote. Find it by business number (e.g. 26.033) or by words of the title.

  Parameters:

  • query — string — words of the title, optional
  • business — string — business number like 26.033, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_speeches read-only

  Search speeches in the Swiss Parliament (both chambers, current legislature, Official Bulletin index): who spoke, in which council, when, for how long, on which item, with a link to the bulletin. Filter by speaker, business number, session or date. For what a whole session dealt with (dates, sittings, longest debates, final votes) use parliament_session.

  Parameters:

  • date — string — Day of the sitting as YYYY-MM-DD, e.g. "2026-09-15".
  • session — integer — Session id from parliament_session, e.g. 5206; omit for all sessions.
  • speaker — string — Name of the member of parliament who spoke, e.g. "Pfister" or "Gerhard Pfister".
  • business — string — Business number of the item, e.g. "26.033".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• election_results read-only

  Swiss National Council elections from the Federal Statistical Office (open data): for the latest election (2023) party strength in per cent of the vote with the change since the previous election, seats, women elected and turnout for Switzerland, every canton and every commune (communes in the boundaries SLI uses; merged communes add up the votes of their former communes, recomputed exactly); plus party strength and seats since 1991 for Switzerland and the cantons. With commune (name or BFS number), canton (2-letter code) or neither (Switzerland). history=true adds the series since 1991. Parties are shown as published (CVP and BDP until 2019, Die Mitte from 2023).

  Parameters:

  • canton — string — 2-letter abbreviation, optional
  • commune — string — commune name or BFS number, optional
  • history — boolean — include the series since 1991 (Switzerland or canton)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• cantonal_parliament read-only

  Cantonal parliaments that publish members and every individual vote as open data: Basel-Stadt (data.bs.ch, CC BY 4.0, 100 seats, votes since 2012), Bern (ogd.parl.apps.be.ch, 160 seats, votes since Nov 2022) and Thurgau (data.tg.ch, CC0, 130 seats, votes since Oct 2022), daily: the members with parliamentary group, party, constituency, seat, year of birth, occupation, employer, own homepage, committees, declared interests and voting record in the current legislature (participation, agreement with the own group); plus the latest 200 votes with totals per group. With name: matching members in full; without: the list and the statistics. No addresses.

  Parameters:

  • name — string — member name or part of it, optional
  • votes — boolean — include the latest votes
  • canton — string — BS (Basel-Stadt), BE (Bern) or TG (Thurgau): the cantonal parliaments that publish every vote as open data.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• canton_delegation read-only

  The members a Swiss canton sends to the Federal Parliament (its National Council seats and its one or two Council of States members), each with party, parliamentary group, seat number, year of birth and profile links; plus the delegation's count by group and by gender. Official source: Parliamentary Services, ws.parlament.ch (daily).

  Parameters:

  • canton (required) — string — 2-letter abbreviation

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• sunday_shopping read-only

  Sunday shopping and shop opening hours in the 26 Swiss cantons from the official law texts (re-checked weekly): how many Sundays all shops may open per year (federal Labour Act: at most four without a permit, each canton decides), who decides (canton or commune), weekday and Saturday closing times, Advent rules, tourist-place exceptions, the law with its URL and a verbatim quote. Shops in large stations, airports and motorway service areas may open every Sunday (federal law). With canton (2-letter code): that canton.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• immigration_reasons read-only

  Why foreign nationals move to Switzerland: immigration into the permanent foreign resident population (permits B, C and L of 12 months or more) by reason (employment within / outside quotas, family reunification, education and training, residence without employment, recognised refugees, hardship case and residence status after an asylum procedure, other), per year since 2008, for Switzerland, EU/EFTA vs third countries, the 26 cantons (canton of residence) and about 180 nationalities. Official source: State Secretariat for Migration SEM, foreigner statistics table 3-30 (ZEMIS). SEM totals differ slightly from the FSO (STATPOP) migration figures by design. Asylum seekers are not included (see asylum_statistics).

  Parameters:

  • year — integer — year 2008 onwards (default: latest)
  • canton — string — 2-letter canton code, e.g. ZH
  • history — boolean — include the Swiss totals for every year (default false)
  • nationality — string — country name in German as published by SEM, or its English, French or Italian name, e.g. Germany / Deutschland

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• mortgage_rates read-only

  Swiss National Bank policy rate (current, since when, every change since June 2019), SARON, and the average interest rates Swiss banks publish for new mortgages at month end (SNB data portal): variable, fixed 2 / 5 / 10 years, SARON 3 years, with 0.25 quantile, median and 0.75 quantile across banks, monthly series since 2007; plus savings and pillar 3a rates. For rents the BWO reference rate applies (get_reference_rate). Information only, not financial advice.

  Parameters:

  • history — boolean — include the monthly mean series (default false)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• dog_tax read-only

  Yearly dog tax per Swiss commune from official sources where a canton has a uniform rate or publishes every commune: Vaud (cantonal CHF 100 plus each commune's tax), Lucerne and Aargau (CHF 120 everywhere), Basel-Stadt (CHF 160 / 150 / 120, each further dog double), Basel-Landschaft (each commune), Geneva (cantonal CHF 50 plus the commune's surcharge plus CHF 5 fees). With commune (name or BFS number): that commune; without: all covered communes. Other cantons are not covered.

  Parameters:

  • commune — string — commune name or BFS number, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• waste_fees read-only

  Waste fees of Swiss communes from official open data, where the canton publishes every commune: canton of Zurich (all communes, since 2000: yearly basic fee converted to a 4-room flat and price per 35-litre bag) and Basel-Landschaft (bag price, basic fee per household, dog tax). CHF incl. VAT. With commune (name or BFS number): that commune incl. its history; without: every covered commune's latest values. Other cantons publish no per-commune table.

  Parameters:

  • commune — string — commune name or BFS number, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• how_many read-only

  Official answers to «How many … are there in Switzerland?» (the questions that reach Google Switzerland's top 10 every year): cantons, communes and districts (BFS commune register, per canton), permanent residents and foreign nationals (BFS STATPOP), Swiss abroad, cows, dairy cows and cattle (BFS farm structure survey), museums and visits, hydropower plants of at least 300 kW (BFE), hospitals and beds, main languages, taxpayers with net wealth over CHF 1 million (ESTV), foreign enclaves, the geographic centre, and protected AOP cheeses (no official count of cheese varieties exists). Each answer has its date and federal source. With topic: only that answer.

  Parameters:

  • topic — string — optional: register, population, swiss_abroad, cattle, museums, hydropower, hospitals, languages, millionaires, enclaves, centre, cheese

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• imputed_rental_value read-only

  Abolition of the imputed rental value (Eigenmietwert, valeur locative) on owner-occupied homes in Switzerland: in force 1 January 2029 (Federal Council decision of 1 April 2026); timeline from the 2017 parliamentary initiative to entry into force, the changes for owners as the federal administration states them (maintenance and debt interest deductions, first-time buyer deduction, cantonal tax on second homes), and the official result of the linked vote of 28 September 2025 (FSO VoteInfo: Switzerland, every canton; with commune: that commune), the status of each canton on the optional tax on second homes and on implementing the reform (official cantonal sources, re-checked weekly), and how each canton sets the imputed rental value until the end of 2028 (ESTV). Information only, not tax advice.

  Parameters:

  • canton — string — 2-letter abbreviation, optional
  • commune — string — commune name or BFS number, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• fire_danger read-only

  Forest fire danger and fire bans in Switzerland from FOEN open data (waldbrandgefahr.ch; credit «Source: FOEN»): for each of the 143 warning regions the danger level 1–5 and the canton's prevention measure 1–5 (no measures, warning, conditional ban, ban in and near the forest, absolute ban outdoors) with texts in DE FR IT EN and the date in force. With canton (2-letter code): that canton's regions and its highest danger and strictest measure; without: every canton summary. Bans issued by communes and fireworks rules (e.g. 1 August) are decided by cantons and communes and are not in this data.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• water_temperature read-only

  Water temperature in Switzerland: every FOEN river station measuring water temperature (raw data, latest reading, and where FOEN publishes it usual_c = median for this calendar day over the station's measuring years with usual_p25_c/usual_p75_c; credit «Surface waters data: Hydrology Division, FOEN»), the three river stations at the outflows of Lake Thun, Lake Geneva and Lake Lucerne (labelled as outflows, FOEN measures no lakes), Lake Zurich from the two City of Zurich water police stations with the last 14 daily means and the typical value for this calendar week (mean over all full years since 2007, calculated by the Swiss Living Index), and Zurich city bath temperatures reported in the last 7 days. Also bathing water quality: the FOEN classification of every reported bathing site (EU Bathing Water Directive, 1 excellent, 2 good, 3 sufficient, 4 poor, 0 not classifiable; credit «Source: FOEN») and the latest Zurich cantonal laboratory sample per site. With canton (2-letter code): river stations in that canton (nearest locality).

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• births_deaths read-only

  Births and deaths in Switzerland or one canton (geo = CH or a 2-letter canton code): yearly births and deaths since 1969, the last 36 months, deaths per week for the last 104 weeks with the BFS expected value and 99% band (mortality monitoring; latest weeks provisional), the month with most deaths over the last ten years, and the page. Aggregate official statistics only (BFS BEVNAT, mortality monitoring); births and deaths per commune per year are in get_commune pages and the canton page table.

  Parameters:

  • geo — string — CH or canton abbreviation, e.g. ZH

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_switzerland read-only

  The country level of the hierarchy Switzerland → 26 cantons → communes: population and foreign share (BFS STATPOP), naturalisations per year 2011 onwards with ordinary vs facilitated and the most common former nationalities (official BFS country names in DE FR IT EN), every canton with population, foreign share, tax rank, naturalisations per 1,000 foreign residents and its page and data file, and the index of all commune pages. Use get_canton and get_commune to go down a level. Also the Federal Council (members, departments, President of the Confederation, Federal Chancellor; verified on admin.ch, dated) and the key national figures of the Switzerland page: vital statistics, permits, unemployment, jobs, wages, rents, vacancy, reference rate, health premiums, hospitals, AHV 2027, pillar 3a 2027, public finances of all levels, mobility and energy, crime, sunshine; each with year and source.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_canton read-only

  Get all metric values for one canton. canton = 2-letter abbreviation (e.g. ZH, GE, TI). rank 1 = lowest value for cost metrics (dir 'low', e.g. taxes/rent) and highest value for capacity/benefit metrics (dir 'high', e.g. sunshine/jobs). Ranks describe order under the stated scenario, not universal suitability. Also returns the canton pages (DE FR IT EN), its flag, the cantonal government (members, departments, president) and chancellery contacts checked weekly against the official canton website, immigration and emigration by nationality (arrivals, departures, balance, trend), naturalisations by former nationality and world region with the rate per 1,000 foreign residents, and every commune of the canton with population, tax at CHF 100,000, Swiss rank and page. Includes highlights: protected AOP/IGP specialities of the area, UNESCO World Heritage, parks, cultural property of national importance and «Home of» brands (registered seat from the commercial register), plus traditional specialities of the canton. Also its official social media accounts (as linked from the canton's website; if none, the Federal Council's, see social_media.level).

  Parameters:

  • canton (required) — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI".
  • communes — boolean — true to list every commune of the canton (population, tax on CHF 100,000, page); default the 10 largest.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rank_by_metric read-only

  Rank all 26 Swiss cantons by one metric (lowest taxes, highest rents, most sunshine, lowest unemployment …), with the value, unit, year and official source of each canton. metric = a key from list_metrics; order = "high" or "low". For a full profile of one canton use get_canton; for 2 to 4 cantons side by side use compare_cantons.

  Parameters:

  • metric (required) — string — Metric key from list_metrics, e.g. "tax_single", "rent_mean", "unemployment_pct".
  • order — string — "high" = largest value first, "low" = smallest first (default high).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_cantons read-only

  Compare 2 to 4 Swiss cantons side by side across every metric of the index (income tax, rent, health premiums, unemployment, sunshine, safety, population and more), each with its value, unit, year and official source, and which canton does better. Use for «Zurich or Zug?» or «compare Geneva, Vaud and Basel». For one canton use get_canton; to rank all 26 use rank_by_metric; for rents alone rent_index.

  Parameters:

  • cantons (required) — array — 2 to 4 canton abbreviations, e.g. ["ZH","ZG","GE"].

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• commune_tax read-only

  Live income and wealth tax (federal, cantonal and communal, without church tax) for ONE household in ONE Swiss commune, from the official ESTV tax calculator (tax year 2026): any income, wealth, married or single, number of children. For the tax on a CHF 100,000 salary in every commune at once (ranking, cheapest communes) use tax_by_commune.

  Parameters:

  • commune (required) — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • income (required) — number — Taxable gross yearly income in CHF, e.g. 100000.
  • wealth — number — Net wealth in CHF for the wealth tax, e.g. 250000 (default 0).
  • married — boolean — true for a married couple (joint taxation), false or omitted for a single person.
  • children — number — Number of children in the household, e.g. 2 (default 0).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• search_commune read-only

  Find Swiss communes by name or postcode (official ESTV location register). Returns commune name, canton and postcode — use before commune_tax or estimate_net_move when the spelling is uncertain.

  Parameters:

  • query (required) — string — Commune name (or part of it) or postcode, e.g. "Küsnacht" or "8700".

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• estimate_net_move read-only

  Net yearly CHF effect of moving between two Swiss communes for one household: live commune-level tax (official ESTV 2026) plus canton-average rent and health-premium differences; positive savings = the move saves money. For the full move checklist (insurer, school holidays, electricity, permits, deadlines) use plan_move.

  Parameters:

  • from_commune (required) — string — current commune name or postcode
  • to_commune (required) — string — candidate commune name or postcode
  • income (required) — number — gross household income, CHF/year
  • wealth — number — taxable wealth, CHF
  • married — boolean — true for a married couple (joint taxation), false or omitted for a single person.
  • children — number — Number of children in the household, e.g. 2 (default 0).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_trend read-only

  Historical year-series for a metric in one canton (e.g. sunshine back to 1884, migration to 1981, rent to 2010). metric = key from list_metrics with history: rent_mean, net_migration_per_1000, foreigner_pct, sunshine_hours, balance_per_capita, beds_per_1000, jobs, unemployment_pct (SECO yearly averages to 1993). Optional from_year.

  Parameters:

  • canton (required) — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI".
  • metric (required) — string — Metric key with a year series, e.g. "rent_mean", "sunshine_hours", "unemployment_pct".
  • from_year — number — First year to return, e.g. 2000; omit for the whole series.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• upcoming_votes read-only

  The next Swiss federal vote dates and, once the Federal Council has set them, the proposals on the ballot, in German, French, Italian and English (official Federal Chancellery / VoteInfo data). For results of past votes use federal_votes.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• recommend_canton read-only

  Personal canton recommendation ("Where should I live in Switzerland?"): weight 5 categories 0–3 (cost = rent/premiums/electricity; tax = income tax/fiscal balance; work = jobs/unemployment/migration; env = sunshine/crime/vacancy; health = hospital capacity) and get all 26 cantons scored by the transparent percentile method of the Swiss Living Quality Index. Every evidence figure carries value, unit, rank, source and year. Scores describe order under the stated weights, not universal suitability.

  Parameters:

  • env — number — Weight 0 to 3 for environment and climate (sunshine, heat, frost); default 2.
  • tax — number — Weight 0 to 3 for low taxes (income tax, fiscal balance); default 2.
  • cost — number — Weight 0 to 3 for low living costs (rent, health premiums, electricity); default 2.
  • work — number — Weight 0 to 3 for the job market (jobs, unemployment, migration); default 2.
  • infra — number — 0-3, connectivity & infrastructure (active once infra metrics ship)
  • limit — number — top N with evidence, default 5
  • health — number — Weight 0 to 3 for health care (hospital beds, premiums); default 2.
  • international_community — boolean — include foreigner share, higher preferred

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_salary read-only

  Official gross monthly salaries in Switzerland by ECONOMIC SECTOR (BFS Swiss Earnings Structure Survey LSE): median and P10/P25/P75/P90 for all employees, women and men, by major region. canton (2-letter) is mapped to its major region; sector = NOGA code or words («banking», «software»). For salaries by OCCUPATION and age (nurse, developer, teacher) use salary_by_occupation.

  Parameters:

  • year — number — Year of the earnings survey (every two years: 2012 to 2024), e.g. 2026; omit for the latest. An unavailable year returns the list of available years.
  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Mapped to its BFS major region.
  • region — string — major region code 1–7 or -1 for Switzerland
  • sector — string — Economic sector as NOGA code or words, e.g. "64", "banking", "software", "construction"; omit for all sectors.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_minimum_wage read-only

  Statutory cantonal minimum wages in Switzerland (official cantonal pages): hourly amount, valid from, history and the monthly equivalent at 40 hours. Only five cantons have one (BS, GE, JU, NE, TI); without canton the list of all five is returned. Elsewhere minimums apply only through collective or standard employment contracts.

  Parameters:

  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Only BS, GE, JU, NE and TI have one; omit for all five.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_payroll_rates read-only

  Official Swiss social-security payroll deductions for the current year (AHV/IV/EO, unemployment insurance ALV with ceiling, occupational pension BVG coordinated salary and age credits), as used for a gross-to-net salary estimate.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_premium_subsidy read-only

  Health-insurance premium subsidies (Prämienverbilligung / réduction des primes) per canton (FOPH KVSTAT): share of insured receiving a subsidy, average CHF per beneficiary and per household, subsidy as % of the mean premium, federal vs cantonal funding, plus the responsible cantonal office (name, address, phone, website). canton = 2-letter abbreviation.

  Parameters:

  • canton (required) — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_family_tax_deductions read-only

  Swiss income-tax deductions for families (ESTV tax folder): maximum childcare (third-party care) deduction per child and the child deduction (Kinderabzug) rule for a canton, plus the federal values. canton = 2-letter abbreviation; omit for federal only.

  Parameters:

  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Omit for the federal values only.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_housing_costs read-only

  Average monthly housing costs per household in Switzerland (BFS household budget survey HABE): net rent or mortgage interest, ancillary costs (Nebenkosten: flat-rate charges, water, waste water, waste, upkeep), energy (electricity, gas/fuels, heating), with BFS quality grades. Latest year for Switzerland; with canton also the values of its major region (pooled period). Means over all households incl. owners.

  Parameters:

  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Mapped to its BFS major region; omit for Switzerland.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_reference_rate read-only

  Swiss mortgage reference interest rate for rents (BWO/FOH): current rate, valid since, next publication dates, every change since 2008, and the rule for rent adjustments (VMWG Art. 13). Optional lease_rate (the rate in the lease) returns the quarter-point steps since then. Also returns the latest BFS rent price index (quarterly change, annual change, share of rents up/down/unchanged).

  Parameters:

  • lease_rate — number — reference rate stated in the lease, e.g. 1.75

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• data_freshness read-only

  How current the Swiss Living Index data is: every scheduled official data source with where it runs (cloud, a Mac on the Swiss network, or the A5000 language-model machine), its cadence in days, the last successful check, the next due date and a status (current, due, overdue = more than twice its cadence, new = not run yet), plus a summary. Use it to state how fresh a figure is before relying on it. Optional status filter.

  Parameters:

  • status — string — optional filter

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_datasets read-only

  Catalogue of EVERY dataset published by the Swiss Living Index (about 125: migration, births and first names, crime, public finances, cross-border commuters, vehicles, broadband, sustainability, naturalisations, permits, health care, housing, income, education and more), each with source, geography (Switzerland / canton / commune), years and page. Without arguments it returns the topics; with topic or query it returns the matching datasets. Then read one with get_dataset.

  Parameters:

  • query — string — words to match in title, source or id
  • topic — string — topic key from the topic list, e.g. migration
  • geography — string — switzerland, canton or commune

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_dataset read-only

  Read one Swiss Living Index dataset (id from list_datasets), exactly as published on the site (official values, unchanged). Filter with canton (2-letter) and/or commune (name or BFS number), section (a top-level key), from_year / to_year. Large datasets return a size summary first so you can narrow the request. Every reply carries source, source URL and the page to cite.

  Parameters:

  • id (required) — string — Dataset id from list_datasets, e.g. "migration/migration-switzerland".
  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Filters the dataset to that canton.
  • max_kb — number — reply size limit in KB, default 150, max 600
  • commune — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work. Filters the dataset to that commune.
  • section — string — One top-level section of the dataset (the too_large answer lists them).
  • to_year — number — Keep year series up to this year, e.g. 2025.
  • from_year — number — Keep year series from this year, e.g. 2015.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_commune read-only

  Fact sheet for one Swiss commune (by name, BFS number or postcode); for communes with a one-pager also the president, council, administration contacts, departments, upcoming meetings, news, tenders and projects read from the commune website (with source and date): population, foreign residents, migration, jobs, new dwellings, gigabit and fibre coverage, public-transport accessibility, solar power, EV share, cars, cross-border commuters, commune finances, its canton context (tax, rent, premium ranks), live income tax for a reference profile (official ESTV), and the national fuel reference; its official social media accounts (as linked from the commune website; if none, the canton's, then the Federal Council's, see social_media.level). Includes highlights: protected AOP/IGP specialities of the area, UNESCO World Heritage, parks, cultural property of national importance and «Home of» brands (registered seat from the commercial register).

  Parameters:

  • commune (required) — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• compare_health_insurers read-only

  Every approved basic health-insurance premium (FOPH) for a commune or premium region: cheapest offers for an adult (26+), young adult (19–25) or child, by deductible, insurance model (standard, family doctor/HMO, telemedicine, other) and accident cover, with the insurer and product. year 2027 (next year) or 2026. Premiums depend on the commune of residence, so give commune (name or BFS number) or region (e.g. ZH-1).

  Parameters:

  • year — number — Premium year: 2026 (current) or 2027 (next year, approved by FOPH in September); default the latest.
  • limit — number — number of offers, default 10
  • model — string — standard, family_doctor, telemedicine, other or any (default)
  • region — string — Premium region as canton plus number, e.g. "ZH-1", "ZH-2", "BE-3" (use instead of commune).
  • commune — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • accident — boolean — true = accident cover included (default false: covered by the employer)
  • age_group — string — adult (default), young_adult or child
  • deductible — number — CHF, e.g. 300 or 2500

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_electricity_price read-only

  Official electricity tariff (ElCom) for a Swiss commune and its grid operator(s): total, energy, grid use, commune charges and federal levy in Rappen per kWh, for 2025–2027, and the yearly bill for a consumption profile (ElCom categories H1–H8, default H4 = 5-room flat, 4500 kWh) or your own kWh.

  Parameters:

  • commune (required) — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • kwh — number — own yearly consumption (overrides the category volume)
  • year — number — Year of the ElCom tariff (2025 to 2027), e.g. 2026; omit for the latest. An unavailable year returns the list of available years.
  • category — string — H1–H8, default H4

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• fuel_prices_near read-only

  Is the drive across the border worth it? Official station prices in France, Austria and Italy (live / daily official sources) near a Swiss place, ranked by net saving vs the official Swiss average price (BFS) after the fuel used for the round trip. place = postcode or locality (or lat/lon). Location is used for this lookup only.

  Parameters:

  • km — number — search radius, 2–40, default 10
  • lat — number — Latitude in decimal degrees, e.g. 47.56 (with lon).
  • lon — number — Longitude in decimal degrees, e.g. 7.59 (with lat).
  • fuel — string — unleaded95 (default) or diesel
  • tank — number — litres, default 50
  • place — string — Swiss place: postcode, locality or both, e.g. "8001", "Basel", "8001 Zürich" or "Basel (BS)". Alternatively give lat and lon.
  • postcode — string — Swiss 4-digit postcode, e.g. "4058" (alternative to place).
  • consumption — number — l/100 km, default 7

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• ev_charging_near read-only

  Live availability of public EV charging points in Switzerland (official SFOE feed, minutes old): national and per-canton availability and fast chargers; with place (postcode or locality) or lat/lon also the nearest points within km with their live status. No prices (no official register exists).

  Parameters:

  • km — number — radius, default 5, max 25
  • lat — number — Latitude in decimal degrees, e.g. 46.95 (with lon).
  • lon — number — Longitude in decimal degrees, e.g. 7.44 (with lat).
  • place — string — Swiss place: postcode, locality or both, e.g. "8001", "Basel", "8001 Zürich" or "Basel (BS)". Alternatively give lat and lon. Omit place and coordinates for the national and per-canton summary.
  • postcode — string — Swiss 4-digit postcode, e.g. "3011" (alternative to place).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• commute_cost read-only

  Monthly commute cost between two Swiss places: by car at the official Swiss average fuel price (BFS) and by electric car at the home commune official electricity tariff (ElCom H4), plus the public-transport journey time (Swiss timetable). Distance defaults to straight line × 1.3 between the stations (labelled estimate) unless km_one_way is given. Public-transport fares are not open official data and are not included.

  Parameters:

  • from (required) — string — Home place: Swiss postcode or locality, e.g. "Winterthur" or "8400".
  • to (required) — string — Work place: Swiss postcode or locality, e.g. "Zürich" or "8001".
  • fuel — string — unleaded95 or diesel
  • ev_kwh — number — kWh/100 km, default 18
  • km_one_way — number — Road distance one way in km, e.g. 25; omit to use the routed distance between from and to.
  • consumption_l — number — l/100 km, default 7
  • days_per_month — number — Commuting days per month, e.g. 20 (default 20).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• household_budget read-only

  What Swiss households spend per month (BFS household budget survey, official): income, social insurance, taxes, health premiums, food, restaurants, housing and energy, transport, leisure and more, for all households, singles, couples without children, families and retired couples.

  Parameters:

  • household — string — all, single, couple_no_children, family or retiree_couple; omit for all types

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• salary_by_occupation read-only

  Official gross monthly salaries by occupation group (ISCO-08) and age band (up to 29, 30–49, 50+), median and P10–P90, for all, women and men, by major region (BFS LSE). occupation = ISCO code or words (e.g. "nurse", "engineer", "teacher", "IT"); canton maps to its major region.

  Parameters:

  • age — string — all (default), under30, 30to49, 50plus
  • year — number — Year of the earnings survey (every two years: 2012 to 2024), e.g. 2026; omit for the latest. An unavailable year returns the list of available years.
  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Mapped to its BFS major region.
  • region — string — BFS major region (NUTS-2): 1 Lake Geneva, 2 Espace Mittelland, 3 Northwestern Switzerland, 4 Zurich, 5 Eastern Switzerland, 6 Central Switzerland, 7 Ticino, -1 Switzerland. Use canton instead to map automatically.
  • occupation — string — Occupation as ISCO-08 code or words, e.g. "25", "nurse", "software developer", "teacher".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• cheapest_health_insurer read-only

  The cheapest basic health insurer (FOPH-approved premiums, next year) in every Swiss premium region, or for one canton, region (e.g. ZH-1) or commune: cheapest standard premium (adult 26+, free choice of doctor, CHF 300 deductible, with accident cover) and the lowest possible premium (any model, highest deductible), plus how often each insurer is the cheapest nationally.

  Parameters:

  • canton — string — 2-letter abbreviation, optional
  • region — string — premium region code, e.g. ZH-1, optional
  • commune — string — name, postcode or BFS number, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• permit_types read-only

  Swiss residence permits L, B, C, Ci, G, F, N, S (incl. the asylum statuses): what each permit is, the official rules (validity, renewal, C permit after 10 or 5 years, language levels, EU/EFTA 5-year list, moving within Switzerland) each with its law article (AIG, VZAE, BüG) or SEM page, and the number of people per permit (BFS, 2010 to latest year) for Switzerland or a canton. Information, not legal advice: the cantonal migration office decides.

  Parameters:

  • canton — string — optional canton, e.g. ZH
  • history — boolean — include all years, default false

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• leaving_switzerland read-only

  Leaving Switzerland: the official steps with their law articles: deregister with the commune at the latest 14 days before departure (VZAE 15), what happens to an L, B or C permit (AIG 61), keeping a C permit for up to 4 years on request (VZAE 79), residence for naturalisation counted as given up (BüG 33), early pillar 3a withdrawal on leaving for good (BVV 3 Art. 3), pension fund cash payout and its EU/EFTA limit (FZG 5, 25f), vested benefits (FZG 4), AHV pensions abroad, refund of AHV contributions and voluntary AHV (AHVG 2, 18, RV-AHV), withholding tax on payouts abroad (DBG 96), plus the number of people who moved abroad (BFS).

  Parameters:

  • permit — string — current permit, or swiss for Swiss citizens

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• naturalisation_timing read-only

  Checks the federal residence conditions for ordinary Swiss naturalisation (BüG Art. 9, 33) or facilitated naturalisation of a Swiss citizen's spouse (BüG Art. 21) from the years someone has lived in Switzerland: years between ages 8 and 18 count double (at least 6 actual years), temporary admission (F) counts half, C permit required. Returns which conditions are met with the law articles, and what is missing. Cantons add 2 to 5 years of residence in the canton (BüG 18). Orientation only, not legal advice.

  Parameters:

  • years_total (required) — number — actual years lived in Switzerland with B, C or Ci permit
  • has_c_permit — boolean — true if the person holds a C permit (settlement permit), required for ordinary naturalisation.
  • spouse_of_swiss — boolean — true for the spouse of a Swiss citizen (facilitated naturalisation, BüG Art. 21).
  • years_in_canton — number — Years lived in the current canton, e.g. 3 (cantons ask 2 to 5).
  • years_in_last_5 — number — of those, years within the last 5 years
  • years_age_8_to_18 — number — of those, years between the 8th and 18th birthday
  • years_temporary_admission_f — number — years with temporary admission F (count half)
  • years_married_living_together — number — Years married and living together with the Swiss spouse, e.g. 3 (facilitated naturalisation needs 3).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• which_permit read-only

  Which Swiss permit fits a person (the Swiss Living Index permit route finder as a tool): from nationality and plan (visit, work, commute from abroad, join family, study, retire, live without working, or already living here on a B permit) returns the permit (L, B, C, G or none), whether it is an entitlement or at the canton's discretion, the 2026 quota for non-EU work, every rule with its law article (AIG, VZAE, BüG) or SEM page, and for people already here the years until a C permit and naturalisation. Same logic as the page, checked by 45 test cases. Asylum statuses are out of scope. Information, not legal advice: the cantonal migration office decides.

  Parameters:

  • nationality (required) — string — ISO 3166 alpha-2 code (e.g. DE, PL, GB, US, IN) or a group: eu5, eu, uk, other
  • plan (required) — string — What the person wants to do in Switzerland: visit, work, commute (live abroad, work here), family (join family), study, retire, nonactive (live without working) or here (already living here).
  • age — number — Age in years, used for plan retire (e.g. 62).
  • qualified — boolean — work, non-EU: manager, specialist or other qualified worker (default true)
  • job_length — string — work: under 3 months, 3 to 12 months, a year or longer / open-ended (default ge12)
  • years_on_b_permit — number — here: years on a B permit without interruption
  • ties_to_switzerland — boolean — retire: earlier long stays or close relatives in Switzerland
  • family_member_is_eu_efta — boolean — family: that person is an EU/EFTA national (free movement rules, not covered)
  • family_member_in_switzerland — string — family: status of the person in Switzerland

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• work_permit_quotas read-only

  Swiss work permit quotas for people from outside the EU/EFTA, set every year by the Federal Council (VZAE annexes 1 and 2): B and L permits per canton plus the federal reserve, and the separate quotas for EU/EFTA service providers over 90 days, UK nationals without acquired rights and US interns, with the admission rules (economic interest, priority of the domestic workforce, qualified workers only) and their law articles. canton optional.

  Parameters:

  • year — number — Quota year, e.g. 2026; omit for the latest Federal Council decision.
  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• family_reunification read-only

  Family reunification in Switzerland (AIG Art. 42 to 47, VZAE 73 to 73b): who can bring a spouse and children under 18, entitlement (Swiss citizens, C permit) or discretion (B, L), the conditions (living together, housing, no social assistance, language), the 5-year deadline (12 months for children over 12) and the language levels, each with its law article. sponsor = status of the person in Switzerland.

  Parameters:

  • sponsor — string — optional; omit for all four

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• naturalisation_canton_rules read-only

  Cantonal conditions for ordinary Swiss naturalisation in each of the 26 cantons, on top of the federal rules (C permit, 10 years): minimum residence in the canton and the commune (2 to 5 years), language level spoken / written (federal minimum B1 / A2; 8 cantons require more), knowledge test (cantonal written test, commune test or interview), cantonal fee for one adult, the responsible office and the cantonal law with its version in force. Every value carries a verbatim quote from the official cantonal law collection or office page. canton optional (omit for all 26). Information, not legal advice.

  Parameters:

  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• asylum_statistics read-only

  Official Swiss asylum statistics of the State Secretariat for Migration (SEM, monthly, archived month by month): new asylum applications, completed cases, asylum grants, rejections, Dublin decisions, recognition and protection rates, applications and grants of protection status S, departures and removals, and the numbers of people in the asylum process (N, F, S), with the official SEM labels in German and French. month = YYYY-MM (default latest), indicator = key or words to filter, nationality = German country name as published by SEM for new applications by nationality (default: top 15 of the last 12 months), years = true for yearly figures since 2014.

  Parameters:

  • month — string — Month as YYYY-MM, e.g. "2026-09"; omit for the latest.
  • years — boolean — true to add the yearly series of each indicator.
  • indicator — string — Filter indicators by key or label (German or French), e.g. "asylgesuche", "schutzquote", "dublin"; "all" for all ~200; omit for the 12 headline indicators.
  • nationality — string — Nationality as SEM writes it in German (or French), e.g. "Afghanistan", "Türkei", "Eritrea"; omit for the top 15 of the last 12 months.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• public_holidays read-only

  Public holidays per Swiss canton (official SECO list of cantonal holidays equated with Sundays, Art. 20a ArG; 1 August federal): for a canton and year the dates with weekday, which fall on working days and the bridge days (Monday before a Tuesday holiday, Friday after a Thursday holiday). Cantons that set holidays by area (AG, AI, AR, FR, NE, SO) return one list per area with conditions. Without canton: the number of holidays and bridge days of every canton. Names in DE/FR/IT/EN.

  Parameters:

  • year — number — default: current year
  • canton — string — 2-letter abbreviation, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• capital_withdrawal_tax read-only

  Tax on a lump-sum withdrawal from the pension fund (2nd pillar) or pillar 3a in every Swiss commune, from the official ESTV tax calculator: CHF 100,000, 250,000, 500,000 or 1,000,000, single or married, payment at 65, federal + cantonal + communal tax without church tax. Give a commune (name, postcode or BFS number) for its tax, rate and rank, a canton for its lowest and highest communes, or nothing for the national lowest and highest. Lump sums in the same year are added together; pillar3a_tax calculates other amounts for one commune.

  Parameters:

  • limit — number — How many communes to list when ranking a canton or Switzerland, e.g. 10 (default 10).
  • amount — number — Withdrawn capital in CHF: 100000, 250000, 500000 or 1000000 (default 500000).
  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Lists every commune of the canton.
  • commune — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • household — string — single (one person) or married (married couple).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• pension_figures read-only

  Official Swiss retirement-provision figures for the current year and, once decided, the next year: pillar 3a maximum deduction (with / without pension fund), AHV/IV old-age pension minimum and maximum per month and the married couple cap, BVG entry threshold and coordination deduction, minimum AHV contributions, supplementary-benefit amounts, withdrawal rules and retroactive 3a buy-ins. Each figure with its official source (Federal Council, BSV, ESTV).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• pillar3a_tax read-only

  Pillar 3a in a specific Swiss commune, from the official ESTV tax calculator: how much income tax a 3a payment saves (federal, cantonal and communal, without church tax) and how much tax a later capital withdrawal costs in the same commune. Defaults: the maximum 3a payment for the profile, no withdrawal unless capital is given.

  Parameters:

  • commune (required) — string — commune name or postcode
  • income (required) — number — gross salary CHF per year
  • amount — number — 3a payment CHF (default: the maximum for the profile)
  • capital — number — capital of a later withdrawal CHF (optional)
  • married — boolean — true for a married couple (joint taxation), false or omitted for a single person.
  • children — number — Number of children in the household, e.g. 2 (default 0).
  • pension_fund — boolean — member of a pension fund (default true)
  • age_at_withdrawal — number — Age when the 3a capital is withdrawn, e.g. 64 (default 65).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• plan_move read-only

  Workflow for "I am moving from A to B in Switzerland: what changes for me?" in one call. Combines: income tax at both places (live ESTV, if income given), the health premium region and cheapest insurer at both places (FOPH), the electricity bill at both places (ElCom), the commute to work from both places (optional work_place), a side-by-side of both communes (official figures), and the official to-do list for a move within Switzerland (ch.ch) with the rules on taxes (StHG Art. 68) and premiums (KVG Art. 61). Each part fails independently, so one unavailable source never blocks the answer.

  Parameters:

  • from_commune (required) — string — current commune, name or postcode
  • to_commune (required) — string — new commune, name or postcode
  • income — number — gross household income CHF/year (optional, enables the tax comparison)
  • married — boolean — true for a married couple (joint taxation), false or omitted for a single person.
  • children — number — Number of children in the household, e.g. 2 (default 0).
  • language — string — language of the to-do list, default en
  • work_place — string — workplace or station (optional, enables the commute comparison)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• tax_by_commune read-only

  Income tax on a CHF 100,000 gross salary in every Swiss commune (federal + cantonal + communal, no church tax, no wealth), from the official ESTV tax calculator, for two households: single (35) and married couple with two children. Ranks the communes of a canton or Switzerland. For a specific income, wealth or household in one commune use commune_tax.

  Parameters:

  • limit — number — how many lowest/highest communes, default 10
  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Lists every commune of the canton.
  • commune — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • household — string — single (35, no children) or family (married couple with two children).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• health_premium_increase read-only

  How much Swiss health insurance premiums rise next year: the FOPH official mean premium (all models and deductibles, as people chose them) for Switzerland and per canton, for adults, young adults (19–25) and children, previous year vs next year in CHF and %; plus the median change of each insurer's standard premium on the same tariff. canton and insurer are optional filters.

  Parameters:

  • canton — string — Canton as 2-letter abbreviation, e.g. "ZH", "GE", "TI". Omit for Switzerland and every canton.
  • insurer — string — insurer name, e.g. CSS, optional

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• health_deductible_advice read-only

  Which health insurance deductible (franchise) pays off: for a commune or premium region, age group, model and expected yearly health costs, the yearly premiums plus cost sharing (deductible + 10 % up to CHF 700, children CHF 350, KVG) for every deductible, the cheapest choice and the break-even between the lowest and highest deductible. Hospital contribution and the 40 % share on some medicines are not included.

  Parameters:

  • model — string — standard (default), family_doctor, telemedicine or any
  • region — string — Premium region as canton plus number, e.g. "ZH-1", "ZH-2", "BE-3" (use instead of commune).
  • commune — string — Swiss commune: official name, BFS number or 4-digit postcode, e.g. "Winterthur", "230" or "8400". «8001 Zürich» and «Basel (BS)» also work.
  • insurer — string — one insurer by name, optional (default: the cheapest offer per deductible)
  • accident — boolean — accident cover included (default true; employees 8+ h a week are covered by the employer)
  • age_group — string — adult (default), young_adult or child
  • expected_costs — number — expected health costs per year in CHF (doctor, medicines, hospital, therapy), default 1000

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• switch_health_insurer read-only

  How to switch basic health insurance in Switzerland: the deadline for next year (receipt by 30 November, the Friday before on a weekend) with the days left, the five steps, when a switch is blocked (debts reminded by 30 November and unpaid by 31 December), the 30 June option (standard model with ordinary deductible only), deductible and model changes, and the free cancellation-letter page in DE/FR/IT/EN. Official sources: FOPH, priminfo, KVG Art. 7.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.