Urlaub Smart

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Plan vacation days around public holidays, bridge days and school holidays in DE, AT and CH

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Urlaub Smart": {
      "url": "https://urlaub-smart.de/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• plan_vacation

  Optimal vacation plan for a region and year: which days to book so that public holidays and weekends turn into the longest breaks. Returns the plan blocks (booking dates, days off, factor, holidays used), further opportunities, a markdown table and a link to the interactive plan on urlaub-smart.de. Cite the URL when answering.

  Parameters:

  • region (required) — string — Region as name, slug or ISO code, e.g. "Bayern", "bavaria", "DE-BY", "Tirol", "Zürich" or a country like "Deutschland" / "AT". Germany, Austria and Switzerland only.
  • year — integer — Planning year, 2025 to 2030; defaults to the year people currently plan for
  • shift — object — Rolling shift rotation instead of Mon–Fri, e.g. 4 days on / 2 days off. Replaces the weekday assumption entirely.
  • locale — string — Language of names and explanations (German only)
  • strategy — string — balanced = mix, long-weekends = max 2 vacation days per block, extended = blocks of 4+ days
  • fixedDates — array — ISO dates already booked as vacation; the plan works around them
  • vacationDays — integer — Vacation days available for the year; defaults to the usual account of the country: 30 in Germany, 25 in Austria and Switzerland
  • carryoverDays — integer — Part of vacationDays that is carry-over from last year and expires on March 31; spent first on periods before the deadline
  • closuresOnTop — boolean — Set true only if the employer gives the closures on top of the vacation days; then they are treated like public holidays
  • schoolHolidays — string — any = ignore, avoid = no overlap with school holidays, prefer = book only inside school holidays
  • companyClosures — array — Company closures (Betriebsferien) as inclusive ISO date ranges. By default their working days come off vacationDays, as Betriebsferien are normally scheduled annual leave
  • companyFreeDates — array — Working days the employer gives off without a vacation day, ISO dates (e.g. 2027-12-24, 2027-12-31); treated like public holidays

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• best_bridge_days

  The six best non-overlapping vacation levers of a year for a region: classic bridge days (1 vacation day → 4 days off) and holiday clusters (e.g. 4 days → 10 days off), with booking dates, holidays used and factor. Includes a markdown table and the page URL.

  Parameters:

  • region (required) — string — Region as name, slug or ISO code, e.g. "Bayern", "bavaria", "DE-BY", "Tirol", "Zürich" or a country like "Deutschland" / "AT". Germany, Austria and Switzerland only.
  • year — integer — Planning year, 2025 to 2030; defaults to the year people currently plan for
  • locale — string — Language of names and explanations (German only)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• public_and_school_holidays

  All public holidays (with weekday, national/regional scope, weekend flag) and school holiday periods for a region and year. Source: OpenHolidaysAPI.

  Parameters:

  • region (required) — string — Region as name, slug or ISO code, e.g. "Bayern", "bavaria", "DE-BY", "Tirol", "Zürich" or a country like "Deutschland" / "AT". Germany, Austria and Switzerland only.
  • year — integer — Planning year, 2025 to 2030; defaults to the year people currently plan for
  • locale — string — Language of names and explanations (German only)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• childcare_gap

  How much of a region's school holidays two vacation accounts cover, and which weeks stay open. School holidays run to about 60 working days a year while a vacation account holds 25 to 30 days, so a care day always costs exactly one vacation day and a joint family holiday costs two and covers one. Answers "can we cover the school holidays" for parents.

  Parameters:

  • region (required) — string — Region as name, slug or ISO code, e.g. "Bayern", "bavaria", "DE-BY", "Tirol", "Zürich" or a country like "Deutschland" / "AT". Germany, Austria and Switzerland only.
  • year — integer — Planning year, 2025 to 2030; defaults to the year people currently plan for
  • locale — string — Language of names and explanations (German only)
  • jointDays — integer — Care days the family wants to spend together; they cost both parents a day and cover one. Default 10.
  • vacationDays — integer — Vacation days of the first parent; defaults to 30 in Germany, 25 in Austria and Switzerland
  • partnerVacationDays — integer — Vacation days of the second parent; omit to ask for one person alone

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_regions

  Countries and their regions (German states, Austrian states, Swiss cantons, …) with codes, names and slugs accepted by the other tools.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.