# Nager.Date MCP for AI Agents AI Agent Connect > Nager.Date MCP. Manage public holidays worldwide, audit global events, and cross-reference international calendars via your AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_oJ8yQPJwvA3VT5L7u0BStVBXVe4caSfLL8hNHeRu/ai-agent-connect - **Tags:** public-holidays, global-events, calendar-data, regional-data, date-calculation ## Description If you're trying to figure out if your team in Brazil or Japan is off today, you don't have to keep twenty tabs open. This Connector lets your AI client do the digging for you. Instead of searching through different government websites or manually cross-referencing calendars, you just ask your agent to check the status. It pulls from the Nager.Date database to tell you exactly what's going on. It's a massive time saver if you're coordinating global launches, managing international shipping logistics, or planning multi-region events. You'll find it in the Vinkius catalog alongside other tools that help manage complex data. It handles the heavy lifting of identifying regional variations so you can focus on the actual work. You can ask about specific years, check for immediate closures, or get a full list of dates for an entire country. It's built for people who need to know the facts about global dates without the friction of manual research. Whether you're checking for local nuances or looking for a high-level view of upcoming holidays across several continents, your agent can provide that data in seconds. For example, if you're building a global product roadmap, you can quickly see which countries have major holidays in Q4. If you're a logistics lead, you can spot potential shipping delays before they happen. This tool takes the guesswork out of international scheduling by providing a single source of truth for public holidays worldwide. ## Tools ### get_next_holidays_worldwide See what holidays are coming up across the globe right now. Use it to get a high level view of global events. ### list_available_countries See the full list of countries supported by the Nager.Date database. This lets you see the full scope of the tool. ### get_country_details Get extra details like common names or regions for a specific country. This helps with accurate localization in your reports. ### get_next_holidays Find the upcoming public holidays for one specific nation. Use this to plan ahead for regional events. ### is_holiday_today Instantly check if today is a public holiday in any country. This is perfect for quick daily status checks. ### get_public_holidays Pull a complete list of holidays for a specific country and year. Use this to build out full annual calendars. ## Prompt Examples **Prompt:** ``` What are the public holidays in 'US' for 2024? ``` **Response:** ``` Here are the public holidays for the United States in 2024: | Date | Holiday | | :--- | :--- | | Jan 1 | New Year's Day | | Jul 4 | Independence Day | | Nov 11 | Veterans Day | | Dec 25 | Christmas Day | Would you like the full list of dates for the rest of the year? ``` **Prompt:** ``` Is today a public holiday in Brazil? ``` **Response:** ``` I've checked the holiday status for Brazil. **Today is not a public holiday.** The next upcoming holiday is **Tiradentes Day** on **April 21st**. Would you like me to check any other countries? ``` **Prompt:** ``` Show me the next 5 holidays happening worldwide. ``` **Response:** ``` I've identified the next 5 global holidays occurring soon: * **Australia** - ANZAC Day (April 25) * **India** - Good Friday (March 29) * **Norway** - Easter Sunday (March 31) * **Germany** - Easter Monday (April 1) * **France** - Easter Monday (April 1) I can provide more details for any of these countries if you need! ``` ## Capabilities ### Check daily holiday status Instantly see if a specific country is observing a public holiday today. ### List upcoming regional holidays Get a list of the next holidays for any specific nation to plan ahead. ### Audit annual holiday cycles Retrieve every public holiday for a country and a specific year. ### Monitor global event patterns Identify the next upcoming holidays occurring across the entire world. ### Get geographic country details Retrieve common names and regional information for specific countries. ### Browse supported nations See the full list of countries included in the Nager.Date database. ## Use Cases ### Avoiding shipping delays A logistics lead asks their agent to check for holidays in Singapore next month. The agent uses get_next_holidays to identify closure dates and suggests avoiding those weeks for transit. ### Global launch planning A product owner wants to ensure a launch doesn't hit a major holiday in Germany. They ask the agent to list all holidays for 2025 using get_public_holidays. ### HR team status checks An HR manager asks if the team in Brazil is off today. The agent uses is_holiday_today to provide an immediate answer without the manager checking a separate calendar. ### Regional research A researcher needs to know the common names for countries in South America. The agent uses list_available_countries and get_country_details to provide a clean list. ## Benefits - Stop manually searching for dates with get_public_holidays to build your annual calendars. - Confirm immediate office closures with is_holiday_today for real-time operational decisions. - Plan global shipping routes using get_next_holidays_worldwide to avoid unexpected delays. - Get accurate regional names and metadata with get_country_details for better localization. - Map out upcoming national events for specific regions using get_next_holidays to stay ahead of the curve. ## How It Works The bottom line is you get instant access to global holiday data through your AI agent without any manual searching. 1. Subscribe to the Nager.Date MCP via the Vinkius marketplace. 2. Connect the Connector to your AI client without needing to manage an API key. 3. Ask your agent to find holidays, check dates, or pull regional country info. ## Frequently Asked Questions **Can Nager.Date find holidays for every country?** Yes, it provides data for over 100 countries worldwide, making it a great tool for international logistics and global HR planning. **Does Nager.Date require an API key?** No, Nager.Date is a free and open service, so you can connect it to your AI client without needing to manage any keys. **Can I use Nager.Date to check if a specific date is a holiday?** Yes, your agent can check if a specific date is a public holiday for any supported country, which is perfect for quick daily status checks. **Will Nager.Date show private religious holidays?** No, this tool specifically focuses on official public holidays. It won't show private religious dates or local non-official events. **How does Nager.Date help with international shipping?** It helps you identify potential shipping delays by showing you upcoming holidays in various countries, allowing you to plan routes more effectively. **Is the data in Nager.Date updated regularly?** Yes, the tool connects to a live open-source database that maintains current holiday information for the countries it supports. **Can I use Nager.Date to find holidays for a specific year?** Absolutely. You can ask your agent to pull a complete list of public holidays for any specific country and year to help with long-term planning. **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.