# Nager.Date MCP > Nager.Date provides an open standard API for auditing global public holidays and international calendar events across over 100 countries. Your AI agent accesses this data instantly, letting you check if a date is a holiday anywhere in the world or retrieve full lists of national holidays for any given year. Stop cross-referencing Google's calendar; let your agent handle complex global scheduling checks. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** public-holidays, global-events, calendar-data, regional-data, date-calculation ## Description Nager.Date gives your AI client instant access to global public holiday data for over 100 countries. Forget cross-referencing ten different regional calendars; your agent handles all the complexity instantly. You'll get accurate, standardized holiday schedules worldwide. ### Checking Dates and Statuses When you need to know if a specific country is taking time off today, your agent checks that right away using `is_holiday_today`. It confirms whether any given date marks a public holiday for the nation you're focused on. If you're planning an immediate launch or campaign, this check tells you if operations are paused. To look ahead, you can ask your agent to pull the next scheduled holidays in a single country using `get_next_holidays`, which pulls all upcoming dates for that specific market. For global awareness, you don't have to run separate queries for every continent. Your agent runs `get_next_holidays_worldwide` and lists all approaching public holidays occurring globally across multiple countries simultaneously. This is perfect when you're coordinating a product launch or event that touches several different time zones. If you need to audit years of historical data, you can specify a country and a year range with `get_public_holidays`. That tool retrieves every single public holiday record for the chosen nation and date span. ### Country Data and Scope Need background info on where you're operating? Your agent uses `get_country_details` to pull basic metadata about a country, like its common name or geographic region. This helps localize your content or understand market context quickly. You can find out exactly which markets the server supports by calling `list_available_countries`, which lists every single supported country code and name. ### How It Works When You Use It You tell your agent what you need—like, 'What are the holidays in Mexico and Japan for 2025?' Your agent doesn't browse Google; it executes `get_public_holidays` for both countries with the year 2025. If you ask, 'Is tomorrow a holiday anywhere I should care about?', your agent checks global dates using `get_next_holidays_worldwide`. It handles the intricate mapping of rules and exceptions that make international scheduling so complicated. This server lets you run entire global event research workflows through natural language commands. You don't have to manually consult multiple regional calendars anymore; your agent manages all the complexity. It instantly pulls public holiday lists for over 100 countries, audits upcoming events across continents, and identifies regional variations—all without you ever touching a manual calendar or wrestling with conflicting data sources. It’s about saving time on tedious cross-checking. You just ask your agent to check the status of a date, pull a list for an entire year, or track global dates for multiple countries at once. It gives you clean, reliable scheduling facts every single time. ## Tools ### get_country_details Gets additional metadata for a specific country using its code. ### is_holiday_today Checks if the current day is designated as a public holiday in a specific country. ### get_next_holidays_worldwide Finds and lists the upcoming public holidays occurring globally across multiple countries. ### get_next_holidays Retrieves the next scheduled public holidays specifically for one country. ### get_public_holidays Retrieves every public holiday for a specified country and year range. ### list_available_countries Lists every single country code and name supported by Nager.Date. ## Prompt Examples **Prompt:** ``` What are the public holidays in 'US' for 2024 using Nager.Date? ``` **Response:** ``` I've retrieved the 2024 public holidays for the United States. Notable dates include New Year's Day on January 1st and Independence Day on July 4th. Would you like the full list of dates? ``` **Prompt:** ``` Is today a public holiday in Brazil? ``` **Response:** ``` I've checked the holiday status for Brazil. Today is not identified as a public holiday. The next upcoming holiday is Tiradentes Day on April 21st. ``` **Prompt:** ``` Show the next 5 public holidays occurring worldwide. ``` **Response:** ``` I've identified the next 5 global holidays. They include events in countries like Australia, India, and Norway. Would you like the local names and specific dates for each? ``` ## Capabilities ### Check Today's Holiday Status Your agent confirms if a specific country has a public holiday on the current date. ### List All Holidays for a Year The agent retrieves every public holiday record for a given country and year range. ### Find Next Holiday in Country Your agent pulls the next scheduled public holidays happening within a specific country. ### Track Global Events The agent identifies and lists upcoming global holidays across multiple countries simultaneously. ### Get Country Metadata Your agent pulls basic data points for a country, like its common name or region. ## Use Cases ### Auditing Global Launch Dates A product owner needs to launch in five countries next quarter. They ask their agent: 'What are the public holidays for US, Canada, Brazil, Japan, and Germany for Q3 2025?' The agent uses `get_public_holidays` multiple times and compiles a single list, preventing them from missing any regional conflicts. ### Checking Immediate Operational Status The marketing team is ready to send out an email campaign for Brazil. Before hitting send, they ask their agent: 'Is today a public holiday in Brazil?' The agent runs `is_holiday_today` and immediately flags the date as inactive, saving them time and bad PR. ### Pre-trip Logistics Planning A team is planning an international trip. They ask their agent to find all upcoming public holidays worldwide for the next three months. The agent runs `get_next_holidays_worldwide`, giving them a comprehensive map of global non-working days. ### Building a Country Code Map A developer needs to know which countries are supported before writing code. They simply ask the agent to run `list_available_countries`. The tool returns the full, current catalog of usable country codes for development. ## Benefits - Stop manual calendar checks entirely. You can use `get_public_holidays` to pull the full list of national holidays for any country and year, eliminating spreadsheet errors. - Immediate status checks are simple: Use `is_holiday_today` to confirm if a target market is observing a holiday right now, crucial for time-sensitive communications. - Need to plan an event across continents? The `get_next_holidays_worldwide` tool tracks upcoming events globally, giving you immediate visibility into multi-country scheduling conflicts. - When you need deeper context than just the date, use `get_country_details`. This pulls metadata (like region or common name) necessary for accurate localization. - Planning international logistics? By combining `list_available_countries` with other tools, your agent ensures it only queries supported markets, preventing API failure. ## How It Works The bottom line is, you use natural language to trigger precise calendar lookups that manage global complexity. 1. Subscribe to the Nager.Date server on Vinkius Marketplace. No API key is required—it's an open service. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the MCP endpoint. Your agent now sees the six available tools. 3. Ask your agent a question like: 'What are the public holidays in Japan for 2025?' The agent runs the `get_public_holidays` tool and returns structured data. ## Frequently Asked Questions **How do I find all public holidays for one country using Nager.Date?** Use the `get_public_holidays` tool. You must provide the specific country code and the year you are interested in to get a complete list of records. **Can I check if today is a holiday anywhere using Nager.Date?** No, not globally in one go. To check for immediate status, you must run `is_holiday_today` and specify the country code you want to verify. **What should I use if I need a list of all supported countries? (Nager.Date)** Run the `list_available_countries` tool. This provides the official, current catalog of country codes that the server supports for all other functions. **How do I find upcoming holidays in multiple countries at once?** Use `get_next_holidays_worldwide`. This single function retrieves a list of events happening across multiple global locations, saving you from running six separate queries. **What data points does the `get_country_details` tool provide when using Nager.Date?** This tool returns core metadata about a specific country code you supply. You get details like its full name, common names used regionally, and its designated geographic area for better context. **Does Nager.Date require an API key or special authentication to connect my AI agent?** No keys are needed because it's a free, open service. You simply subscribe to the Nager.Date server on Vinkius and your AI client handles the connection directly through the Model Context Protocol. **What format do I use for finding all holidays with the `get_public_holidays` tool in Nager.Date?** You must pass two mandatory parameters: a valid country code (like 'US') and a four-digit year. The system validates both inputs to pull the specific holiday schedule you need. **Are there rate limits or performance considerations when querying Nager.Date?** Nager.Date is an open resource, but high volumes of requests might encounter external throttling. For mission-critical applications, plan for multiple calls and cache results locally to maintain speed. **Is an API Key required for Nager.Date?** No. Nager.Date is a free and open service. This server works out of the box without any static credentials required. **Can the agent check if today is a holiday?** Yes. Use the `is_holiday_today` tool providing the 2-letter country code. Your agent will return a boolean indicating if it is a public holiday today instantly. **Does it support local names for holidays?** Yes. The holiday records retrieved by your agent include both the English name and the local name used in that specific country.