{"openapi":"3.0.3","info":{"title":"Gnist Context — Nager.Date (Holidays)","description":"Public holidays by country and year — dates, names, and types.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nager-date/`\n- **Toolkit page:** `/toolkits/nager-date`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/nager-date/check_holiday":{"post":{"tags":["Reference"],"summary":"check_holiday","description":"Check whether a given date is a public holiday in a country.\n\nArgs:\n    date: Date to check in ISO 8601 format (YYYY-MM-DD).\n    country_code: ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').\n    region_code: Optional ISO 3166-2 region code (e.g. 'US-CA', 'DE-BY').\n\nReturns:\n    Dictionary with is_holiday (bool) and holiday_names (list of matching names).","operationId":"nager_date_check_holiday","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"date":{"description":"Date to check in ISO 8601 format (YYYY-MM-DD).","type":"string"},"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').","type":"string"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional ISO 3166-2 region code (e.g. 'US-CA', 'DE-BY')."}},"required":["date","country_code"],"type":"object"}}}}}},"/rest/nager-date/list_public_holidays":{"post":{"tags":["Reference"],"summary":"list_public_holidays","description":"List all public holidays for a country in a given year.\n\nArgs:\n    country_code: ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').\n    year: The year (e.g. 2026).\n\nReturns:\n    Dictionary with count and holidays list. Each holiday has date, name,\n    local_name, global flag, counties, and types.","operationId":"nager_date_list_public_holidays","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').","type":"string"},"year":{"description":"The year (e.g. 2026).","type":"integer"}},"required":["country_code","year"],"type":"object"}}}}}},"/rest/nager-date/get_next_business_day":{"post":{"tags":["Reference"],"summary":"get_next_business_day","description":"Find the next business day on or after a given date, skipping weekends and holidays.\n\nArgs:\n    date: Starting date in ISO 8601 format (YYYY-MM-DD).\n    country_code: ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').\n\nReturns:\n    Dictionary with next_business_day date and days_skipped count.","operationId":"nager_date_get_next_business_day","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"date":{"description":"Starting date in ISO 8601 format (YYYY-MM-DD).","type":"string"},"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').","type":"string"}},"required":["date","country_code"],"type":"object"}}}}}},"/rest/nager-date/count_business_days":{"post":{"tags":["Reference"],"summary":"count_business_days","description":"Count business days between two dates (inclusive of start, exclusive of end).\n\nArgs:\n    start_date: Start date in ISO 8601 format (YYYY-MM-DD).\n    end_date: End date in ISO 8601 format (YYYY-MM-DD). Not included in the count.\n    country_code: ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').\n\nReturns:\n    Dictionary with business_days count and calendar_days in the range.","operationId":"nager_date_count_business_days","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"start_date":{"description":"Start date in ISO 8601 format (YYYY-MM-DD).","type":"string"},"end_date":{"description":"End date in ISO 8601 format (YYYY-MM-DD). Not included in the count.","type":"string"},"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'NO', 'US', 'DE').","type":"string"}},"required":["start_date","end_date","country_code"],"type":"object"}}}}}},"/rest/nager-date/report_feedback":{"post":{"tags":["Reference"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"nager_date_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Reference","description":"Data sources: Reference"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}