European public + school holidays with regional subdivisions via @pipeworx/mcp-openholidays — 4 tools, 36 countries

@pipeworx/mcp-openholidays v0.1.0 — Verified Recipe

Package: @pipeworx/mcp-openholidays (npm, library-style McpToolExport) Transport: Library import ({tools, callTool}) — NOT stdio server API: openholidaysapi.org (keyless, free)

Setup

npm install --prefix /tmp/openholidays @pipeworx/mcp-openholidays
cp /tmp/openholidays/node_modules/@pipeworx/mcp-openholidays/src/index.ts /tmp/openholidays/openholidays.ts
# TypeScript source only — copy out of node_modules for --experimental-strip-types
node --experimental-strip-types --no-warnings --input-type=module <<'SCRIPT'
import pack from "./openholidays.ts";
const result = await pack.callTool("public_holidays", {
  country: "DE", valid_from: "2026-01-01", valid_to: "2026-12-31"
});
console.log(JSON.stringify(result));
SCRIPT

4 Tools

19 Verified Calls — 100% Success

1. list_countries — 36 countries (not ~30): AD, AL, AT, BE, BG, BR, BY, CH, CZ, DE, EE, ES, FR, GB, GR, HR, HU, IE, IT, LI, LT, LU, LV, MC, ME, MK, MT, NL, PL, PT, RO, RS, SE, SI, SK, SM
2. list_countries language=DE — localized names work (Österreich, Schweiz, Deutschland)
3. list_subdivisions DE — 16 federal states (DE-BB Brandenburg through DE-TH Thuringia)
4. list_subdivisions CH — 26 cantons (AG through ZH, category="canton")
5. public_holidays DE 2026 — 20 holidays; regional ones tagged with subdivisions (Epiphany: BW/BY/ST only; Women's Day: BE/MV only)
6. public_holidays FR Jun-Aug 2026 — 3 holidays (Jun 10 Abolition of slavery in GY=French Guiana, Jul 14 National Day, Aug 15 Assumption)
7. public_holidays NL Dec language=TR — ⚠️ NAMES NOT LOCALIZED TO TURKISH (returned "Christmas Day" not Turkish translation — language coverage limited)
8. school_holidays DE Jun-Sep 2026 — 20 entries per-state; Summer varies by state (Saarland Jun 29-Aug 7, Bavaria Aug 3-Sep 14, Berlin Jul 9-Aug 21)
9. school_holidays DE-BY only — correctly filtered to 2: Pentecost May 26-Jun 5 + Summer Aug 3-Sep 14
10. school_holidays CH Jun-Sep — 47 entries per-canton; Ticino earliest (Jun 18-Aug 30), Basel Jun 27-Aug 9
11. public_holidays XX (invalid) — 0 results, no error (graceful)
12. public_holidays TR — ⚠️ TURKEY NOT COVERED (0 holidays despite being geographically European — not in the 36 countries)
13. public_holidays DE missing dates — validation error: "validfrom and validto are required"
14. list_subdivisions ZZ — 0 results, no error (graceful)
15. public_holidays BR 2026 — ⚠️ BRAZIL IN COUNTRY LIST BUT 0 DATA (indexed but no holidays loaded)
16. public_holidays IT Dec — 2 holidays (Christmas Day + St. Stephen's Day)
17. list_subdivisions BE — ⚠️ BELGIUM HAS 0 SUBDIVISIONS (despite having 3 regions: Flanders, Wallonia, Brussels — no regional granularity)
18. school_holidays ES Jun-Sep — 28 entries with SUB-REGIONAL codes (AN-GR=Andalusia-Granada, RI=La Rioja, CM=Castilla-La Mancha)
19. public_holidays DE empty range — 0 results for Mar 1-5 (no holidays that week), graceful

Critical Gotchas

1. ⚠️ NOT a stdio server — library-style {tools, callTool} export; TypeScript source only (no dist), must copy .ts out of node_modules for --experimental-strip-types
2. ⚠️ Brazil in country list but has 0 holiday data — list_countries returns BR but public_holidays returns empty
3. ⚠️ Turkey NOT covered — despite geographic proximity, TR returns 0 results
4. ⚠️ Holiday name localization LIMITED — language param localizes country/subdivisio