# Business Timezone & Holiday Scheduler MCP for AI Agents AI Agent Connect > Business Timezone & Holiday Scheduler is an Connector that fixes AI scheduling errors. It calculates exact business days by skipping global public holidays and converts complex timezones flawlessly to ensure your deadlines and meeting times are always accurate across different countries. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ez6FW8I6M2Qqs1ETKpnpE6wJ2qKA9lNwhiYc7Ghw/ai-agent-connect - **Tags:** timezone-conversion, public-holidays, scheduling, global-business, date-calculation, executive-assistant ## Description The Business Timezone & Holiday Scheduler MCP fixes the way AI agents handle dates and timezones. LLMs are notorious for messing up dates. They might get a timezone right one day and miss a leap year the next, or worse, they'll tell you a deadline is safe when it actually lands on a national holiday in your client's country. This happens because most models rely on static training data that doesn't account for the shifting rules of international calendars. This Connector fixes that by giving your agent a reliable source of truth for global calendars. Instead of guessing, your agent can now look up actual public holidays using real-time data from a dedicated API. When you're coordinating a project across three continents, it handles the heavy lifting of converting times between cities like São Paulo and Tokyo without missing the small details like offset shifts or daylight saving changes. It's a huge step up for anyone who needs their agent to behave like a high-level executive assistant rather than a chatbot that's just guessing at a calendar. It removes the need for you to manually check holiday lists for every country you work with. You can find this in the Vinkius catalog to get your agent's scheduling capabilities up to professional standards. ## Tools ### add_business_days Adds a number of business days to a date while skipping weekends and national holidays. You just provide a country code to trigger the holiday check. ### convert_timezone Converts a specific date and time from one IANA timezone string to another. It handles complex offset rules automatically. ## Prompt Examples **Prompt:** ``` If I sign a contract in Brazil today (2026-05-15), what is the exact date 45 business days from now, skipping Brazilian holidays? ``` **Response:** ``` I calculated 45 business days from 2026-05-15. Skipping all weekends and public holidays in Brazil (BR), your deadline falls precisely on: **July 20, 2026**. ``` **Prompt:** ``` Convert our project launch time (October 15, 2026 at 14:30 in New York) to Tokyo time. ``` **Response:** ``` I converted the timezone. **From (America/New_York):** October 15, 2026 at 2:30 PM **To (Asia/Tokyo):** October 16, 2026 at 3:30 AM Your launch in Tokyo will be early the next morning. ``` **Prompt:** ``` I need to set a 30-day delivery window for a client in Germany. What's the end date? ``` **Response:** ``` I've calculated the 30-business-day window for Germany. Starting from today, and skipping all weekends and German public holidays, your delivery window ends on: **June 25, 2026**. ``` ## Capabilities ### Calculate deadlines by skipping weekends The agent automatically ignores Saturdays and Sundays when counting out project timelines. ### Fetch national public holidays for any country Your agent pulls real-time holiday data for specific countries to ensure deadlines don't land on non-working days. ### Convert times between complex IANA timezones It handles the math for shifting between different global timezones with perfect accuracy. ### Account for real-world daylight saving rules The tool respects current offset rules so your meeting times stay correct year-round. ### Determine exact business days for SLAs It calculates precise turnaround times by filtering out holidays and weekends automatically. ## Use Cases ### Hitting a deadline in Japan A manager needs to find a deadline 30 days out in Japan. The agent uses add_business_days with 'JP' to skip Japanese holidays. ### Syncing New York and Brazil A team in NY needs to sync with a team in Brazil. The agent uses convert_timezone to get the exact local time for the meeting. ### Setting a 60-day delivery window For a European client, the AI calculates the end date by skipping all weekends and local holidays in that specific country. ### Global product launch planning The agent identifies all major holidays in target markets to avoid launching on a day when the target audience is offline. ## Benefits - Stop worrying about LLM hallucinations when calculating project deadlines by using real-time holiday data. - Get accurate meeting times for international teams without manual math by using convert_timezone. - Automate SLA tracking by letting the AI skip weekends and national holidays with add_business_days. - Reduce scheduling errors in global contracts by accounting for specific country holidays. - Ensure your AI acts as a reliable executive assistant that understands global calendar rules. ## How It Works The bottom line is your agent stops guessing and starts using real-world calendar data. 1. Connect the Connector to your AI client through Vinkius. 2. Ask your agent to calculate a date or convert a time for a specific country. 3. Get a precise answer that accounts for holidays and timezone offsets. ## Frequently Asked Questions **Does the Business Timezone & Holiday Scheduler know about local bank holidays?** Yes, it pulls real-time data for national public holidays. This ensures your agent won't accidentally schedule a deadline on a day your clients are closed. **Can I use Business Timezone & Holiday Scheduler for different countries?** Yes, it supports global holidays. You just need to provide the country code when asking your agent to calculate a date. **How does Business Timezone & Holiday Scheduler handle daylight saving?** It handles daylight saving automatically. By using standard IANA timezone strings, it ensures your meeting times are always correct regardless of the time of year. **Is Business Timezone & Holiday Scheduler good for international teams?** It's built specifically for that. It removes the guesswork from coordinating across different regions by handling the math and the holiday checks in one go. **Does Business Timezone & Holiday Scheduler create calendar invites?** No, it doesn't create invites. It is a calculation tool designed to give you the correct date and time so you can then book your meetings accurately. **Can I use Business Timezone & Holiday Scheduler to find a specific holiday?** It is primarily used to calculate dates by skipping holidays. It's the best way to ensure your project timelines are realistic for a specific country. **Does this require an API key?** No. The timezone logic runs directly inside the Vinkius Edge process. For holiday lookups, it uses the free, public Nager.Date API without requiring authentication. **Why use this instead of letting the AI guess?** AIs do not have access to live calendars or global holiday databases. They will frequently schedule your deadlines on a Sunday or a major national holiday. This Connector enforces absolute temporal accuracy.