MCP Server for Canada Holidays

6 tools

A small, precise API for Canadian statutory holidays: which days are observed nationally, which are observed only in a given province or territory, and the exact date each falls on for a requested year. Federal and provincial rules differ, and this API encodes that difference rather than flattening it.

Tools: 6
Read-only: 6
Write: 0
Destructive: 0
Verified: 5
Free tier: yes
Auth: none

Tool definitions

6 ready-to-use tool definitions in JSON. Drop the file into your agent configuration; no need to read the API documentation first.

canada-holidays.json

Download

All 6 tools

get_api_v1GET /api/v1Returns a welcome message.nonereadsverified 2026-09-25

Returns a welcome message.

get_api_v1_holidaysGET /api/v1/holidaysReturns Canadian public holidays.nonereadsverified 2026-09-25

Returns Canadian public holidays. Each holiday lists the regions that observe it.

Parameter	In	Type	Required
`year`	query	integer	no
`federal`	query	string	no
`optional`	query	string	no

get_api_v1_holidays_by_holidayidGET /api/v1/holidays/{holidayId}Returns one Canadian statutory holiday by integer id.holidayIdreadsverified 2026-09-25

Returns one Canadian statutory holiday by integer id. Returns a 404 response for invalid ids.

Parameter	In	Type	Required
`holidayId`	path	integer	yes
`year`	query	integer	no
`optional`	query	string	no

get_api_v1_provincesGET /api/v1/provincesReturns provinces and territories in Canada.nonereadsverified 2026-09-25

Returns provinces and territories in Canada. Each province or territory lists its associated holidays.

Parameter	In	Type	Required
`year`	query	integer	no
`optional`	query	string	no

get_api_v1_provinces_by_provinceidGET /api/v1/provinces/{provinceId}Returns a Canadian province or territory with its associated holidays.provinceIdreadsverified 2026-09-25

Returns a Canadian province or territory with its associated holidays. Returns a 404 response for invalid abbreviations.

Parameter	In	Type	Required
`provinceId`	path	string	yes
`year`	query	integer	no
`optional`	query	string	no

get_api_v1_specGET /api/v1/specGets the schema for the JSON API as a yaml file.nonereadsmismatch

Gets the schema for the JSON API as a yaml file.

Authentication

No key and no published rate limit

Where this came from

Built from the APIs.guru OpenAPI specification, version 1.8.0, last changed upstream on 2023-02-17. Rebuilt on our side on 2026-09-25.

View the source specification