How to Use the Business Timezone & Holiday Scheduler MCP in Windsurf
Stop Cascade from scheduling code releases on Christmas. Give Windsurf the calendar intelligence it needs to plan actual workdays.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Business Timezone & Holiday Scheduler MCP to Windsurf
Create your Vinkius account to connect Business Timezone & Holiday Scheduler to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Auto-Skip Global Holidays in Cascade Workflows
Cascade loves to build multi-step plans, but it has no idea when banks are closed in Tokyo or Brazil. When you tell your Windsurf agent to schedule a release cycle or set a deadline, it uses `add_business_days` through this MCP Server to query the Nager.Date API. Your agent automatically skips local public holidays and weekends without you needing to look up foreign calendars. This means you can drop a goal like "schedule the next three sprint milestones for our Tokyo branch" into Cascade. The agent handles the math, skips the Japanese New Year, and writes the correct dates directly into your project files.
Map Timezones Directly in Your Code with this MCP Server
Cascade can refactor your scheduling code and test timezone conversions on the fly. By using `convert_timezone`, the agent translates IANA strings like "America/Sao_Paulo" to "Asia/Tokyo" to verify your app's internal clock logic. It handles the shift instantly while writing or debugging your backend services. You don't have to copy-paste timestamps into Google to see if your test assertions make sense. Windsurf queries the server, gets the exact offset, and updates your test suites with real, validated data.
Chain Multi-Region Deadline Calculations
Cascade shines when executing complex, multi-step tasks that span different countries using this MCP connection. If you are building a global shipping tracker, the agent chains `add_business_days` and `convert_timezone` to map out delivery windows across different hemispheres. It calculates the exact moment a package will arrive, factoring in both local business hours and regional holidays. The agent writes the logic, runs the calculations, and commits the code. You get a fully functional, timezone-aware feature without ever leaving your workspace or correcting Cascade's date math.
Set up Business Timezone & Holiday Scheduler MCP in Windsurf
Prerequisites
- Windsurf IDE installed (macOS, Windows, or Linux)
- Active Vinkius subscription with a valid endpoint token
- 1
Open MCP configuration
Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open
~/.codeium/windsurf/mcp_config.json. - 2
Add the Business Timezone & Holiday Scheduler MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. Replace[YOUR_TOKEN_HERE]with your endpoint token from cloud.vinkius.com. - 3
Refresh MCPs
Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
- 4
Verify in Cascade
Start a new Cascade conversation and ask something like "Show my Business Timezone & Holiday Scheduler payment history." If connected, Cascade will call the Business Timezone & Holiday Scheduler tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"business-timezone-holiday-scheduler-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nager.Date API. 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.
Why Choose Vinkius
Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.
Real-time monitoring
Live
visibility into every interaction
Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.
Built-in savings
60%
lower AI costs
Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.
Single dashboard
One
place for every integration
Every tool your AI connects to, managed from a single screen. One account, complete control.
Common questions about Business Timezone & Holiday Scheduler MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Business Timezone & Holiday Scheduler MCP today
We host it, we monitor it, we maintain it. You just paste one token.
