# Holiday API MCP MCP > 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. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** holidays, global-events, scheduling, date-calculation, workday-tracking, international-data ## Description 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. ## Tools ### 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. ### list_supported_countries Lists all country codes that the API recognizes and supports for holiday lookups. ### list_supported_languages Provides a complete list of languages supported by the global holiday data set. ## Prompt Examples **Prompt:** ``` What are the public holidays in 'US' for 2024 using Holiday API? ``` **Response:** ``` I've retrieved the 2024 public holidays for the United States. Notable dates include Independence Day on July 4th and Thanksgiving on November 28th. Would you like the full list of federal holidays? ``` **Prompt:** ``` Calculate the next 10 workdays from 2024-01-01 in Brazil. ``` **Response:** ``` I've calculated the date! After 10 workdays in Brazil starting from January 1st, 2024, the resulting date is January 15th, 2024. I've accounted for the New Year's holiday. ``` **Prompt:** ``` List all countries supported by Holiday API. ``` **Response:** ``` I've scanned the country catalog. Holiday API supports over 200 countries, including United Kingdom, Germany, and Japan. I can provide the country codes for any of them. ``` ## Capabilities ### Audit Global Holidays Your agent retrieves public and federal holidays for any specified country and year. ### Calculate Workday Spans It counts the number of working days between two dates, skipping weekends and local holidays. ### Determine Next Working Day The agent finds the date that falls after a specified number of workdays from a starting point. ### Verify Supported Regions It lists all countries and languages supported by the holiday data set, ensuring global coverage. ## 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. ## Benefits - Stop manually checking dozens of separate national holiday websites. Your agent handles global audit using `get_holidays` for over 200 countries. - Never guess a payroll date again. Use `get_workdays_count` to 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_countries` to confirm your target market is covered before you start planning. - The system supports multiple languages. Check out `list_supported_languages` to ensure your AI client can process the data correctly. ## How It Works The bottom line is: you talk to your agent like talking to a person, and it handles all the complex calendar math for you. 1. Your agent first checks if you need to verify a country or language using `list_supported_countries` or `list_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. ## Frequently Asked Questions **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.