Loading ToolBench

Reading the current corpus…

swiss-holidays-mcp MCP server · B · ToolBench

swiss-holidays-mcp

Swiss holiday calendar for AI agents — public holidays, school holidays (by Schulart) and long weekends for all 26 cantons

<=2025-11-2510 tools

70/100

Definition Quality84

Protocol Readiness76

Supportability41

Spec posture

Inferred effective spec <=2025-11-25·current baseline 2026-07-28

Static source inference · medium confidence · detected: Logging

Deprecated protocol patterns detected

Summary

Strong foundation with 10 well-named tools following verb_noun convention (list_, get_, check_, compare_, find_, export_). All tools have descriptions (avg 95 chars, within 10-1024 range). Input schemas are comprehensive with regex patterns and type constraints. Tool annotations present (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Key gaps: output schemas not explicitly documented in source; error handling guidance minimal; some parameter descriptions could be more prescriptive about constraints and dependencies.

Tools (10)

check_dateread onlysource verified83/100

Check if a specific date is a holiday in a canton

compare_school_holidaysread onlysource verified80/100

Compare school holidays across multiple cantons for a specific year

export_icsread only50/100

Export holidays as an iCalendar (.ics) file for a canton and year

find_free_windowread only50/100

Find a free window (no holidays) between two dates in a canton

get_long_weekendsread onlysource verified85/100

Get long weekends (3+ consecutive days off) for a specific canton and year

get_public_holidaysread onlysource verified90/100

Get public holidays for a specific canton and year

get_school_holidaysread onlysource verified85/100

Get school holidays for a specific canton, year, and optional school type

get_statusread only

Issues (5)

HIGHtool ↗

Output schemas not documented in source code. While input schemas are comprehensive, return types for each tool are not explicitly declared, forcing LLMs to infer structure from tool names alone.

list_cantonslist_school_typesget_public_holidaysget_school_holidaysget_long_weekendscheck_datecompare_school_holidaysfind_free_windowexport_icsget_status

HIGHrecovery-guide ↗

Error handling guidance absent. Tools return UpstreamError but no recovery hints provided. LLMs cannot determine if errors are retryable, user-fixable, or fatal.

get_public_holidaysget_school_holidaysget_long_weekendscheck_datecompare_school_holidaysfind_free_windowexport_icsget_status

MEDIUMconstrained-input ↗

Recommendations

Document output schemas for all 10 tools. Include field names, types, and descriptions. Example: 'Returns {cantons: [{code: string, name: string, language: string}], total: number}'.
Add error handling guidance to tool descriptions. Example: 'If upstream API is unavailable, returns UpstreamError (retryable). If canton code is invalid, returns validation error (user-fixable).'
Expand parameter descriptions to include constraint details. Example: 'Language code (DE, FR, IT, or EN; case-insensitive)' instead of relying on regex pattern alone.
Document result limits and pagination. Example: 'Returns up to 26 cantons. No pagination needed (fixed set).' For compare_school_holidays: 'Limit to 5 cantons per call to avoid large responses.'
Clarify get_status purpose and output. Example: 'Returns health status of upstream holiday data sources (openholidays.io, nager.date). Fields: {source: string, status: 'healthy'|'degraded'|'unavailable', last_check: ISO8601, message?: string}'.

Spec posture evidence

Inferred effective spec: <=2025-11-25.

Relies on Logging (deprecated) - log to stderr or use OpenTelemetry

Score history

Overall score trend

First recorded score · v2 rubric

70/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	B	70	<=2025-11-25	v2