Nager.Date MCP. Audit global holiday schedules instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
Get country details
Gets additional metadata for a specific country using its code.
Get next holidays
Retrieves the next scheduled public holidays specifically for one country.
Get next holidays worldwide
Finds and lists the upcoming public holidays occurring globally across multiple countries.
Your agent confirms if a specific country has a public holiday on the current date.
The agent retrieves every public holiday record for a given country and year range.
Your agent pulls the next scheduled public holidays happening within a specific country.
The agent identifies and lists upcoming global holidays across multiple countries simultaneously.
Your agent pulls basic data points for a country, like its common name or region.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Nager.Date MCP Server: 6 Tools for Calendar Auditing
These tools let your agent check specific country details, list all available markets, or retrieve comprehensive global and annual public holiday schedules.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Nager.Date on Vinkius019d845cget country details
Gets additional metadata for a specific country using its code.
019d845cget next holidays
Retrieves the next scheduled public holidays specifically for one country.
019d845cget next holidays worldwide
Finds and lists the upcoming public holidays occurring globally across multiple countries.
019d845cget public holidays
Retrieves every public holiday for a specified country and year range.
019d845cis holiday today
Checks if the current day is designated as a public holiday in a specific country.
019d845clist available countries
Lists every single country code and name supported by Nager.Date.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Nager.Date, then connect any of our 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nager.Date. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 6 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually tracking global holidays is a nightmare of tabs and spreadsheets.
Today, coordinating an international campaign means opening Google Calendar for the US, checking Doodle polls for Germany's regional dates, then manually finding out if India has a bank holiday that week. You end up copying data between six different sheets just to confirm one launch window.
With this MCP server, your agent handles all of that complexity internally. By calling `get_public_holidays` and cross-referencing it with the country codes from `list_available_countries`, you get a single, verifiable list of non-working days for every market in one query.
Nager.Date MCP Server: Get accurate global calendars.
Previously, determining if today was safe to launch required calling multiple APIs and handling inconsistent date formats. You'd spend time validating input parameters just to get a simple true/false answer.
Now, you ask your agent: 'Is today a holiday in Australia?' The agent runs `is_holiday_today` and returns the definitive status instantly. It’s that directness—no guesswork, no manual data assembly.
What you can do with this MCP connector
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.
019d845c-e01f-737d-8806-4c11af94f08c 
How Nager.Date MCP Works
- 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_holidaystool and returns structured data.
The bottom line is, you use natural language to trigger precise calendar lookups that manage global complexity.
Who Is Nager.Date MCP For?
This server is for operations teams who deal with international scheduling or product launches. Think of the logistics manager who hates spending hours cross-referencing regional calendars, or the HR specialist needing to audit holiday time off across diverse global offices. If your job involves 'when' and 'where,' this tool saves you manual lookups.
Verifies product launch dates against international calendars, ensuring the release window avoids major regional holidays.
Monitors cross-border shipping routes and schedules to avoid mandatory national closures or transport slowdowns due to public holidays.
Runs rapid audits of regional time off policies, checking if a proposed training date falls on a local holiday in multiple country offices.
What Changes When You Connect
- Stop manual calendar checks entirely. You can use
get_public_holidaysto pull the full list of national holidays for any country and year, eliminating spreadsheet errors. - Immediate status checks are simple: Use
is_holiday_todayto 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_worldwidetool 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_countrieswith other tools, your agent ensures it only queries supported markets, preventing API failure.
Real-World 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.
The Tradeoffs
Assuming a single API call works globally
Trying to use one generic date checker and hoping it covers both national holidays (like Christmas) and regional/state-specific shutdowns.
→
Don't rely on generalized tools. For specific, comprehensive lists, always run get_public_holidays for the exact country code and year you need. This is more precise than general checks.
Forgetting to validate the country code
Passing a non-standard or outdated two-letter country code (e.g., 'USA' instead of 'US') into any function.
→
Always start by running list_available_countries to ensure your agent is using a valid, supported country code before calling tools like is_holiday_today or get_next_holidays.
Ignoring the date scope
Asking for 'upcoming holidays' without specifying if you mean next week or next year.
→
Be explicit. If you need a full year, use get_public_holidays with the target year. If you only want immediate warnings, run is_holiday_today.
When It Fits, When It Doesn't
Use this server if your primary need is validating official public holidays or global event calendars for multiple countries. It excels at structured date retrieval (e.g., 'Give me all dates in 2025').
Don't use it if you need to track private, company-mandated days off, or if you require complex time zone offsets beyond what the core API handles.
If your goal is general date math (e.g., 'What day was 3 months ago?'), stick to a standard calendar library tool. If you are checking when an official government holiday falls, use Nager.Date and its specific tools: get_public_holidays for lists, or is_holiday_today for immediate checks.
Common Questions About Nager.Date MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.