Skip to main content

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

Tools

Tool Description
ferien_list_holidays School holidays of one year in one federal state (optional month filter)
ferien_is_holiday Is a date (YYYY-MM-DD) inside the school holidays in one state?
ferien_next_holiday The next school holiday on or after a date (returns the ongoing one if inside a holiday; looks into the next year)
ferien_holidays_between School holidays overlapping a date range (max ~2 years)
ferien_list_states All 16 German federal states
ferien_health 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_states for 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_between when 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

Metadata

Release files for ferien-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ferien-mcp 0.1.0
File Size Uploaded Provenance Actions
ferien_mcp-0.1.0.tar.gz 17.3 kB With provenance Details for ferien_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ferien-mcp 0.1.0
File Interpreter ABI Platform Actions
ferien_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for ferien_mcp-0.1.0-py3-none-any.whl

Total release size: 29.0 kB

Release files / ferien_mcp-0.1.0.tar.gz

Download URL ferien_mcp-0.1.0.tar.gz
Size 17.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ed39a8fe129c4097b50d32de45dcdcee0519ea1a57b00a6d9d00bc375d8120c9
BLAKE2b-256 checksum
How to use checksums
e65df357e96538375ef76d4704f2a3e1f77e714a699396c9f10376fd6ccbb6a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / ferien_mcp-0.1.0-py3-none-any.whl

Download URL ferien_mcp-0.1.0-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5b5c684a68d32b44df615c2c33f0627ac208459f6b785eb7c1663f4d2551f866
BLAKE2b-256 checksum
How to use checksums
7bb2601054174a7f9049ba9338621032caa88567318d5e5586dc28d3f25f76b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for ferien-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ferien_mcp-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page