# Zügle

> Swiss relocation comparison. Given a current home and a candidate apartment, Zügle
> compares monthly costs, the income-tax delta between municipalities (federal, cantonal
> and Gemeinde), commute time and cost, and a quality-of-living score.

## MCP

Zügle is an MCP server. Remote endpoint, streamable HTTP JSON-RPC:

    https://zuegle.com/mcp

- Authentication: none. No account, no API key, no OAuth.
- All tools are READ-only. There is no write, delete or admin tool.
- Rate-limited per IP. Refusals come back as JSON-RPC results you can back off from.

Every tool is a capability an anonymous visitor to the website already has: the adapter
carries no credential and reaches the app over the same public routes a browser would.

A local stdio server is also available for running the tools against your own instance —
see docs/mcp/client-setup.md in the repository.

## Tools

- municipality_search: Finds Swiss municipalities by name fragment or postcode. Returns the BFS id, name, canton and postcodes for each match. The BFS id is the key every other tool here takes.
- tax_lookup: Calculates the annual Swiss income tax for one municipality and one household profile, split into federal, cantonal and municipal parts. The figures come from the federal tax administration's calculation for the given gross income.
- municipality_detail: Returns the tax picture for one municipality relative to a stated current home: the annual difference, the tax multiplier, and the multi-year trend where past years are known.
- favorable_municipalities: Ranks municipalities that are cheaper than, or within CHF 1000/yr of, a stated current home, by annual tax saving — municipalities near-identical in cost are included deliberately, not filtered out. Answered from cached figures only, so the ranking may be partial; the response states how many candidates were covered. Pass `near` (a town or station name) and `radiusKm` to keep only places around where the household lives or works; an unrecognised place is reported, not silently ignored.
- listing_search: Lists apartments currently advertised in one municipality, cheapest first, with the local median asking rent. Indicative figures for browsing only: they come from a portal feed and are not verified against the listing page.
- commute_time: Returns the public-transport journey time in minutes between two Swiss places, using the national timetable.
- commute_cost: Estimates the monthly cost in CHF of commuting between two Swiss places, as a transit-pass estimate priced from Swiss regional fare-zone data. Some pricing regimes are approximations rather than an exact tariff.
- rent_benchmark: Reports the Swiss Federal Statistical Office's average monthly rent for a municipality, optionally for a given apartment size in rooms. BFS does not publish rent below canton level except for 10 named cities, so the figure may describe the CANTON rather than the municipality itself; the response states which.

## Docs

- https://zuegle.com/api-docs.html — the full HTTP API (OpenAPI, browsable)
- https://zuegle.com/openapi.yaml — the same spec, raw
- https://zuegle.com/methodology — how the figures are calculated
- https://zuegle.com/privacy — what is stored and what is not
- https://zuegle.com/about — what Zügle is