GnistAI GnistAI
Log in

Nager.Date (Holidays)

Public holidays by country and year — dates, names, and types.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 5 tools tools 5 5 Reference

Data source: Nager.Date

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/nager-date/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-nager-date": {
      "url": "https://context.gnist.ai/mcp/nager-date/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/nager-date/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "check_holiday", "arguments": {"date": "example", "country_code": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/nager-date/

5 endpoints available:

Shell
curl "https://context.gnist.ai/rest/nager-date/check_holiday?date=example&country_code=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/nager-date/check_holiday",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "date": "example",
        "country_code": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc nager-date

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (5)

check_holiday
Check whether a given date is a public holiday in a country.
ParameterTypeRequiredDescription
datestringrequiredDate to check in ISO 8601 format (YYYY-MM-DD).
country_codestringrequiredISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').
region_codeanyoptionalOptional ISO 3166-2 region code (e.g. 'US-CA', 'DE-BY').
list_public_holidays
List all public holidays for a country in a given year.
ParameterTypeRequiredDescription
country_codestringrequiredISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').
yearintegerrequiredThe year (e.g. 2026).
get_next_business_day
Find the next business day on or after a given date, skipping weekends and holidays.
ParameterTypeRequiredDescription
datestringrequiredStarting date in ISO 8601 format (YYYY-MM-DD).
country_codestringrequiredISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').
count_business_days
Count business days between two dates (inclusive of start, exclusive of end).
ParameterTypeRequiredDescription
start_datestringrequiredStart date in ISO 8601 format (YYYY-MM-DD).
end_datestringrequiredEnd date in ISO 8601 format (YYYY-MM-DD). Not included in the count.
country_codestringrequiredISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related