Local MCP server for Polish public holidays and business-day math.
Six well-named, read-only tools with clear descriptions and complete JSON schemas. All tools follow verb_noun naming (list_, is_, count_, add_, next_). Descriptions are 50 - 200 chars, matching production baselines. Input schemas include types and descriptions for all parameters. However, output schemas are not documented, LLMs cannot predict response structure. Error handling is minimal; no recovery guidance or validation messages. Missing tool annotations (readOnlyHint). Parameter descriptions could be more prescriptive about format constraints (e.g., 'YYYY-MM-DD' is stated but not formalized as a pattern).
Add N business days to a start date and return the resulting date. N can be negative to subtract. Skips weekends and Polish public holidays. If start_date is itself a non-business day, counting starts from the next business day.
Count business days between two dates (inclusive), skipping weekends and Polish public holidays. Useful for enforcing '14-dni-roboczych' style payment terms.
Check whether a date is a Polish business day — Monday–Friday and not a public holiday. Returns the answer plus the reason (weekend / holiday / business_day).
Check whether a specific date is a public holiday in Poland. Returns holiday details if yes, null if no.
List all Polish public holidays in a given year. Each holiday has date, localName (Polish name), name (English name), and type. Defaults to Poland but supports any ISO 3166-1 alpha-2 country code.
Get the upcoming public holidays (default: next 5) from a given date. Handy for planning around long weekends.
Output schemas not documented. LLMs cannot predict response structure (fields, types, nesting). Agents must infer from examples or fail on unexpected formats.
No tool annotations (readOnlyHint). All tools are read-only but lack explicit hints. Agents cannot distinguish safe tools from destructive ones without reading descriptions.
Error handling absent. No recovery guidance, validation messages, or error categorization. If Nager.Date API fails or input is invalid, agents receive raw exceptions with no actionable next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
Parameter format constraints not formalized. 'YYYY-MM-DD' is mentioned in descriptions but not declared as a JSON Schema pattern. LLMs may pass invalid dates (e.g., '2024-13-45').
next_holidays has no required parameters. from_date and count both optional; defaults to 'today' and 5. Ambiguous for agents, unclear if omitting from_date triggers today or an error.