# Holiday API MCP for AI Agents AI Agent Connect

> Holiday API lets your agent handle the heavy lifting of global holiday data. It pulls public and federal holidays for over 200 countries, calculates workdays between dates, and identifies regional event markers. Stop manually checking different calendars. This Connector makes sure your schedules are always accurate, whether you're managing a global payroll or planning international logistics.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/ai-agent-connect
- **Tags:** holidays, global-events, scheduling, date-calculation, workday-tracking, international-data

## Description

Imagine you're coordinating a project across five different time zones. You need to know exactly when people are off work without opening ten different browser tabs to check local government websites. This Connector changes that by giving your agent a direct line to a massive database of global holidays. Instead of you doing the research, you just ask your agent to map out a project timeline or check if a specific date is a public holiday in Tokyo or Berlin. It handles the nuances of federal vs. public dates and even tells you what language the holiday is listed in. You get a clear picture of operational windows without the manual data entry. When you find this through the Vinkius catalog, you're basically giving your agent a global calendar brain. It's about moving from "I think they're off" to "I know they're off" in a single step. You can audit past events or plan months ahead with total confidence that your dates are correct. It's the difference between guessing and having a reliable source of truth for your international operations.

## Tools

### get_next_workday
Tells you the date of the next business day starting from a specific point. This helps you set deadlines that automatically skip over weekends and public holidays.

### get_workdays_count
Gives you the total number of workdays between two dates. Use this to see how much actual time you have for a project in any country.

### list_supported_countries
Shows every country currently supported by the API. This lets you know if the data you need is available before you start your search.

### list_supported_languages
Lists the languages the API uses for holiday names. This helps you understand how the data will appear in your results.

### get_holidays
Returns all public holidays for a specific country and year. This is your main tool for auditing any regional calendar instantly.

## Prompt Examples

**Prompt:** 
```
What are the public holidays in the UK for 2025?
```

**Response:** 
```
Here are the public holidays for the United Kingdom in 2025:

| Date | Holiday Name |
| :--- | :--- |
| Jan 1 | New Year's Day |
| Mar 29 | Good Friday |
| Apr 3 | Easter Monday |
| May 5 | Early May Bank Holiday |
| May 26 | Spring Bank Holiday |
| Aug 25 | Summer Bank Holiday |
| Dec 25 | Christmas Day |
| Dec 26 | Boxing Day |
```

**Prompt:** 
```
Calculate 15 workdays from today in Germany.
```

**Response:** 
```
Starting from today, 15 workdays in Germany will land on **Monday, October 20, 2025**. 

This calculation accounts for the following public holidays:
*   **October 3**: German Unity Day
*   **October 13**: Reformation Day (in some states)

Would you like me to calculate the workdays for a different country?
```

**Prompt:** 
```
Is August 15th a holiday in Italy?
```

**Response:** 
```
Yes, **August 15th** is a public holiday in Italy. It is observed as **Ferragosto** (Assumption of Mary). 

It is one of the most significant holidays in Italy and typically involves widespread closures of businesses and public services.
```

## Capabilities

### Pull public holidays for 200+ countries
Get a complete list of public and federal holidays for any country in the database.

### Count workdays between dates
Calculate the exact number of business days between two dates while skipping holidays.

### Find the next business day
Determine the first available workday following a specific start date.

### Verify country and language support
Check which countries and languages are included in the holiday catalog.

### Audit historical and future dates
Query holiday data for specific years to plan ahead or review past events.

## Use Cases

### Payroll Compliance Audit
An HR manager needs to know if a specific date in France is a public holiday for payroll. They ask the agent to check, and it confirms the date using get_holidays.

### International Shipping Windows
A logistics lead needs to know how many working days are between now and December 1st in Japan. The agent uses get_workdays_count to give a precise number.

### Group Travel Booking
A travel agent wants to know the next available workday for a group booking in Brazil. The agent uses get_next_workday to find the date.

### Global Project Planning
A project manager wants to see if the US has any federal holidays in 2025. The agent pulls the full list using get_holidays.

## Benefits

- Stop manual calendar hunting. Use get_holidays to see every public holiday in a country instantly, saving you from searching multiple government websites.
- Accurate project timelines. Use get_workdays_count to see how many actual days your team has to work, excluding weekends and local holidays.
- Smarter deadline setting. Use get_next_workday to automatically push dates forward to the next available business day for any country.
- Global payroll compliance. Verify holiday data for 200+ countries to ensure your HR systems respect local time off and pay rules.
- Faster logistics planning. Quickly identify regional event markers with list_supported_countries to avoid shipping delays during peak holidays.

## How It Works

The bottom line is that you get instant, accurate holiday data for any country without ever opening a second tab.

1. Subscribe to the Holiday API MCP and provide your API key.
2. Connect your preferred client like Claude, Cursor, or Windsurf.
3. Ask your agent to find holidays or calculate workdays in any country.

## Frequently Asked Questions

**Can Holiday API find holidays for every country?**
Yes, the Connector provides access to public and federal holiday data for over 200 countries worldwide.

**Can I use it to see if a date is a workday?**
Yes, you can ask your agent to find the next available business day from any date, and it will skip over weekends and public holidays.

**Does it work for past years?**
Yes, you can query holidays for specific years to audit past events or plan for future ones.

**How does it help with payroll?**
It allows you to quickly verify if a specific date is a public holiday in a different country, helping you ensure payroll compliance for international employees.

**Can I see which languages are supported?**
Yes, you can ask your agent to list the supported languages to see how the holiday names will appear in your results.

**Is there a limit on how many countries I can check?**
There is no specific limit. You can query data for any of the 200+ countries supported by the catalog.

**How do I find my Holiday API Key?**
Log in to your [**Holiday API dashboard**](https://holidayapi.com/dashboard), and you will find your API Key on the main page. Copy and paste it below.

**Does the agent support historical years?**
Yes. Holiday API provides historical data. Depending on your plan, you can query holidays for past years to audit previous events.

**Can the agent calculate the number of workdays?**
Yes. The `get_workdays_count` tool allows your agent to calculate the exact number of non-holiday business days between two dates for any country.