ferien-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ferien-mcp 🏖️
mcp-name: io.github.mohammad-abbasi-sh/ferien-mcp
Unofficial read-only MCP server for German school holidays (Schulferien) via the ferien-api.de API (bundesAPI project): holidays per year and federal state, is-it-a-holiday checks, the next holiday from a date, and holidays in a date range. No key, no login.
Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with ferien-api.de / the bundesAPI project.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"ferien": {
"command": "uvx",
"args": ["ferien-mcp==0.1.0"]
}
}
}Or run locally: python -m ferien_mcp.server (needs mcp<2, httpx).
Related MCP server: vic-au-important-dates-mcp
Tools
Tool | Description |
| School holidays of one year in one federal state (optional month filter) |
| Is a date (YYYY-MM-DD) inside the school holidays in one state? |
| The next school holiday on or after a date (returns the ongoing one if inside a holiday; looks into the next year) |
| School holidays overlapping a date range (max ~2 years) |
| All 16 German federal states |
| Reachability check (ok / blocked / error) — one polite request |
Example output (ferien_is_holiday / 2026-08-10, BY):
{"date": "2026-08-10", "weekday": "Monday", "weekday_de": "Montag",
"state": "BY", "state_name": "Bayern", "is_holiday": true,
"holidays": ["sommerferien bayern 2026"],
"details": [{"name": "sommerferien bayern 2026", "kind": "sommerferien",
"slug": "sommerferien bayern 2026-2026-BY", "state": "BY",
"year": 2026, "start": "2026-08-03", "end": "2026-09-15",
"duration_days": 44, "start_weekday": "Monday",
"start_weekday_de": "Montag", "end_weekday": "Tuesday",
"end_weekday_de": "Dienstag"}]}Notes:
State codes are the 2-letter codes: BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH. There is no nationwide list — school holidays are per-state, so every query needs one state. Use
ferien_list_statesfor the full list.Holiday names are German ("sommerferien bayern 2026"); each row also carries a
kind(winterferien, frühjahrsferien, osterferien, pfingstferien, sommerferien, herbstferien, weihnachtsferien, beweglicher ferientag) and the duration in days.Coverage varies by state and year: the API returns an empty list for a state/year it has no data for — e.g. Berlin 2026 was empty on 2026-11-14 while Berlin 2025 has 7 entries. Verify important dates against the official source.
Cross-year holidays (e.g. Weihnachtsferien running into January) are included by
ferien_holidays_betweenwhen they overlap the range.Years 2000–2100 are accepted.
The API rate-limits aggressively per IP (its docs: "heavily abused, aggressive rate limiting is in place"). If a call reports HTTP 429, wait a few minutes and retry — on 2026-11-14 the limit cleared after ~10 minutes.
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
KVK Handelsregister AI Connect: hosted MCP server for the Dutch business register.
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceMCP server for accessing Nager.Date public holidays data. It provides tools to query and retrieve holiday information for various countries through natural language or direct tool calls.8 npmMIT
- AlicenseAqualityDmaintenanceProvides access to Victoria, Australia's public holidays and important dates via an MCP server.1MIT
- AlicenseAqualityBmaintenanceMCP server for Swiss school and public holidays across all 26 cantons, with differentiation by school type. No API key required.1344 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables querying public holiday data by country and year, checking if today is a holiday, and listing upcoming holidays through the MCP protocol.87 npmMIT