School Vacation

You can query and retrieve school vacation calendars for Belgium, the Netherlands, and Luxembourg (2019–2028) using MCP. This server provides a lightweight, authenticated API to check specific dates, list regions, and retrieve vacation periods across regions, all with audit logging and flexible deployment options.

How to use

You interact with the server through an MCP client. Start the server using the mode that fits your environment, then connect via the MCP protocol or through the REST/HTTP endpoints if you are using the combined HTTP+MCP setup. You can perform the following actions: verify whether a date is a vacation in a given region, fetch all vacation periods for a region (optionally filtered by year), and obtain the list of all supported regions.

How to install

Prerequisites: Node.js, npm, and optional Docker if you plan to run in containers.

# Install dependencies
npm install

# Build the project
npm run build

Additional sections

Configuration and runtime behavior are designed to support both development and production environments. In development, authentication is disabled to simplify local testing. In production, you enable authentication by setting a token and starting the MCP server accordingly.

Security and deployment considerations include using a secure token, enabling HTTPS/TLS in production, and rotating credentials regularly. Audit logging is active for all requests to help you monitor usage patterns and detect anomalies.

Data coverage includes the specified regions (Belgium: Flanders and Wallonia; Netherlands: North, Middle, South; Luxembourg) for years 2019 through 2028, with details on weekends, holidays, and school vacation flags per region.

If you need a quick health check or basic connectivity tests, you can probe the server’s health endpoints when using the HTTP+MCP setup.

Troubleshooting tips cover common issues such as port conflicts, authentication errors, and Docker-related problems. Always ensure your authentication token is set when running in production and verify logs if something does not respond as expected.

Available tools

check_school_vacation

Checks if a specific date is a school vacation day for the given region.

get_vacation_periods

Retrieves all school vacation periods for a region, optionally filtered by year.

get_supported_regions

Returns a list of all regions supported by the server.