Nager Date

live Data

Nager.Date MCP — Public holiday and date utility API (free, no auth)

4 tools
0ms auth
free tier 50 calls/day

Tools

get_holidays

Get all public holidays for a country and year. Returns holiday names, dates, and types (public, bank, school, etc.). Example: get_holidays(2025, "US").

No parameters required.

▶ Try it
is_today_holiday

Check if today is a public holiday in a given country. Returns true/false. Example: is_today_holiday("US").

No parameters required.

▶ Try it
get_long_weekends

Get long weekends (3+ consecutive days off) for a country and year. Shows which weekends can become long breaks, including whether a "bridge day" (vacation day) is needed. Great for trip planning. Exa

No parameters required.

▶ Try it
list_countries

List all countries supported by the holiday API with their ISO country codes. Use these codes with get_holidays and other tools.

No parameters required.

▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/nager-date/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/nager-date/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_holidays","arguments":{}}}'