BR Business Days Calculator MCP. Stop LLMs from miscalculating Brazilian SLAs.
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 lets your agent calculate precise work dates for Brazilian operations. It adds or subtracts business days, automatically skipping weekends and official Brazilian holidays.
It also checks if any given date is actually a valid working day, eliminating common SLA calculation errors from LLMs.
What your AI agents can do
Add business days
Adds or subtracts X Brazilian business days from a start date, automatically skipping weekends and holidays.
Is business day
Checks if a given date is a valid Brazilian business day, excluding weekends and national holidays.
Your agent adds or subtracts specified business days from a start date, guaranteeing the result skips Brazilian weekends and national holidays.
Your agent checks a specific date to confirm if it is a valid business day, accounting for all Brazilian national holidays and weekends.
Your agent calculates the exact date an SLA expires, respecting Brazilian work week rules.
Your agent shifts a project start date by a set number of working days, ensuring the new date lands on a valid business day.
Your agent validates a date to ensure it falls within a business operating period, useful for billing or payroll.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019e3871add business days
Adds or subtracts X Brazilian business days from a start date, automatically skipping weekends and holidays.
019e3871is business day
Checks if a given date is a valid Brazilian business day, excluding weekends and national holidays.
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 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
When you need to know what day the work week actually runs in Brazil, you gotta use this. The add_business_days tool adds or subtracts a set number of Brazilian business days from a start date; it automatically skips weekends and all the national holidays. You can use it to calculate future delivery dates by shifting a start date, guaranteeing the result avoids Brazilian weekends and national holidays.
It also helps you adjust project milestones by moving a project start date by a set number of working days, making sure the new date lands on a valid business day. For determining SLA completion dates, your agent calculates the exact expiration date, respecting the Brazilian work week rules. You can also confirm date validity for payment cycles by checking if a date falls within a business operating period.
The is_business_day tool checks if any given date is a valid Brazilian business day, excluding weekends and national holidays. It confirms if a date is a valid working day, which eliminates those common SLA calculation errors that LLMs make.
How BR Business Days Calculator MCP Works
- 1 You prompt your agent with a start date and a number of business days (positive or negative).
- 2 The agent calls the
add_business_daystool, which processes the date against a hardcoded Brazilian holiday list. - 3 The server returns the final, correct date, skipping all weekends and national holidays.
The bottom line is, your agent gets a date calculation that respects specific, localized business rules without calling an external API.
Who Is BR Business Days Calculator MCP For?
Anyone managing schedules or deadlines in Brazil. This is for the Operations Manager who can't afford missed deadlines, the Project Coordinator who needs accurate SLA tracking, or the Finance Analyst who needs to validate payment dates against local holidays.
They calculate project phase end dates, making sure the timeline accounts for Carnival or Republic Proclamation holidays.
They validate process flow dates to ensure every step lands on a working day, preventing manual errors in operational manuals.
They confirm if a due date or payment cycle falls on a business day before generating invoices or reports.
What Changes When You Connect
- Guaranteed SLA dates. When you use
add_business_days, the result always skips Brazilian weekends and national holidays, guaranteeing your agent provides the correct delivery date. - Zero latency math. Because this server uses a hardcoded holiday list, it doesn't call external APIs. The calculation is instant and always deterministic.
- Reliable validation. The
is_business_daytool confirms if a date is valid for any business process, saving you from relying on guesswork for critical dates. - Accuracy for complex rules. It handles dynamic and static Brazilian holidays (like Carnival or Proclamation Day), rules that simple date math libraries miss.
- Works offline. Since the holiday data is local, your agent can calculate accurate dates even if the network connection drops.
- Direct date control. You don't get general date formatting; you get specific, verifiable business dates, which is what you actually need for compliance.
Real-World Use Cases
Calculating a delayed project milestone
A Project Manager needs to know the new deadline after a 10-day delay, starting Feb 9th. They ask their agent to 'add 10 business days to 2024-02-09 (Brazil)'. The agent runs add_business_days, which correctly calculates the end date, skipping both weekends and the Carnival holiday, giving the PM a precise, accurate date.
Verifying a payment due date
A Financial Planner has an invoice due on November 15th. They ask their agent, 'Is 2024-11-15 a business day in Brazil?'. The agent runs is_business_day, which immediately returns 'False' because it's a national holiday, preventing the planner from sending the invoice on a non-working day.
Shifting a contract start date
A Coordinator needs to set a contract start date that is 5 business days after the current date. They prompt the agent to add 5 business days. The agent uses add_business_days, ensuring the start date lands on a valid working day, regardless of surrounding weekends or holidays.
Checking date eligibility for reporting
An Operations Analyst needs to know if a specific date, like March 29th, is valid for a report run. They run is_business_day on the date. The agent confirms if the date is valid, accounting for all Brazilian business rules, making the report run reliable.
The Tradeoffs
Using simple date math
The agent calculates 'add 7 days to X' using standard library functions. The result lands on a Saturday, and the user assumes that's the date, leading to a compliance failure.
→
Don't use simple math. Use the add_business_days tool. It takes the start date and the number of working days, ensuring the final date is always a valid business day.
Ignoring local holidays
The agent uses a generic scheduler that only checks for weekends. It misses a critical national holiday like Carnival, causing the calculated SLA to be off by several days.
→
The add_business_days tool is built specifically for Brazilian law. It checks for both weekends and all static/dynamic Brazilian holidays.
Relying on external APIs
The agent calls a global date API for calculation. That API is slow or rate-limited, causing the entire workflow to time out or fail unpredictably.
→ Use the BR Business Days Calculator. It runs calculations locally and instantly, with zero external network calls. This keeps your workflow reliable, even when the network is patchy.
When It Fits, When It Doesn't
Use this if your workflow requires scheduling, invoicing, or reporting dates that must strictly adhere to Brazilian national holidays and weekends. You need deterministic math for compliance or operations.
Don't use this if you just need to calculate elapsed calendar time (e.g., 'How many days are between X and Y?'). For that, a simple date subtraction tool is fine. If you only need to check if a date is a weekend, a simple calendar check is enough. This tool is for complex, rules-based date logic.
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.
Available Capabilities
Calculating project timelines used to be a mess of spreadsheets and guesswork.
You start by calculating the end date in a spreadsheet. Then, you manually cross-reference a holiday calendar and count the weekends. If you miss one national holiday, or if the calculation crosses a time zone boundary, the entire SLA is wrong. You then spend hours correcting the numbers and arguing with stakeholders about the correct date.
With this MCP Server, you let your agent handle the math. You simply ask it to 'add 15 business days to X date'. The agent runs the `add_business_days` tool, and you get the final, correct date instantly. It handles all the Brazilian rules automatically.
BR Business Days Calculator MCP Server: Accurate scheduling with `is_business_day`.
Before running a report or sending a payment, you have to manually check if the target date is actually a working day. You check the calendar, you cross-reference the holiday list, and you double-check the rules. It's tedious, and you always worry you missed something.
Now, you just ask your agent to check the date. The agent calls `is_business_day` and gets an immediate, definitive True or False. You don't have to worry about the rules—the tool handles it.
Common Questions About BR Business Days Calculator MCP
Does the BR Business Days Calculator MCP Server handle all Brazilian holidays? +
Yes. The server uses a hardcoded list that accounts for static and dynamic Brazilian national holidays, including things like Carnival and Proclamation Day.
Is `add_business_days` faster than other scheduling tools? +
Yes. Because the holiday data is embedded locally and requires no external network calls, the calculation is extremely fast and always deterministic.
Can I subtract business days using the BR Business Days Calculator MCP Server? +
Yes. Passing a negative number to add_business_days subtracts business days, moving the date backward while still respecting all holidays and weekends.
How does `is_business_day` work? +
The is_business_day tool checks if a date is a valid working day by confirming it is not a weekend day and not a recognized Brazilian national holiday.
How do I ensure the `add_business_days` tool correctly handles date input formats? +
It accepts the starting date and the number of days as standard string inputs. The engine processes the date as an ISO string, which is the expected format for reliable calculations.
Does the BR Business Days Calculator MCP Server have any rate limits or performance restrictions? +
No, the server is designed for low-latency, deterministic calculations. Since it performs all checks locally in the V8 isolate, there are no external API calls or rate limits to worry about.
What happens if I try to use `is_business_day` with a date outside of Brazil's operational scope? +
It only checks against the hardcoded Brazilian national holiday list. If the date is outside the scope, it will still correctly identify weekends and any specific Brazilian holidays it tracks.
Which AI clients are compatible with the BR Business Days Calculator MCP Server? +
The server uses the Model Context Protocol (MCP) standard, so it connects with any compatible AI client, including Claude, Cursor, VS Code, and others.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Quantive (Gtmhub)
Automate OKR strategy via Quantive — manage objectives, key results, and sessions directly from any AI agent.
Timezone Offset Engine
Calculate the exact offset between two timezones at any moment, with full DST awareness. Powered by Luxon.
SEO Authority Prover
AI agents generate SEO content that triggers SpamBrain, lacks E-E-A-T signals, breaks technical fundamentals, and is invisible to AI search. This tool validates against Google's 2026 algorithms, GEO for AI citation, and AEO for answer engines. Zero stuffing, maximum authority.
You might also like
Data Sorting & Filtering Engine
Perfect array manipulation. Sort and deduplicate massive JSON lists with native Vinkius Edge JavaScript instead of relying on token-limited LLMs.
BoardEffect
Manage board activities via BoardEffect — list meetings, members, and documents directly from any AI agent.
Monnify
Manage payments and virtual accounts in Nigeria via Monnify — track transactions and reserve accounts directly from your AI agent.