← World Public Holidays
calendar by fourzerotwo
Holiday & business-day check
Is a date a public holiday or business day in a country; add N business days; next business day.
Holiday & business-day check Free
Is a date a public holiday or business day in a country; add N business days; next business day.
- cost
- Free then $0.001 / call
- MCP tool
- holidays__check
- method
- GET
Free up to 50 calls a day over MCP (500 with a free key), then $0.001 per call by card credit or USDC. Free key · Pay by card
GET https://fourzerotwo.si/v1/holidays/check
| Param | Type | Description |
|---|---|---|
| country | string | ISO code |
| date | string | YYYY-MM-DD |
| add? | integer | Business days to add |
# free: send a free key from https://fourzerotwo.si/free curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/holidays/check?country=US&date=2026-11-26" # no key: returns 402 with the price, for x402 agents curl -i "https://fourzerotwo.si/v1/holidays/check?country=US&date=2026-11-26"
by fourzerotwo
Report this endpoint
Use it from an AI agent (MCP)
Add the server once, then ask for this data in plain English. The agent finds the endpoint with search_apis and runs it with call_api.
{
"mcpServers": {
"fourzerotwo": { "type": "http", "url": "https://fourzerotwo.si/mcp" }
}
}
# the call the agent makes
call_api {"tool": "holidays__check", "arguments": {"country":"US","date":"2026-11-26","add":3}}
More from World Public Holidays
- Holidays in a year — Official public holidays for a country (or region provider, e.g. Germany/Bavaria) in a year.
- Supported countries — Every country and regional provider supported.
Holiday rules via Yasumi (MIT licence). Calculations by fourzerotwo.