# Deadline Calculator MCP MCP > The Deadline Calculator determines accurate completion dates by calculating forward from a start date. It handles standard calendar day additions, professional business days (skipping weekends and regional holidays), and provides access to official holiday registries for the US, UK, Germany, or France. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** deadline, calendar, business-days, holidays, scheduling ## Description Need an end date that actually accounts for when people work? This MCP solves complex scheduling math. You tell your agent a start date, a duration, and the rules; it gives you the precise final day. Do you just need to add 10 days? Use the simple calendar tool. Does the task require skipping weekends and public holidays in a specific country? The business deadline tool handles that complexity automatically. Need to verify which holidays fall between those dates? Check the holiday registry first. By connecting this MCP via Vinkius, your agent gets an authoritative source for scheduling math—no more guessing if a client is out of office or if it's a recognized national day. ## Tools ### business_deadline_tool Adds business days to a start date, skipping weekends and designated regional holidays automatically. ### calendar_deadline_tool Simply adds calendar days to a start date; it counts every day regardless of whether it is a weekend or holiday. ### holiday_registry_tool Pulls a definitive list of recognized public holidays for any specific region and year you request. ## Prompt Examples **Prompt:** ``` Calculate the end date if I start on 2024-01-01 and add 10 calendar days. ``` **Response:** ``` Using `calendar_deadline_tool`, the calculated end date is 2024-01-11. ``` **Prompt:** ``` What is the deadline for a 5 business day task starting on 2024-07-01 in the US? ``` **Response:** ``` The `business_deadline_tool` calculates the end date as 2024-07-08, accounting for the July 4th holiday in the US. ``` **Prompt:** ``` List all holidays in Germany for the year 2024. ``` **Response:** ``` The `holiday_registry_tool` returns a list of all registered German holidays for 2024, including New Year's Day and German Unity Day. ``` ## Capabilities ### Determine standard date ranges Calculate any end date by simply adding calendar days to a start date. ### Compute professional deadlines Calculate a deadline that correctly skips weekends and regional holidays for specified countries. ### Retrieve holiday schedules Fetch official lists of recognized public holidays for any given region and year. ## Use Cases ### A marketing campaign must launch two weeks after a content audit ends. The Project Manager needs to know the exact date, avoiding any regional holidays. They ask their agent: 'Calculate 14 business days starting on X date in France.' The `business_deadline_tool` runs the calculation and returns the final launch day, accounting for local public holidays. ### A simple task needs to be tracked over a continuous period. The team lead only cares about elapsed time, not working hours. They ask their agent: 'What date is exactly 30 calendar days from today?' The `calendar_deadline_tool` returns the precise date without worrying if it's a weekend. ### We need to verify all potential roadblocks for Q4 planning. The Ops Analyst needs a full list of non-working days. They ask their agent: 'List all holidays in Germany for 2024.' The `holiday_registry_tool` provides the authoritative data set, allowing them to build accurate scheduling rules. ### A client contract stipulates delivery within five business weeks. The PM needs a final due date. They use the `business_deadline_tool`, specifying the start date and the country. The tool returns the precise completion date, making sure it falls on an actual working day. ## Benefits - Avoid scheduling conflicts: Use `holiday_registry_tool` first to see all major holidays in a region. This verifies that your calculated deadlines won't fall on non-working public days. - Accurate project timelines: The `business_deadline_tool` handles the complexity of skipping weekends and local holidays (US, UK, Germany, France) in one call; no need for complex date logic. - Simple day counting: When you just need to know what date is 15 days from now, use the `calendar_deadline_tool`. It's fast and counts every single day. - Reduced manual effort: Instead of cross-referencing multiple calendar sheets or country-specific holiday lists, your agent does all the math for you. - Global consistency: You can calculate deadlines across different regions using tools like `business_deadline_tool`, ensuring your schedule works regardless of where the client is located. ## How It Works The bottom line is... it gives you one calculated finish date based on whether your timeline needs to respect standard working weeks or just continuous calendar math. 1. Start by specifying your starting date and the desired duration. 2. The MCP determines which calculation type is needed: simple calendar days, or business days (which must account for holidays). 3. Your agent returns a single, authoritative end date that adheres to the specified rules and regional constraints. ## Frequently Asked Questions **How do I use the business_deadline_tool for a task in Germany?** You call `business_deadline_tool` and specify 'Germany' as the region. The tool automatically calculates the deadline by skipping German weekends and any recognized public holidays, giving you an accurate work day. **Can I use calendar_deadline_tool if a holiday falls on my due date?** No. The `calendar_deadline_tool` counts every single day; it does not skip weekends or holidays. If your task must respect non-working days, you need the `business_deadline_tool`. **What if I don't know which holidays are relevant for a region?** Start by calling `holiday_registry_tool`. This fetches all recognized public holidays for your chosen region and year, giving you the data needed to verify any deadline calculation. **Does this MCP handle multiple countries' holiday rules?** Yes. The `business_deadline_tool` allows you to specify different regional constraints (US, UK, Germany, France), making it ideal for global scheduling projects. **What date format does the `calendar_deadline_tool` require for a start date?** The tool requires standard ISO 8601 formatting (YYYY-MM-DD). Always pass your starting date in this exact format to ensure accurate calculations. This prevents any ambiguity when processing dates. **If I use the `business_deadline_tool` and start on a weekend, how does it calculate the deadline?** The tool automatically skips weekends. If you input a Saturday or Sunday as the starting date, it treats that day as invalid for calculation and begins counting from the next working weekday. You don't need to adjust your inputs manually. **Is there a limit on how often I can use the `holiday_registry_tool`?** No, Vinkius manages usage limits for all its MCPs. For routine data fetching with `holiday_registry_tool`, you generally won't hit any rate restrictions. It's built for high-volume lookup. **Can I use the `business_deadline_tool` to calculate a deadline spanning multiple years?** Yes, the tool handles year transitions smoothly. When calculating multi-year tasks, remember that you must first check all relevant regional holidays using the `holiday_registry_tool` for every year in question. **How does the business day calculation work?** The `business_deadline_tool` iterates through each day starting from your start date. It only increments the count when it encounters a day that is not a weekend (Saturday or Sunday) and not a holiday listed in the registry for your chosen region. **Which regions are supported for holidays?** Currently, the server supports holiday registries for the United States (US), United Kingdom (GB), Germany (DE), and France (FR). **Can I verify specific holiday dates?** Yes, you can use the `holiday_registry_tool` to fetch a complete list of recognized holidays for any supported region and year.