swiss-holidays-mcp

Check whether a given date falls into school holidays or a public holiday. <use_case>The everyday scheduling question: can we hold the parents' evening on that Thursday? Checks one date against both school and public holidays.</use_case> The everyday question behind this tool: "Can we schedule the parents' evening on that Thursday?"

Compare school holiday overlap between cantons for a calendar year. <use_case>Quantify inter-cantonal school-holiday overlap (pairwise day counts) for coordinating events or campaigns across cantonal borders.</use_case> Returns a pairwise matrix of overlapping holiday days. Defaults to `VS` (Volksschule) because that is the level most inter-cantonal coordination concerns.

Export a canton's holidays for a year as an iCalendar (.ics) document. <use_case>Produce a ready-to-import .ics calendar of a canton's holidays for a year, filtered by public/school and Schulart.</use_case> Returns a ready-to-save `text/calendar` document with one all-day event per holiday. `include` selects `all` (default), `public` or `school`; combine with `school_type` (`VS`/`MS`/`BS`/`EO`) to narrow school holidays.

Find date ranges in which all listed cantons are simultaneously on holiday. <use_case>Find a common free window across several cantons — joint events, maintenance or campaigns when every listed canton is on holiday.</use_case> Useful for planning campaigns, joint events or maintenance windows across cantonal borders.

Public holidays for a single municipality or district, incl. local specifics. <use_case>Answer the locality question the canton-level tools flatten away: which holidays are observed only in this town (e.g. Zurich's Sechselaeuten)?</use_case> <important_notes>scope is 'local' (specific here), 'regional' (canton/district) or 'national' (inherited). Accepts a name or a full subdivision code.</important_notes> Answers the local question the canton-level tools flatten away: which holidays are observed *only* here? The city of Zurich, for example, keeps Sechseläuten and Knabenschiessen (both half-day), which the rest of the canton does not. `municipality` accepts a name (e.g. "Zürich", "Morschach") or a full subdivision code (e.g. "CH-ZH-ZH-ZH"). The result lists every holiday that applies in that locality; each carries a `scope` of `local` (specific to this place), `regional` (inherited from the canton/district) or `national`.

Return Swiss long weekends and the bridge days needed to create them. <use_case>Plan bridge days: which long weekends exist this year and which working days must be taken off to extend them.</use_case> <important_notes>Computed from federal public holidays (Nager.Date); cantonal-only holidays are not considered.</important_notes> Sourced from Nager.Date, which computes these from federal public holidays; cantonal-only holidays are not considered.

Return public holidays for one canton and calendar year. <use_case>Get a canton's official public holidays for a whole year — cantonal holidays (Berchtoldstag, Fronleichnam) differ, so always pass the canton.</use_case> Cantonal holidays such as Berchtoldstag differ substantially across Switzerland, so always pass the canton rather than assuming the federal set.

Return school holiday periods for one canton in a date range. <use_case>Look up a canton's school holidays for planning within an explicit from/to window (term breaks, parent events, campaigns).</use_case> <important_notes>Apparent duplicates are the same period per Schulart; set school_type to collapse them. Cantons that do not differentiate return one table.</important_notes> Args: canton: ISO subdivision code, e.g. `CH-ZH`. valid_from: Inclusive start date, `YYYY-MM-DD`. valid_to: Inclusive end date, `YYYY-MM-DD`. school_type: Optional Schulart suffix -- `VS`, `MS`, `BS` or `EO`. Use `VS` for compulsory schooling (Volksschule). language: `DE`, `FR`, `IT` or `EN`. Records that look duplicated are usually the same period published for a different Schulart. Set `school_type` to collapse them.

Is today a school or public holiday in the given canton? <use_case>One-call convenience for the everyday 'are we off today?' question in a given canton.</use_case> Convenience wrapper over `check_date` for the everyday question "are we off today?".

List the 26 Swiss cantons with their ISO subdivision codes. <use_case>Resolve a canton name to the CH-XX code every other tool needs; call this first when the user gives a canton by name.</use_case> Use this first to resolve a canton name to the `CH-XX` code that every other tool expects.

List the Schularten (school types) that publish separate holiday tables. <use_case>Discover whether a canton differentiates school holidays by Schulart before querying, so VS/MS/BS/EO filters are used only where they exist.</use_case> Only a minority of cantons differentiate. For Zurich the codes are `CH-ZH-VS` (Volksschulen), `CH-ZH-MS` (Mittelschulen) and `CH-ZH-BS` (Berufsfachschulen). Cantons absent from this list publish one table for all school types.

Return the next upcoming school holiday periods for a canton. <use_case>Forward-looking planning: the next N school-holiday periods for a canton from today, without computing a date range by hand.</use_case>

Report reachability and latency of both upstream sources. <use_case>Health check before a batch of queries, or to distinguish 'no data' from 'source down' — always returns an evaluable status.</use_case> Always returns an evaluable status rather than an empty result set, so that "no data" can be distinguished from "source down".