Skip to main content
Glama
swiss-school-calendar-mcp

swiss-school-calendar-mcp

by malkreide

🇨🇭 Parte del Swiss Public Data MCP Portfolio

Este es un proyecto privado. Es independiente de cualquier empleador o afiliación institucional y no representa ninguna posición oficial de ninguna autoridad.

📅 swiss-holidays-mcp

License: MIT Python 3.10+ MCP CI No Auth Required Data Source

Un calendario de festivos suizo para agentes de IA — festivos públicos, vacaciones escolares y fines de semana largos para los 26 cantones, con comparación intercantonal. Las vacaciones escolares se diferencian por Schulart (tipo de escuela), lo que importa más de lo que parece a primera vista. No se requiere clave de API.

🇩🇪 Versión alemana


Resumen

swiss-holidays-mcp es un calendario de festivos suizo para asistentes de IA como Claude — festivos públicos, vacaciones escolares y fines de semana largos para los 26 cantones, sin necesidad de claves de API. Los festivos públicos son cantonales (Berchtoldstag, Fronleichnam y compañía varían según el cantón, no solo el mínimo federal). Las vacaciones escolares se fijan a nivel cantonal, a veces a nivel de distrito y — en seis cantones — por separado según el tipo de escuela. No existe un calendario federal único; cualquiera que planifique a través de fronteras cantonales se ve reducido a abrir 26 páginas PDF.

El servidor cubre dos grupos temáticos: festivos públicos / fines de semana largos y vacaciones escolares (con diferenciación por Schulart). Cada grupo se asigna a un conjunto de herramientas específicas que transforman los datos brutos de las agencias en respuestas JSON limpias y etiquetadas con su procedencia. Todos los datos provienen de la OpenHolidays API (CC BY 4.0) y de Nager.Date (MIT).

Regla mnemotécnica: Un duplicado en los datos escolares suizos suele ser un tipo de escuela disfrazado. La API subyacente publica el mismo periodo de vacaciones varias veces cuando un cantón diferencia por tipo de escuela. Eso parece datos duplicados e invita a una deduplicación ingenua — que destruiría precisamente la distinción que necesita una autoridad escolar.

Consulta de demostración ancla: "¿En qué semanas de 2026 están de vacaciones simultáneamente las escuelas obligatorias de Zúrich, Zug y Argovia — y cuántos días de solapamiento comparte cada par?" → Esto ejercita find_common_free_window, compare_school_holidays y list_school_types en una sola conversación, y responde a una pregunta que se repite en cada ciclo de planificación de la coordinación intercantonal. → Más casos de uso por audiencia →

Demostración

Demo: Claude usando find_common_free_window y compare_school_holidays


Related MCP server: swiss-courts-mcp

Características

  • 🏫 Vacaciones escolares — periodos por cantón y rango de fechas, diferenciados por Schulart (VS / MS / BS / EO)

  • 🎌 Festivos públicos — conjuntos de festivos cantonales, no solo el mínimo federal (Berchtoldstag y compañía)

  • 🔍 Comprobación de fechas — ¿es una fecha determinada un festivo escolar o público en un cantón?

  • 🔗 Comparación intercantonal — matriz de solapamiento por pares de días festivos entre cantones

  • 🪟 Ventanas libres comunes — rangos de fechas en los que todos los cantones listados están simultáneamente de vacaciones

  • 🌉 Fines de semana largos y días puente — calculados a partir de los festivos públicos federales (Nager.Date)

  • 🏘️ Festivos locales y municipales — particularidades a nivel de distrito y municipio como el Sechseläuten y el Knabenschiessen de Zúrich, con un marcador scope para que nunca se confundan con festivos de todo el cantón

  • 📆 Exportación iCal / ICS — los festivos de un cantón para un año como calendario .ics listo para importar

  • 🔖 Recurso de feed de festivos — recurso MCP holidays://<canton>/<year> con un resumen en Markdown

  • 📌 "¿Es hoy festivo?" — comodidad de una sola llamada para la pregunta cotidiana

  • 🩺 Salud de las fuentes — accesibilidad y latencia de ambos proveedores, siempre evaluable

  • 🔑 Sin autenticación requerida — ambas fuentes de datos son de acceso público

  • ☁️ Transporte dual — stdio para Claude Desktop, Streamable HTTP/SSE para despliegue en la nube

  • 🧾 Procedencia en cada respuesta — live_api | cached | degraded, nunca una lista vacía silenciosa


