Australian Holidays & School Terms MCP

Overview

An MCP server providing Australian public holidays and school term dates for AI assistants. Covers all 8 states and territories with data sourced from official government APIs and education departments.

MCP Tools

States/Territories

500+

Holidays

School Terms

The Problem

AI assistants frequently need to answer questions about Australian dates:

“When’s the next public holiday in Victoria?”
“Is next Monday a school day in NSW?”
“What are the Term 2 dates for Queensland?”

Currently this requires manual lookups across multiple state government websites. Each state has different data formats, APIs, and update schedules.

Solution

Unified MCP server with 5 tools covering all date queries:

Public Holidays2

List and next upcoming

School Terms3

Terms, dates, holiday check

MCP Tools

Tool	Description
`get_public_holidays`	List holidays for a state within date range
`get_next_holiday`	Next upcoming public holiday from a date
`get_school_terms`	Get all term dates for a state and year
`get_term_dates`	Specific term (1-4) start/end dates
`is_school_holiday`	Check if a date falls during school holidays

Data Sources

Public Holidays

Source	Coverage
data.gov.au API	All states, 2021-2026
Weekly refresh	Automatic via cron trigger

School Terms

State	Source
VIC	developer.vic.gov.au API
NSW	education.nsw.gov.au ICS
QLD	education.qld.gov.au
WA	education.wa.edu.au
SA	education.sa.gov.au
TAS	decyp.tas.gov.au
ACT	ACT Education Directorate
NT	NT Department of Education

Features

Complete Coverage - All 8 states/territories (ACT, NSW, NT, QLD, SA, TAS, VIC, WA)
Official Data - Government sources only
Daily Refresh - Cron trigger updates data automatically
Multi-Year - 2024-2026 coverage
Fast Edge - Sub-100ms responses via Cloudflare Workers

Architecture

MCP Request
    ↓
Cloudflare Workers (Hono)
    ↓
Check KV Cache
    ↓
Query D1 Database
    ↓
Return ISO 8601 Dates

Scheduled Refresh (Daily):
├── data.gov.au → Public Holidays
├── VIC API → VIC Terms
├── NSW ICS Parser → NSW Terms
└── State Parsers → Other 6 States

Tech Stack

Runtime: Cloudflare Workers
Framework: Hono
Database: D1 (SQLite at edge)
Cache: KV for fast lookups
Protocol: Model Context Protocol
Scheduling: Cron Triggers

Use Cases

Calendar Integration - AI assistants can check availability around holidays

School Planning - Answer parent queries about term dates and school holidays

Business Scheduling - Avoid booking meetings on public holidays

Travel Planning - Know peak holiday periods for travel advice

Event Planning - Schedule events outside school terms or on long weekends