# Workday Count Utility for business dates. AI Agent Connect > Workday Count Utility handles the math for your business calendars. Instead of manually counting weekdays in a spreadsheet, your AI client uses this MCP to calculate date ranges, verify if a specific day is a workday, and break down how many Mondays or Fridays fall within a period. It's a direct way to handle calendar logic without the manual error. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_c9jAQ3gAq9Z8NBkEL5akvkDpa1LZGhZ1cvua9Qd6/ai-agent-connect - **Tags:** workdays, calendar, business, dates, weekday ## Description You shouldn't have to manually count days on a calendar to figure out project timelines or payroll windows. This MCP gives your AI agent the ability to perform precise business date arithmetic. Whether you're calculating the duration of a contract or checking if a deadline falls on a weekend, the tools here handle the logic for you. You can verify if a date string is actually valid before running calculations, ensuring your agent doesn't trip over formatting errors. It also provides a breakdown of weekday distributions, which is useful when you need to know exactly how many Tuesdays or Wednesdays are in a specific month or quarter. It's built to take the tedious calendar math off your plate so you can focus on the actual scheduling. ## Tools ### check_date_validity This tool validates that a date string is a real calendar day and follows the correct format. Your agent uses it to prevent errors before performing other calculations. ### get_workday_count This tool calculates the total number of workdays between two specific dates. It's the primary way to find the length of a business period. ### get_workday_distribution This tool provides a count of how many times each specific weekday appears in a given range. Use it to see how many Mondays or Fridays are in a set period. ### is_workday This tool checks if a single date is a standard workday, defined as Monday through Friday. It quickly identifies if a date falls on a weekend. ## Prompt Examples **Prompt:** ``` How many workdays are there between 2024-01-01 and 2024-01-10? ``` **Response:** ``` There are 7 workdays between 2024-01-01 and 2024-01-10. ``` **Prompt:** ``` Is 2024-12-25 a workday? ``` **Response:** ``` Yes, 2024-12-25 is a Wednesday, which is a workday. ``` **Prompt:** ``` Give me the distribution of weekdays for the first week of January 2024. ``` **Response:** ``` In the first week of January 2024, there is 1 Monday, 1 Tuesday, 1 Wednesday, 1 Thursday, and 1 Friday. ``` ## Capabilities ### Range Calculation Your agent calculates the exact number of weekdays between two dates. ### Date Validation The MCP checks if date strings are formatted correctly and represent real days. ### Weekday Breakdown Your agent gets a count of how many specific weekdays exist in a range. ### Weekend Identification The agent determines if a specific date is a standard Monday through Friday workday. ## Use Cases ### Project Timeline Planning Calculate the exact number of working days available for a project between a start and end date. ### Payroll Processing Determine the number of workdays in a specific pay period to ensure accurate calculations. ### Deadline Verification Check if a specific upcoming date falls on a weekend or a standard workday. ### Resource Allocation Use weekday distribution to see how many Mondays or Fridays are available for specific weekly tasks. ## Benefits - Eliminates manual counting of weekdays in spreadsheets. - Prevents errors by validating date formats before processing. - Provides granular weekday counts for better resource planning. - Automates the identification of weekends within date ranges. ## How It Works Connecting this MCP to your AI client gives your agent immediate access to business date tools. 1. Connect the MCP to your client like Claude or Cursor via Vinkius. 2. Ask your agent a question about a date range or a specific day. 3. The agent selects the appropriate tool to perform the calculation. 4. The MCP returns the precise workday count or distribution. 5. Your agent provides the final answer in your conversation. ## Frequently Asked Questions **How do I use this MCP with Claude?** You connect to the MCP through the Vinkius platform. Once connected, your AI client will automatically see the workday tools as available functions. **Does this MCP handle weekends?** Yes. The tools are specifically designed to distinguish between workdays (Monday through Friday) and weekends. **Can I check if a date is valid?** Yes, the check_date_validity tool allows your agent to verify that a date string is a real calendar day and follows the correct format. **What is a workday distribution?** It is a breakdown showing how many times each specific day of the week, such as Monday or Tuesday, occurs within a given date range. **Do I need to host this myself?** No. Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools. **Are the start and end dates included in the count?** Yes, if the start or end dates fall on a weekday, they are included in the total count. **What date format should I use?** All dates must be provided in the YYYY-MM-DD format. **Does this tool account for holidays?** No, this tool specifically counts standard workdays (Monday through Friday) and does not exclude public holidays.