Fuentes de datos

Fuente

Datos

Licencia

OpenHolidays API

Cantones, Schularten, vacaciones escolares, festivos públicos

CC BY 4.0

Nager.Date

Fines de semana largos y días puente requeridos

MIT

Ambas fuentes son de acceso público, no se requiere autenticación. Atribución requerida: OpenHolidays (CC BY 4.0) y Nager.Date deben citarse como fuente al usar sus datos.


Herramientas

Herramienta

Propósito

Fuente de datos

list_cantons

Los 26 cantones con códigos ISO e idiomas oficiales

OpenHolidays

list_school_types

Grupos de Schulart por cantón (CH-ZH-VS etc.)

OpenHolidays

get_school_holidays

Vacaciones escolares para un cantón y rango de fechas

OpenHolidays

get_public_holidays

Festivos públicos para un cantón y año

OpenHolidays

get_local_holidays

Festivos públicos para un municipio o distrito, incl. particularidades locales

OpenHolidays

check_date

¿Es una fecha determinada un festivo escolar o público?

OpenHolidays

compare_school_holidays

Matriz de solapamiento por pares entre cantones

OpenHolidays

find_common_free_window

Ventanas en las que todos los cantones listados están de vacaciones

OpenHolidays

next_school_holidays

Los próximos periodos de vacaciones

OpenHolidays

get_long_weekends

Fines de semana largos y días puente requeridos

Nager.Date

export_holidays_ics

Los festivos de un cantón para un año como documento iCalendar (.ics)

OpenHolidays

is_holiday_today

¿Es hoy un festivo escolar o público en un cantón?

OpenHolidays

source_status

Accesibilidad y latencia de ambos proveedores

Integrado

Recursos

URI del recurso

Contenido

holidays://{canton}/{year}

Resumen en Markdown de todos los festivos públicos + escolares, p. ej. holidays://CH-ZH/2026

Todas las herramientas llevan el conjunto completo de anotaciones — readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true (acceden a una API externa). Ninguna herramienta escribe en ningún sitio. Las entradas se validan contra el esquema (los códigos de cantón contra los 26 cantones conocidos, las fechas como YYYY-MM-DD, year acotado, language/school_type en listas blancas).

Ejemplos de casos de uso

Consulta

Herramienta

"¿Qué cantones existen y cuáles son sus códigos?"

list_cantons

"Muestra las vacaciones de las escuelas obligatorias de Zúrich para la primavera de 2026"

get_school_holidays

"¿Es el 3 de abril de 2026 un festivo público en el Tesino?"

check_date

"¿Se solapan las vacaciones escolares de Zúrich y Zug este año?"

compare_school_holidays

"¿Cuándo pueden ZH, ZG, AG planificar una semana conjunta sin escuela?"

find_common_free_window

"¿Cuáles son las próximas vacaciones para las escuelas de Basilea-Ciudad?"

next_school_holidays

"¿Qué fines de semana largos tiene 2026 y qué días puente necesitan?"

get_long_weekends

"¿Qué festivos locales celebra la ciudad de Zúrich que el resto del cantón no celebra?"

get_local_holidays

"Exporta los festivos de Zúrich de 2026 como calendario .ics que pueda importar"

export_holidays_ics

"¿Es hoy festivo en Argovia?"

is_holiday_today


🛡️ Seguridad y límites

Aspecto

Detalles

Acceso

