MCP server for AI assistants

Ask Claude, ChatGPT or Cursor for your vacation plan directly. The urlaub-smart.de MCP server exposes public holidays, bridge days and the optimal plan as tools for any assistant that speaks the Model Context Protocol.

Endpoint (Streamable HTTP, no authentication)

https://urlaub-smart.de/api/mcp

Tools

plan_vacation: Optimal yearly plan for region, year, vacation days, school-holiday mode and strategy. Returns the blocks with booking dates, factor and a link to the interactive plan.
best_bridge_days: The six best levers of the year: bridge days and holiday clusters.
public_and_school_holidays: All public holidays with weekday and scope plus the school holiday periods.
list_regions: All supported countries and regions with codes and slugs.

Setup

Claude (desktop and claude.ai): Settings → Connectors → “Add custom connector”, paste the URL.

Cursor, Windsurf, VS Code: add to your MCP configuration:

{
  "mcpServers": {
    "urlaub-smart": {
      "url": "https://urlaub-smart.de/api/mcp"
    }
  }
}

Clients that only speak stdio (older Claude Desktop versions):

{
  "mcpServers": {
    "urlaub-smart": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://urlaub-smart.de/api/mcp"
      ]
    }
  }
}

Example prompt

“I work in Bavaria, have 30 vacation days in 2027 and kids in school. How should I place my vacation?”

Free, no key, 60 requests per minute per IP. Data: OpenHolidaysAPI. No tracking.