Date Math / Tools / public_holidays

Public holidays for 207 countries

List public holidays (bank holidays, national holidays) for a country and year: 207 countries, 2000–2050. Use for holiday calendars, office closures and checking if a date is a holiday. Lunar or government-proclaimed dates are rule-based estimates.

MCP tool public_holidaysHTTP POST /v1/holidays25 free calls a day, then $0.001

Try it

Runs the real tool over MCP. Edit the arguments and run. Uses your daily free calls.

public_holidays

result

{
  "country": "PH",
  "country_name": "Philippines",
  "year": 2026,
  "type": "public",
  "count": 13,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day"
    }
  ],
  "source": "date-holidays (CC BY 3.0)"
}

The result shown before you run is a saved example response.

Use it from your agent

Add the MCP server once and your agent can call public_holidays and the other 19 tools.

Claude Code

One command in your terminal.

claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp

Any MCP client

Claude Desktop, Cursor, VS Code, Windsurf.

{
  "mcpServers": {
    "date-math": {
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

HTTP + x402

POST JSON; pay the 402 with any x402 client.

curl -X POST https://date-math.datemath.workers.dev/v1/holidays \
  -H "Content-Type: application/json" \
  -d '{"country":"PH","year":2026}'

Full schema: OpenAPI · llms.txt