Solo lectura (readOnlyHint: true) — el servidor no puede modificar ni eliminar ningún dato

Datos personales

Sin datos personales — todas las fuentes son calendarios de festivos públicos agregados

Caché

TTL en memoria de 12 horas (las tablas de festivos cambian unas pocas veces al año)

Reintentos

Retroceso exponencial 2s / 4s / 8s; los 4xx excepto 429 no se reintentan

Tiempo de espera

20 segundos por llamada a la API (8 segundos para sondas de salud)

Autenticación

Sin claves de API requeridas — ambos proveedores son de acceso público

Degradación

Un fallo del proveedor produce un envoltorio degraded con una note explicativa, nunca una lista vacía silenciosa

Condiciones de servicio

Sujeto a las condiciones de servicio de las respectivas fuentes de datos: OpenHolidays, Nager.Date


Arquitectura

Este servidor utiliza la Arquitectura A (solo API en vivo, con caché en memoria).

                    ┌──────────────────────────┐
   Claude / any ───▶│  swiss-holidays-mcp      │
   MCP host         │  (MCPServer · 13 tools)  │
                    └────────┬─────────────────┘
                             │  retry 2s/4s/8s · 12h cache
                    ┌────────┴─────────┐
                    ▼                  ▼
          OpenHolidays API        Nager.Date
          (CC BY 4.0)             (MIT)
          cantons · Schularten    long weekends
          school + public         bridge days

Justificación (verificada en vivo el 2026-07-19):

  • Los diez endpoints documentados de OpenHolidays respondieron HTTP 200 con cargas útiles plausibles; /Subdivisions?countryIsoCode=CH devuelve exactamente 26 cantones, coincidiendo con el recuento oficial.

  • No se pudo verificar ningún volcado público masivo en el momento de la compilación (el acceso bruto a openpotato/openholidays.data devolvió 404), por lo que la Arquitectura B no estaba disponible.

  • Las tablas de festivos cambian unas pocas veces al año, por lo que un TTL en memoria de 12 horas elimina casi toda la carga del proveedor sin arriesgar datos obsoletos.

Consecuencias:

  • Cada respuesta lleva provenance (live_api | cached | degraded).

  • Un fallo del proveedor produce un envoltorio degraded con una note explicativa, nunca una lista vacía silenciosa.

  • source_status siempre devuelve un informe de salud evaluable.


Hallazgos de la sonda en vivo (2026-07-19)

Endpoint

HTTP

Estado

Registros

Nota

/Countries

200

✅ funciona

36

/Subdivisions?countryIsoCode=CH

200

✅ funciona

26

coincide con el recuento oficial de cantones

/Groups?countryIsoCode=CH

200

✅ funciona

11

grupos Schulart, solo 6 cantones

/PublicHolidays (CH, 2026)

200

✅ funciona

39

ámbito cantonal incluido

/SchoolHolidays (CH, 2026)

200

✅ funciona

193

183 distintos tras la división por tipo de escuela

/SchoolHolidaysByDate

200

✅ funciona

–

/SchoolHolidays?countryIsoCode=XX

200

⚠️ vacío silencioso

0

país no válido ≠ error

/Subdivisions?languageIsoCode=ZZ

200

⚠️ retroceso silencioso a EN

26

idioma no válido ≠ error

/SchoolHolidays sin rango de fechas

400

✅ error correcto

–

RFC 9110 problem+json

Nager /PublicHolidays/2026/CH

200

✅ funciona

33

29 filas llevan counties

Nager /LongWeekend/2026/CH

200

✅ funciona

3

Nager /PublicHolidays/2026/XX

404

✅ error correcto

–

más estricto que OpenHolidays

