# BR Business Days Calculator MCP for AI Agents AI Agent Connect > BR Business Days Calculator. Stop your AI from messing up Brazilian delivery dates. This Connector gives your agent a deterministic way to calculate SLAs, skipping weekends and all Brazilian national holidays without making a single external network call. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_4BxpophtC9ipMVdNkVy8jC6qOkXy5wQSxKL8OU7o/ai-agent-connect - **Tags:** sla-tracking, date-math, business-logic, holiday-calculation, scheduling, time-management ## Description When you're building a system that handles shipping, banking, or project deadlines in Brazil, you can't trust an AI to do the math on its own. It might remember a holiday from last year or completely miss a long weekend. This Connector fixes that by giving your agent a reliable calculator that understands the Brazilian calendar perfectly. Instead of hoping the AI knows when Carnival is, you can just tell it to add ten business days to a date. It handles the heavy lifting of skipping Saturdays, Sundays, and every official holiday automatically. Because it's a local engine, the response is instant and doesn't depend on any external APIs. It's one of the many specialized tools you can find in the Vinkius catalog to make your agent actually useful for regional business logic. This means your customers get accurate dates, your project plans stay on track, and you don't have to spend time manually correcting the AI's mistakes. ## Tools ### is_business_day This tool checks if a specific date is a working day in Brazil. It handles both weekends and all national holidays. ### add_business_days This tool adds or subtracts a specific number of business days from a date. It automatically skips Brazilian holidays and weekends. ## Prompt Examples **Prompt:** ``` Calculate a 10-business-day delivery SLA starting from 2024-02-09 in Brazil. ``` **Response:** ``` ✅ **Business SLA Date:** `2024-02-27` (Note: The calculation skipped the Carnival holidays and all intervening weekends.) ``` **Prompt:** ``` Is 2024-11-15 a valid business day for banking in Brazil? ``` **Response:** ``` ❌ **Validation:** False. November 15, 2024, is a national holiday in Brazil (Republic Proclamation) and is not a business day. ``` **Prompt:** ``` Add 1 business day to 2024-03-28. ``` **Response:** ``` ✅ **New Date:** `2024-04-01` (Note: The calculation skipped Good Friday on 03-29 and the following weekend.) ``` ## Capabilities ### Calculate delivery dates Add or subtract business days while skipping Brazilian holidays. ### Verify business days Check if a specific date is a working day or a holiday. ### Skip weekends Automatically ignore Saturdays and Sundays in any date calculation. ### Handle Brazilian holidays Correctly account for dates like Carnival or Republic Proclamation. ### Execute locally Perform all calculations instantly without any network requests. ## Use Cases ### Shipping Logistics A customer asks for a 5-day shipping estimate from Feb 10th. The agent uses add_business_days to skip Carnival. ### Banking Operations A user asks if a specific date is a holiday. The agent uses is_business_day to confirm it's a Republic Proclamation holiday. ### HR Planning An employee wants to know their last day of work. The agent subtracts 30 business days from their resignation date. ### Project Management A team needs to know when a 2-week sprint ends. The agent calculates the date, skipping all Brazilian weekends and holidays. ## Benefits - Accurate SLA dates: Use add_business_days to ensure your agent never promises a delivery date that falls on a holiday or weekend. - Local execution: Since it's a local engine, is_business_day checks happen instantly without waiting for external API responses. - No more hallucinations: Stop your agent from guessing dates and start using deterministic logic for Brazilian business rules. - Regional holiday support: Automatically skip complex dates like Carnival or Republic Proclamation without manual prompts. - Negative day support: Use add_business_days with negative numbers to easily calculate past deadlines or due by dates. ## How It Works The bottom line is you get 100% accurate Brazilian SLA dates without any AI hallucinations. 1. Connect the Connector to your AI client through the Vinkius dashboard. 2. Provide a starting date and the number of business days to add or subtract. 3. Get back a precise Brazilian business date that accounts for all holidays. ## Frequently Asked Questions **Can the BR Business Days Calculator handle Carnival?** Yes, it automatically skips Carnival and all other Brazilian national holidays. **Does the BR Business Days Calculator use an external API?** No, it's a local engine, so it's much faster and doesn't rely on external websites. **Can I use the BR Business Days Calculator to subtract days?** Yes, you can use it to count backward to find past deadlines or start dates. **Is the BR Business Days Calculator accurate for 2024?** Yes, it includes the standard Brazilian national holiday list for accurate scheduling. **Will the BR Business Days Calculator count weekends?** No, it specifically ignores Saturdays and Sundays when calculating business days. **How does the BR Business Days Calculator handle regional holidays?** It focuses on Brazilian national holidays to ensure your Brazilian business logic is correct. **Does it require an external API?** No! It uses a statically compiled list of Brazilian national holidays. **Does it skip weekends automatically?** Yes, Saturdays and Sundays are ignored. **Are Carnival and Easter supported?** Yes, the dynamic dates for these holidays are embedded.