# Legal Deadline Calculator Engine MCP > The Legal Deadline Calculator Engine calculates precise procedural deadlines in business days. It handles complex date math by automatically skipping weekends and any specific national or local holidays you define. This tool eliminates the risk of LLM mathematical errors, ensuring your legal agents always hit filing dates. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** date-math, business-days, procedural-logic, legal-tech, deterministic-calculation, time-management ## Description In law, missing a deadline isn't an inconvenience; it’s catastrophic. Standard large language models fail at date arithmetic, routinely ignoring weekends and mandatory holidays when asked to perform simple calculations like adding 15 business days. This MCP fixes that problem by performing exact, local procedural deadline computations every time. Instead of relying on vague general intelligence, this connector treats dates as structured data. You input a starting point and a duration; it processes the request using ISO date formats, explicitly skipping non-business days and any user-provided holiday list. When you connect this MCP through Vinkius to your preferred AI client, your agent gets a guaranteed final date calculation—no guesswork involved. It's reliable math for high-stakes tasks. ## Tools ### calculate_legal_deadline Calculates the exact final due date by counting business days, skipping both weekends and any holidays you specify. ## Prompt Examples **Prompt:** ``` The client was subpoenaed on 2026-05-15. Add exactly 15 business days to calculate the final deadline. ``` **Response:** ``` The computation has been executed with mathematical precision. All results are exact and ready for review. ``` **Prompt:** ``` Calculate the 10-business-day deadline starting from October 10th, 2026, and make sure to skip the national holiday on October 12th. ``` **Response:** ``` The computation has been executed with mathematical precision. All results are exact and ready for review. ``` **Prompt:** ``` I need to file an appeal in 5 business days from December 20th, 2026. Provide the exact date considering December 25th is a holiday. ``` **Response:** ``` The computation has been executed with mathematical precision. All results are exact and ready for review. ``` ## Capabilities ### Compute Procedural Due Dates Calculates the exact endpoint of a legal or procedural timeline based on a start date and required business days. ### Respect Standard Working Calendars Automatically excludes all Saturdays and Sundays from any calculation, ensuring weekends never count toward the deadline. ### Integrate Custom Holiday Lists Allows you to pass a list of specific non-business holidays (e.g., 'Labor Day,' 'Christmas') so they are also skipped during the calculation. ### Maintain ISO Date Precision Processes all dates using standardized ISO formats, guaranteeing consistent and unambiguous date math results. ## Use Cases ### Client subpoena response planning A junior associate is given a subpoena on 2026-12-01. They need to know the exact filing deadline, which requires counting 30 business days while skipping Christmas and New Year's Day. Using `calculate_legal_deadline` provides the single, correct final date immediately. ### Regulatory reporting due dates The compliance team must submit a quarterly report within 15 working days of receiving the internal data package on May 1st. The agent uses `calculate_legal_deadline` to account for local holidays and weekends, ensuring they meet the strict regulatory window. ### Appeal filing timeline management An attorney needs to advise a client on an appeal deadline set 5 business days after the initial hearing date. The agent uses `calculate_legal_deadline`, passing the start date and any state-specific holidays, delivering actionable legal advice. ### Project milestone tracking A project manager needs to schedule a final review 20 working days after the initial design sign-off. Instead of guessing, they use `calculate_legal_deadline` to get a reliable end date that factors in all expected company closures. ## Benefits - Eliminate mathematical hallucination. You don't have to trust a generic AI for date math anymore. `calculate_legal_deadline` handles the rigorous procedural logic, guaranteeing accuracy for legal filings and compliance reporting. - Save time on holiday checks. Simply provide your list of national holidays; the MCP will skip them automatically, saving you from manually adjusting timelines around major observed days. - Guaranteed business day counting. Forget the guesswork between month ends or quarter starts. This tool only counts actual working days, making it perfect for billing cycles and procedural steps. - Reliable workflow integration. Because this calculation is deterministic, you can trust your agent to use `calculate_legal_deadline` in complex, multi-step compliance workflows without breaking the timeline. - Speed up contract review. Quickly determine the final completion date for a project by feeding the start date and required working days into the calculator. ## How It Works The bottom line is that you get a mathematically verified legal due date every time, regardless of how complex the calendar variables are. 1. You initiate the process by providing your AI client with a starting date, the required number of business days, and an optional list of holidays. 2. The MCP receives this data and runs the calculation using its built-in logic. It checks every single day between the start and end points against both weekend rules and your provided holiday list. 3. You get back one definitive result: the precise final date for the deadline, ready to be logged or reported. ## Frequently Asked Questions **Does it automatically know all holidays?** No, to remain globally deterministic and local, the agent must pass an array of specific holiday dates (e.g., local state holidays) to be skipped during the count. **Does it count the start date?** No. In accordance with most civil procedural rules (like the Brazilian CPC), the count begins on the first business day *after* the start date. **Is this secure for client data?** Absolutely. The engine executes locally within the Vinkius Edge runtime, meaning no deadline inquiries are sent to external APIs. **When I use calculate_legal_deadline, how does it handle different time zones?** The engine processes dates using ISO standards. It focuses on calculating procedural business days regardless of the client's local timezone. You just need to ensure your initial input date is provided with accurate offset information for the calculation to be correct. **What happens if I pass an invalid or malformed date string to calculate_legal_deadline?** The tool will return a specific validation error message. This allows your AI client to catch the exception immediately and prompt you for a corrected, properly formatted input date before proceeding with the calculation. **Are there rate limits when I run calculate_legal_deadline frequently?** For standard use cases within an agent workflow, no rate limit applies. If you are running massive, high-volume batch computations, check Vinkius documentation for enterprise usage quotas. **What specific date format does calculate_legal_deadline require for the start date?** It requires a strict ISO 8601 formatted date string (YYYY-MM-DD). Using this standard format ensures maximum compatibility and prevents misinterpretation of month/day orders. **Can I adapt calculate_legal_deadline for different national holidays or jurisdictions?** Yes, you provide the optional holiday list directly within your prompt. By passing a custom array of non-business days, you force the calculation to adhere strictly to those specific jurisdictional rules.