Hallazgos conocidos

  1. Los aparentes duplicados son tipos de escuela. Zúrich devuelve Frühlingsferien 2026 dos veces: una para CH-ZH-VS (Volksschulen, etiquetado Recommended) y otra para CH-ZH-BS + CH-ZH-MS (Berufsfach- y Mittelschulen). Use el parámetro school_type (VS / MS / BS / EO) en lugar de eliminar duplicados.

  2. Solo seis cantones diferencian por tipo de escuela (AI, AR, BE, GR, SO, ZH). En el resto, groups está ausente y una sola tabla lo cubre todo. Por lo tanto, el filtro trata un campo groups ausente como "aplica a todos".

  3. Los códigos de subdivisión mezclan niveles. Los registros pueden llevar CH-AI-AP o CH-BE-TH-BL. Siempre haga coincidir el prefijo CH-XX, nunca la igualdad de cadenas.

  4. Una lista vacía no es una respuesta. Un código de país o cantón desconocido devuelve HTTP 200 con []. Este servidor establece una note explicativa para que "sin vacaciones" y "filtro incorrecto" sigan siendo distinguibles.


Requisitos previos

  • Python 3.10 o superior

  • uv / uvx (recomendado) o pip

  • Acceso a Internet (ambas API son de acceso público)


Instalación

Ejecute mediante uvx de uv — no se necesita clonar ni instalar manualmente:

uvx swiss-holidays-mcp

Desarrollo

git clone https://github.com/malkreide/swiss-holidays-mcp
cd swiss-holidays-mcp
pip install -e ".[dev]"

Configuración

Claude Desktop

Añada a claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "swiss-holidays": {
      "command": "uvx",
      "args": ["swiss-holidays-mcp"]
    }
  }
}

Reinicie Claude Desktop — el servidor se inicia automáticamente en el primer uso.

Implementación en la nube (SSE / Streamable HTTP para acceso desde navegador)

Para su uso a través de claude.ai en el navegador (p. ej., en estaciones de trabajo gestionadas sin software local):

MCP_TRANSPORT=sse PORT=8000 python -m swiss_holidays_mcp

El SDK expone SSE en /sse, no en /mcp.

Variable

Valor por defecto

Descripción

MCP_TRANSPORT

stdio

Transporte: stdio, sse, streamable-http (también http)

PORT / MCP_PORT

8000

Puerto para transportes HTTP

MCP_HOST

127.0.0.1

Dirección de enlace para transportes HTTP. Bucle local por defecto; 0.0.0.0 es opcional y registra una advertencia — ejecútelo detrás de un proxy inverso con autenticación.

MCP_CORS_ORIGINS

(vacío)

Orígenes CORS adicionales separados por comas para clientes de navegador (auditoría SDK-004). Los orígenes de bucle local siempre están permitidos; añada el origen público desde el que se sirve su interfaz, p. ej. https://ui.example.ch. Nunca *.

Los transportes HTTP adjuntan una capa CORS explícita que expone la cabecera Mcp-Session-Id, de modo que un cliente MCP de navegador pueda leer el id de sesión y realizar solicitudes de seguimiento. La lista de permitidos nunca es un comodín.

Ejecutar más de una instancia HTTP detrás de un balanceador de carga requiere sesiones fijas basadas en Mcp-Session-Id — consulte docs/scaling.md para ejemplos con nginx/Traefik/Kubernetes. Una sola instancia (el caso común) no necesita configuración de afinidad.

💡 "stdio para el portátil del desarrollador, SSE para el navegador."


Estructura del proyecto

