BR Business Days Calculator MCP. Never calculate an SLA based on a weekend or holiday again.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
BR Business Days Calculator adds or subtracts business days while perfectly skipping weekends and Brazilian national holidays. Stop relying on standard LLM date math for SLAs; this local, deterministic engine guarantees accurate delivery dates for Brazil.
What your AI agents can do
Add business days
Adds or subtracts X Brazilian business days from a given date, skipping weekends and national holidays automatically.
Is business day
Checks if a provided date is a valid working day by accounting for all Brazilian national holidays and weekends.
Determines a final date by adding or subtracting a specified number of working days from any starting date.
Checks if a given date falls on a day that is actually considered a business day, excluding weekends and holidays.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
BR Business Days Calculator: 2 Tools
Use these two tools to calculate and validate dates against specific Brazilian business rules.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using BR Business Days Calculator on Vinkius019e3871add business days
Adds or subtracts X Brazilian business days from a given date, skipping weekends and national holidays automatically.
019e3871is business day
Checks if a provided date is a valid working day by accounting for all Brazilian national holidays and weekends.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with BR Business Days Calculator, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by date-fns. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 2 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Scheduling deadlines often feels like guesswork.
Right now, calculating timelines means checking three different sources: a spreadsheet that lists holidays, an internal wiki with weekend rules, and then having to manually count forward or backward. You copy the start date, you open your calendar, you cross-reference the holiday list, and finally, you tell your agent what the end date is—a process built on tedious clicking and potential human error.
With this MCP, that entire manual chain disappears. You simply ask your AI client to calculate the date, and it handles all the complex logic—the holidays, the weekends, the specific Brazilian rules—internally. It gives you a single, guaranteed working day answer.
The `add_business_days` tool delivers predictable scheduling.
You no longer have to manually adjust for Carnival or the Proclamation of the Republic. The agent uses `add_business_days` and automatically accounts for these specific holidays, giving you the correct target date on the first try.
What's different now is certainty. You get a result that matches an actual corporate calendar, every time.
What you can do with this MCP connector
Calculating project deadlines that respect official work calendars is tricky stuff. If you ask your AI agent to add a few weeks to a start date, it often ignores major Brazilian holidays or just counts Saturdays and Sundays as working days. This MCP fixes that completely. It's built on a reliable calculation engine that knows the specific national holidays for Brazil, ensuring every single day counted is an actual business day.
Whether you need to check if a future date is valid for billing or calculate a precise delivery timeline, this tool handles all the math locally and instantly. You connect it via Vinkius, giving your agent access to enterprise-grade calendar accuracy without needing external API calls. It just works.
019e3872-06f4-70a4-bc96-590442841e9b 
How BR Business Days Calculator MCP Works
- 1 You provide the engine with a starting date and the required number of days (positive for adding, negative for subtracting).
- 2 The MCP calculates the timeline, automatically skipping all Saturdays, Sundays, and known Brazilian national holidays.
- 3 It returns the exact final working day that meets your requirement.
The bottom line is you get a guaranteed, accurate business date without any guesswork about holidays or weekends.
Who Is BR Business Days Calculator MCP For?
Project managers and operations staff who routinely calculate deadlines for clients in Brazil. You're the person tired of manual spreadsheet checks when an agent fails to account for a national holiday, making you waste hours correcting dates.
Uses this MCP daily to set and verify client service level agreements (SLAs) that must respect Brazilian holidays.
Checks billing cycles and payment deadlines, ensuring the due date falls on an actual business day for accurate accounting.
Determines realistic project timelines that account for non-working days across a complex development schedule.
What Changes When You Connect
- Guaranteed Accuracy: You never have to worry about LLMs miscalculating delivery dates. The engine correctly skips weekends and known Brazilian holidays every time you use
add_business_days. - Local Speed: This MCP runs entirely locally, meaning no external network calls or API latency slow down your agent's response time when using this tool.
- Validation Check: Use the
is_business_dayfunction to instantly verify if a specific date—like a contract deadline—actually falls on a working day in Brazil. - Deterministic Results: Forget hallucinated dates. The engine provides absolute reliability, ensuring your project schedules are based on hard-coded business rules.
- Flexible Math: Easily calculate backward or forward in time by passing negative or positive values to
add_business_days.
Real-World Use Cases
Setting a Project Deadline
A project manager needs to set an SLA that is 15 business days away from today. The agent runs the calculation, using add_business_days, and returns the correct date, skipping the upcoming Carnival holiday.
Checking Billing Validity
A financial analyst needs to confirm if a payment due on November 15th is valid. The agent checks this using is_business_day and immediately confirms it's a national holiday, requiring manual adjustment.
Timeline Adjustment
A development team lead shifts the project start date back by two weeks. Using add_business_days, they quickly calculate the new required completion date without needing to check an external calendar.
The Tradeoffs
Relying on basic LLM math
Asking your agent, 'What is 10 business days from X?' The model might return a date that falls on a Saturday or ignores a known national holiday.
→
Use add_business_days. This MCP specifically handles Brazilian holidays and weekends, giving you the reliable result you need.
Using vague calendar tools
Using general date utilities that assume a standard 7-day week or only recognize major US holidays.
→ Use this MCP. It's tailored for Brazilian business logic, giving you the correct answer every time.
When It Fits, When It Doesn't
Use this MCP if your core requirement is date accuracy relative to Brazil’s specific work calendar. You need a calculation that treats weekends and official holidays as non-existent days. Don't use it if you are calculating elapsed minutes or hours, or if the project crosses multiple time zones requiring complex DST handling; these tools handle simple date arithmetic. If you only need to validate a date against standard global rules, look for general calendar libraries. But for Brazilian business operations, this MCP is required.
Common Questions About BR Business Days Calculator MCP
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.
How does `add_business_days` perform in terms of latency? +
It performs instantly because it runs locally within a V8 isolate. This MCP uses a hardcoded list for holidays, meaning zero external network calls are needed. You get immediate results regardless of your connection speed.
Is the calculation secure and dependent on an external API when using `is_business_day`? +
No, it's completely self-contained and local. The MCP doesn't require any external network calls or APIs to function. This means your data never leaves your environment, which is critical for enterprise security.
What happens if I pass an improperly formatted date string to `add_business_days`? +
The engine will throw a clear error message indicating the required ISO format (YYYY-MM-DD). It won't attempt to guess or correct bad inputs, ensuring you only work with valid dates.
If I use `is_business_day` for a date that is not in Brazil, will it fail? +
Yes. The tool strictly validates against the hardcoded Brazilian national holiday list and rules. If the date falls outside of the defined scope or doesn't fit the required locale, you'll receive an explicit failure notice.
How can I ensure absolute determinism when chaining tools like `add_business_days`? +
The calculation is deterministic by design. It relies on a static, local holiday list that won't change or 'hallucinate.' You can trust that adding 10 business days today will always result in the same date.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.