# Business Day Calculator MCP for AI Agents AI Agent Connect > Business Day Calculator MCP helps you manage global deadlines without manual calendar checking. It handles workdays, public holidays for over 50 countries, and specific regional weekend patterns. Use it to project dates or count working days across international teams instantly. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FK0N2YSyXRAHUmFmMKKcPOwzacRT18rbYpSFwJdm/ai-agent-connect - **Tags:** date-calculation, business-days, holidays, global-calendar, workday-planner ## Description Planning a project that spans multiple time zones and countries is a headache because every region has its own set of holidays and weekend rules. You can't just assume a Monday is a workday everywhere. This Connector takes that weight off your shoulders by giving your agent the ability to do high-precision date math. Instead of you hunting down a calendar for the UAE or the UK, your agent handles the logic. It knows about the Middle East's unique weekend structures and the specific public holidays for dozens of different nations. You can use it to see exactly how many days a project will take or to figure out when a deadline actually falls after accounting for time off. It's a huge time-saver for anyone coordinating work across borders, and it fits right into your workflow on Vinkius. ## Tools ### add_business_days Adds a set number of workdays to a date while skipping weekends and holidays. It's perfect for projecting future deadlines. ### count_business_days Calculates the total number of working days between two specific dates. This helps you see the actual duration of a project. ### find_next_business_day Identifies the upcoming workday from a given date. Use this to quickly see when work resumes after a weekend. ### get_workday_range Produces a complete list of business days within a date range. It's great for visualizing a project's timeline. ### subtract_business_days Moves backward from a date by a specific number of workdays. This helps you figure out when a task started. ## Prompt Examples **Prompt:** ``` What is the date 10 business days from today in France? ``` **Response:** ``` The target date is 2024-06-14. This calculation accounts for French public holidays and standard weekends. ``` **Prompt:** ``` How many workdays are between March 1 and April 30 in the USA? ``` **Response:** ``` There are **44 business days** between those dates, excluding weekends and US federal holidays like Memorial Day and Easter. ``` **Prompt:** ``` What's the next workday after June 14 in the UAE? ``` **Response:** ``` The next business day is **June 17**. This is because the UAE observes a Friday-Saturday weekend. ``` ## Capabilities ### Add workdays to a date Add a specific number of business days to a date while skipping holidays and weekends. ### Subtract workdays from a date Move backward from a date by a set number of workdays to find past start dates. ### Count total business days Calculate the exact number of working days between two specific dates. ### Generate workday lists Produce a complete list of all business days within a specific date range. ### Find the next workday Identify the very next available business day from any given date. ## Use Cases ### Calculating UK deadlines A PM needs to know a deadline for a UK team. They don't know the holiday schedule. The agent uses add_business_days for the UK to find the date. ### UAE shipping estimates A logistics lead wants to see shipping time to the UAE. UAE has different weekends. The agent uses find_next_business_day to account for Friday-Saturday weekends. ### Project duration tracking A developer needs to know how long a 3-week task takes. Holidays might interrupt it. The agent uses count_business_days to give the exact number of workdays. ### March workday listing An HR lead needs to see all workdays in March. Manual listing is slow. The agent uses get_workday_range to generate the list instantly. ## Benefits - Stop manual calendar lookups. Use add_business_days to see real deadlines across 50+ countries without opening a browser. - Account for regional weekends. The Connector knows specific patterns like the Middle East's Friday-Saturday weekend automatically. - Get exact project durations. Use count_business_days to see the actual number of working days between two dates. - Visualize project timelines. Use get_workday_range to generate a clear list of workdays for your team to see. - Automate complex date math. Your agent handles skipping holidays and weekends so you don't have to do the math yourself. ## How It Works The bottom line is you get accurate global workdays without ever opening a calendar. 1. Connect the Connector to your AI client via the Vinkius dashboard. 2. Ask your agent to calculate a date using a specific country and range. 3. Get a precise date or count that accounts for regional holidays and weekends. ## Frequently Asked Questions **Does the Business Day Calculator MCP know about holidays in different countries?** Yes, it includes public holidays for over 50 countries automatically. **Can I use the Business Day Calculator MCP for specific regional weekends?** Yes, it handles patterns like the Middle East's Friday-Saturday weekend. **How does the Business Day Calculator MCP handle custom holidays?** You can provide custom holiday overrides via JSON input for specific needs. **Can the Business Day Calculator MCP count workdays between two dates?** Yes, it can calculate the exact number of business days between any two dates you provide. **Is the Business Day Calculator MCP good for project management?** It's perfect for project managers who need to calculate deadlines across international teams. **Does the Business Day Calculator MCP work for every country?** It currently supports over 50 countries with diverse holiday and weekend structures. **How does the tool handle different weekend structures?** The tool automatically applies regional rules based on the `countryCode`. For example, it uses a Saturday-Sunday pattern for the US and a Friday-Saturday pattern for many Middle Eastern countries. **Can I add my own holidays to the calculation?** Yes, you can provide a JSON array of ISO date strings in the `customHolidaysJson` parameter to treat specific dates as non-working days. **What happens if I provide an invalid country code?** If the `countryCode` is unrecognized, the tool will return an error message describing the failure.