swiss-holidays-mcp/
├── src/
│   └── swiss_holidays_mcp/
│       ├── __init__.py       # Package init
│       ├── __main__.py       # Entry point: stdio / SSE / Streamable HTTP
│       ├── server.py         # MCPServer: lifespan, 13 tools, 1 resource, op_* logic
│       ├── client.py         # Shared HTTP client: retry, 12h cache, egress guard
│       ├── guard.py          # Egress / SSRF guard (HTTPS + allow-list + IP blocklist)
│       ├── pinning.py        # DNS-pinning transport (TOCTOU-free connect, SEC-005)
│       ├── ical.py           # RFC 5545 iCalendar (.ics) writer
│       ├── settings.py       # Pydantic-Settings config (loopback default)
│       ├── logging_setup.py  # Structured logging to stderr
│       ├── constants.py      # Canton codes, Schulart suffixes, API bases, allow-list
│       └── models.py         # Pydantic v2 response envelopes
├── tests/
│   ├── conftest.py           # respx fixtures
│   ├── test_tools.py         # Tool unit tests (mocked, no network)
│   ├── test_resilience.py    # Degradation / retry / cache behaviour
│   └── test_live.py          # Live smoke tests (marker: live)
├── docs/                     # roadmap.md, security.md, network-egress.md
├── deploy/                   # Network-layer egress manifests (Cilium / NetworkPolicy)
├── audits/                   # mcp-audit run artifacts
├── Dockerfile                # Non-root multi-stage container
├── .github/
│   ├── dependabot.yml        # Weekly dependency / action update PRs
│   └── workflows/            # ci.yml, live-tests.yml, publish.yml
├── pyproject.toml
├── CHANGELOG.md
├── CONTRIBUTING.md           # Contributing guide (English)
├── CONTRIBUTING.de.md        # Contributing guide (German)
├── SECURITY.md               # Security policy (English)
├── SECURITY.de.md            # Security policy (German)
├── EXAMPLES.md               # Use cases by audience
├── server.json               # MCP registry manifest
├── LICENSE
├── README.md                 # This file (English)
└── README.de.md              # German version

Sobre el archivo único server.py (auditoría ARCH-011). Las 13 herramientas viven deliberadamente en un solo módulo en lugar de un paquete tools/. Cada herramienta es un envoltorio fino y uniforme (@mcp.tool → @_safe_tool → op_*) sobre una operación op_* independiente del transporte, y cada operación comparte el mismo pequeño conjunto de ayudantes (_to_period, _matches_school_type, _require_known_canton, …) y el único HolidayClient. Dividirlos en varios archivos dispersaría ese núcleo compartido y duplicaría las importaciones sin beneficio de aislamiento — el archivo está uniformemente seccionado (alias → ayudantes → lógica op_* → envoltorios de herramientas → recurso) y cada op_* se prueba unitariamente directamente sin transporte. Una división en tools/ es el paso planificado solo si la Fase 2 eleva materialmente el número de herramientas.


Fase del ciclo de vida

Este servidor está en la Fase 1 (solo lectura) — todas las herramientas son de solo lectura, sin autenticación, sin efectos secundarios. El presupuesto de 13 herramientas (del máximo recomendado de 15–20) aún deja margen. Los detalles locales y municipales — incluidos el Sechseläuten y el Knabenschiessen de Zúrich — se cubren directamente desde OpenHolidays mediante get_local_holidays (una prueba en vivo mostró que se publican aguas arriba a nivel de Gemeinde), por lo que no se requiere una fuente de datos urbana separada para ellos.


