Holiday API MCP. Know any country's schedule 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.
Holiday API lets you manage global holidays instantly. Audit public and federal holidays for any country using your AI agent.
Calculate workdays, check international schedules, and identify supported regions without manual calendar lookups.
What your AI agents can do
Get holidays
Retrieves a list of public holidays for a specified country and year.
Get next workday
Calculates the date that falls after a set number of workdays from a given starting date.
Get workdays count
Counts the total number of working days between two provided dates.
Your agent retrieves public and federal holidays for any specified country and year.
It counts the number of working days between two dates, skipping weekends and local holidays.
The agent finds the date that falls after a specified number of workdays from a starting point.
It lists all countries and languages supported by the holiday data set, ensuring global coverage.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Holiday API: 5 Tools
These five tools let you check global holiday dates, count working days between locations, and verify supported countries and languages.
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 Holiday API on Vinkius019d8445get holidays
Retrieves a list of public holidays for a specified country and year.
019d8445get next workday
Calculates the date that falls after a set number of workdays from a given starting date.
019d8445get workdays count
Counts the total number of working days between two provided dates.
019d8445list supported countries
Lists all country codes that the API recognizes and supports for holiday lookups.
019d8445list supported languages
Provides a complete list of languages supported by the global holiday data set.
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 Holiday API, 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 Holiday API. 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 5 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking international schedules is a nightmare of tabs and spreadsheets.
Right now, figuring out when a global team can actually meet requires opening three different national calendar sites. You have to cross-reference federal holidays against local business closures, then manually calculate the gap in workdays—a process that takes hours and invites simple mistakes.
With this MCP connected via Vinkius, you tell your agent what dates you need for a given country or region. It pulls all the necessary holiday data instantly, giving you a clean, calculated list of available working days.
Get Holiday Data with `get_holidays`
Instead of logging into 15 different government sites to find the public holidays for Q4, you ask your agent. It uses `get_holidays` and returns a comprehensive list that includes both the name of the holiday and the precise date.
What's different now is confidence. Your scheduling logic relies on one single source of truth instead of fragmented manual lookups.
What you can do with this MCP connector
Planning anything that crosses time zones or deals with payroll requires accurate holiday data. This MCP gives your AI client a reliable source for global event intelligence. Your agent can instantly pull public holidays for over 200 countries—retrieving both the name and the exact date. You'll never have to manually check multiple country-specific calendar websites again.
Need to know how many workdays pass between two dates, accounting for local breaks? It handles that too. This capability makes your agent act like a real-time global consultant, ensuring your schedules are always accurate and legally compliant. Vinkius hosts this API, making it accessible right alongside thousands of other specialized tools in the catalog.
019d8445-f509-7209-a621-38e5a1fe1fcb 
How Holiday API MCP Works
- 1 Your agent first checks if you need to verify a country or language using
list_supported_countriesorlist_supported_languages. - 2 You ask your AI client for specific dates, and the MCP runs the calculation, checking against global holidays and workdays.
- 3 The result is a clean date or list of dates that are confirmed to be operational workdays.
The bottom line is: you talk to your agent like talking to a person, and it handles all the complex calendar math for you.
Who Is Holiday API MCP For?
Operations leads who are tired of manually cross-referencing multiple country holiday calendars. It's essential for HR specialists managing global payroll or logistics managers planning international shipments across borders.
Verifies public holidays and audits complex payroll cycles for multinational teams without manual research.
Monitors international holiday schedules to plan shipping routes and delivery timelines accurately.
Performs rapid audits of local event markers, helping clients identify peak travel periods across different countries.
What Changes When You Connect
- Stop manually checking dozens of separate national holiday websites. Your agent handles global audit using
get_holidaysfor over 200 countries. - Never guess a payroll date again. Use
get_workdays_countto calculate workdays between two points, automatically skipping weekends and local holidays. - Planning an event? You can instantly check if the next business day is available using
get_next_workday, making scheduling reliable. - Worried about regional coverage? First, run
list_supported_countriesto confirm your target market is covered before you start planning. - The system supports multiple languages. Check out
list_supported_languagesto ensure your AI client can process the data correctly.
Real-World Use Cases
Launching a global product campaign
A marketing manager needs to know when their ads must pause across Europe and Asia. They ask their agent: 'What are the public holidays in France and Japan for Q4?' The agent uses get_holidays to provide an immediate, consolidated list of dates to avoid wasting ad spend.
Calculating project completion timelines
An operations lead needs to estimate a product launch date that must account for local breaks in Brazil and Germany. The agent uses get_workdays_count between the start date and end date, giving an accurate, non-holiday adjusted timeline.
Updating global employee handbooks
An HR specialist has to verify holiday compliance for a new country. They first run list_supported_countries to confirm the region is covered, then use get_holidays for that specific year and location.
Scheduling cross-functional meetings
A project manager needs to schedule a mandatory kickoff meeting that must happen 15 working days after a certain date. They ask the agent, which uses get_next_workday to pinpoint the exact start day.
The Tradeoffs
Treating dates like simple math
Calculating 10 days from January 1st using a basic calendar tool, only to find the date falls on Christmas or New Year's Day.
→
Use get_next_workday with your agent. It handles all local holidays and weekends automatically, giving you an accurate business day count.
Assuming global coverage
Building a scheduling workflow that fails because it never checked if the target country was supported by the API.
→
Always start by running list_supported_countries to confirm support. This prevents broken workflows before they even begin.
Manually calculating date ranges
Writing code that must check for holidays in 50 different countries, leading to massive amounts of conditional logic.
→
Let your agent query the data. It runs get_holidays and does the heavy lifting across multiple regions with a single request.
When It Fits, When It Doesn't
Use this MCP if your core problem revolves around global time, payroll, or scheduling accuracy. If you need to know if a date is a workday or what the next working day is, use it. Don't use this if your goal is simply to validate that dates exist; for basic calendar math without holiday rules, standard libraries are fine. However, if you need accurate workdays, don't try to build custom logic because every country has different public observances. Always check list_supported_languages and list_supported_countries first before trusting any calculation.
Common Questions About Holiday API MCP
How do I find out which countries are supported by `list_supported_countries`? +
Running list_supported_countries provides a full list of country codes the API recognizes. This is your first step when setting up global logic.
Does `get_holidays` account for federal vs local holidays? +
Yes, it retrieves detailed public and federal holiday data for the specified location and year.
What if I need to calculate workdays across different regions? Do I use `get_workdays_count` or multiple calls? +
You should feed your agent the specific country context. Use get_workdays_count and explicitly define the region for accurate counting.
Can my agent determine the next working day if a holiday falls on that date? How does `get_next_workday` work? +
Yes. If you ask for 5 workdays starting today, and tomorrow is a holiday, get_next_workday skips it and gives you the actual fifth workday.
When using `get_holidays`, how does my agent handle authentication and API keys? +
The MCP handles key management for you. You simply connect your AI client, and it securely passes the necessary credentials to the tool without exposing them in your prompts. This keeps your data safe while running complex global audits.
If I make many calls like `list_supported_countries`, are there rate limits or usage quotas? +
Yes, the API enforces standard usage quotas to maintain stability. We recommend monitoring your usage volume via dedicated endpoints or checking Vinkius's status dashboard for real-time data and alerts.
When using `get_workdays_count`, what is the required date format for accurate results? +
You must provide dates in the ISO 8601 standard (YYYY-MM-DD). This format ensures consistent parsing across all global time zones, making your workday calculations reliable no matter where you're planning.
Before running a full audit, how can I check if my target region is supported using `list_supported_languages`? +
Run the list_supported_languages tool first. This returns all available locale codes and language identifiers. Your agent can then confirm regional compatibility before attempting to retrieve specific holiday data.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.