Public Holidays (Nager.Date)

live Utility

Nager.Date Public Holidays MCP.

4 tools
0ms auth
free tier 50 calls/day

Tools

public_holidays

List all public holidays for a given year and country from Nager.Date. Returns each holiday with its date, local + English name, whether it is nationwide (global), the subdivisions (counties) it appli

No parameters required.

▶ Try it
next_holidays

List the upcoming public holidays for a country over the next 365 days, from Nager.Date. Returns each holiday with date, local + English name, nationwide flag, subdivisions, and types. Keyless.

No parameters required.

▶ Try it
available_countries

List every country supported by Nager.Date, with its ISO-3166-1 alpha-2 code and English name. Use these codes for public_holidays, next_holidays, and long_weekends. Keyless.

No parameters required.

▶ Try it
long_weekends

List the long weekends for a given year and country from Nager.Date — multi-day stretches of weekends + public holidays, including whether a bridge day off is needed to connect them. Keyless.

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-holidays/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-holidays/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"public_holidays","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("public_holidays", {});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("nager");