Primitivas MCP y versión del protocolo

  • Primitivas — Herramientas + Recursos. Las 13 herramientas son GETs idempotentes y sin efectos secundarios. Un Recurso expone un feed de URI estable (holidays://<canton>/<year>) para que los clientes puedan leer el calendario de un cantón como contexto cacheable sin una llamada de herramienta. No hay flujos de trabajo plantillados recurrentes, por lo que Prompts no se utilizan (se revisará si eso cambia).

  • Versión del protocolo MCP — dos eras. mcp 2.x sirve ambas en el mismo servidor, y la primera solicitud del cliente en una conexión decide cuál aplica: el apretón de manos initialize limita a 2025-11-25, el sobre por solicitud alcanza 2026-07-28.

    source_status muestra una de ellas en su campo mcp_protocol_version — una sola cadena no puede nombrar ambas — y muestra el techo del apretón de manos, porque eso es lo que un cliente que llega a este servidor a través de initialize realmente negoció. Medido, no inferido de un nombre de constante: un cliente que pide 2026-07-28 en el apretón de manos recibe 2025-11-25.

    MCP_PROTOCOL_VERSION se deriva de LATEST_HANDSHAKE_VERSION del SDK en lugar de escribirse, por lo que no puede desviarse como lo hizo una vez — permaneció en 2025-06-18 durante dos revisiones mientras cada llamada lo reportaba como un hecho. tests/test_protocol_version.py mantiene ambas eras contra el SDK y comprueba el campo entregado también contra el SDK, no contra la constante de la que proviene. La versión de cable es negociada por el SDK mcp fijado (mcp>=2.0.0,<3).

  • Política de actualización. Las actualizaciones de SDK y dependencias llegan a través de Dependabot (semanal); los cambios de versión de protocolo o de definición de herramientas se registran en CHANGELOG.md con un aumento de versión.

Clasificación de datos

Todos los datos son Öffentlich / Datos abiertos públicos — calendarios de vacaciones agregados, sin datos personales (DSG/DSGVO). Esta es la clasificación más alta que maneja el servidor; el modelo completo está en docs/security.md.

Limitaciones conocidas

  • Fuente no oficial. OpenHolidays agrega publicaciones cantonales. Para fechas legalmente vinculantes, la autoridad cantonal sigue siendo la autoritativa. Cada respuesta lo indica.

  • La cobertura municipal depende del proveedor. OpenHolidays sí incluye vacaciones públicas a nivel de distrito y municipio (p. ej., Sechseläuten, Knabenschiessen en CH-ZH-ZH-ZH), expuestas a través de get_local_holidays. La exhaustividad a nivel de Gemeinde es tan buena como los datos del proveedor, que varían según el cantón. Las vacaciones escolares municipales no se modelan por separado.

  • Los fines de semana largos de Nager ignoran las vacaciones cantonales. Se calculan solo a partir de vacaciones a nivel nacional.

  • Sin garantía de profundidad histórica. La cobertura de años anteriores a aproximadamente 2020 es desigual.


Pruebas

# Unit tests (no network required — respx-mocked)
PYTHONPATH=src pytest tests/ -m "not live"

# Live smoke tests (hits the real upstream APIs)
PYTHONPATH=src pytest tests/ -m "live"

# Linting
ruff check src/ tests/ scripts/
ruff format --check src/ tests/ scripts/

Contribuciones

¡Las contribuciones son bienvenidas! Lea CONTRIBUTING.md (inglés) · CONTRIBUTING.de.md (alemán) para conocer las pautas sobre cómo informar errores, configurar el entorno de desarrollo, el estilo de código y los requisitos de prueba.

Este proyecto sigue las convenciones del Swiss Public Data MCP Portfolio.


Seguridad

Para informar una vulnerabilidad, siga el proceso de divulgación responsable en SECURITY.md (inglés) · SECURITY.de.md (alemán). El servidor es de solo lectura y no requiere clave API; consulte la sección Safety & Limits anterior para conocer el modelo de seguridad.


Registro de cambios

Consulte CHANGELOG.md


Implementación para la administración pública suiza

Si aloja este servidor para una autoridad escolar suiza o un caso de uso municipal:

  • Residencia de datos: los patrones de consulta en sí (qué cantones compara un funcionario) pueden revelar planificación en curso y es mejor mantenerlos en infraestructura suiza o de confianza.

  • Llamadas ascendentes van a OpenHolidays (proyecto OGD alojado en la UE) y Nager.Date. No salen datos personales de su entorno; solo se solicitan calendarios de vacaciones.

  • Registro: los registros se escriben en stderr; configure su política de retención de TI en consecuencia.

  • El transporte HTTP debe ejecutarse detrás de un proxy inverso con autenticación y límites de velocidad por IP — el servidor no tiene autenticación integrada.


Licencia

Licencia MIT — consulte LICENSE

Los datos de origen están sujetos a los términos de OpenHolidays (CC BY 4.0) y Nager.Date (MIT); se requiere atribución a estas fuentes al usar sus datos.


Autor

Hayal Oezkan · github.com/malkreide


Créditos y proyectos relacionados

Servidor

Descripción

zh-education-mcp

Datos educativos del cantón de Zúrich

zurich-opendata-mcp

Datos abiertos de la ciudad de Zúrich

swiss-statistics-mcp

BFS STAT-TAB — estadísticas federales suizas

swisstopo-mcp

Geodatos federales suizos (swisstopo)

Licencia MIT. Dinero público, código público.

Available Tools

13 tools
check_dateA
Read-onlyIdempotent

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?"

Inputs: canton (required), check_date_iso (required), language, school_type. Returns: note, canton, source, matches, +5 more

compare_school_holidaysA
Read-onlyIdempotent

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.

Inputs: year (required), cantons (required), language, school_type. Returns: note, rows, year, source, +3 more

export_holidays_icsA
Read-onlyIdempotent

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.

Inputs: year (required), canton (required), include, language, +1 more. Returns: ics, note, year, canton, +5 more

find_common_free_windowA
Read-onlyIdempotent

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.

Inputs: year (required), cantons (required), language, min_days, +1 more. Returns: note, source, windows, provenance, +1 more

get_local_holidaysA
Read-onlyIdempotent

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.

Inputs: year (required), canton (required), municipality (required), language. Returns: note, count, source, holidays, +3 more

get_long_weekendsA
Read-onlyIdempotent

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.

Inputs: year (required). Returns: note, year, source, provenance, +2 more

get_public_holidaysA
Read-onlyIdempotent

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.

Inputs: year (required), canton (required), language. Returns: note, count, source, holidays, +3 more

get_school_holidaysA
Read-onlyIdempotent

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.

Inputs: canton (required), valid_to (required), valid_from (required), language, +1 more. Returns: note, count, source, holidays, +3 more

is_holiday_todayA
Read-onlyIdempotent

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?".

Inputs: canton (required), language, school_type. Returns: note, canton, source, matches, +5 more

list_cantonsA
Read-onlyIdempotent

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.

Inputs: language. Returns: note, source, cantons, provenance, +1 more

list_school_typesA
Read-onlyIdempotent

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.

Inputs: canton, language. Returns: note, source, provenance, retrieved_at, +1 more

next_school_holidaysA
Read-onlyIdempotent

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>

Inputs: canton (required), count, language, school_type. Returns: note, count, source, holidays, +3 more

source_statusA
Read-onlyIdempotent

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".

Inputs: no named parameters. Returns: note, source, sources, provenance, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 13 tools

    Disambiguation4/5

    The tools are largely distinct: each targets a specific resource or query type (e.g., list_cantons for codes, get_public_holidays for yearly public holidays, get_local_holidays for municipality specifics). Slight overlap exists between check_date and is_holiday_today (both check a date), and between get_school_holidays and next_school_holidays (both return school holiday periods), but use cases and parameters clearly separate them.

    Naming Consistency4/5

    The majority follow a clear verb_noun snake_case pattern (get_school_holidays, check_date, compare_school_holidays). A few deviate: source_status (noun_noun), next_school_holidays (adjective_noun), and is_holiday_today (verb but with an adjective). These are minor exceptions and still readable, but the pattern is not perfectly uniform.

    Tool Count5/5

    13 tools is well within the ideal 3-15 range for a focused domain. Each tool addresses a distinct need: canton resolution, holiday lookups, comparisons, convenience functions, health checks, and export. None feel redundant or missing, and the count matches the complexity of Swiss cantonal holiday variations.

    Completeness5/5

    The tool surface covers the full lifecycle of holiday queries: listing cantons, resolving codes, checking single dates, retrieving periods by range or upcoming, comparing across cantons, finding common windows, and exporting to .ics. It also handles public, school, and local holidays with type differentiation (Schulart). No obvious gaps for the stated use case of Swiss holiday planning.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers