How to Use the Business Timezone & Holiday Scheduler MCP in OpenAI Agents SDK

Stop guessing dates in your OpenAI Agents SDK production builds. Calculate business timelines and offsets with total precision.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Business Timezone & Holiday Scheduler MCP to OpenAI Agents SDK

Create your Vinkius account to connect Business Timezone & Holiday Scheduler to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Business Timezone & Holiday Scheduler with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Skip holidays in OpenAI Agents SDK

Use `add_business_days` to push project deadlines past weekends and local public holidays. It pulls actual calendar data so your agent never schedules a task for a bank holiday. Your OpenAI Agents SDK agent maintains strict guardrails by calculating dates based on the specific country code you provide. It prevents the common failure where models hallucinate availability on non-working days.

Precision time conversion for agents

The `convert_timezone` tool maps timestamps across global regions using IANA strings. It handles the heavy lifting of offset math so your code stays clean. Don't rely on your OpenAI Agents SDK model to guess UTC offsets. This MCP server handles the conversion logic while the agent focuses on the actual business logic.

Reliable scheduling for production systems

The Business Timezone & Holiday Scheduler removes the risk of manual date math errors in your codebase. It acts as a deterministic source of truth for all time-based operations. Your OpenAI Agents SDK environment benefits from this server by delegating calendar complexity to a dedicated toolset. It keeps your agent traces clear and your logic predictable.

Setup guide

Set up Business Timezone & Holiday Scheduler MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Business Timezone & Holiday Scheduler tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Business Timezone & Holiday Scheduler tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Business Timezone & Holiday Scheduler tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Business Timezone & Holiday Scheduler Agent",
            instructions="You have access to Business Timezone & Holiday Scheduler tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

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.

Connect Business Timezone & Holiday Scheduler now

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 OpenAI Agents SDK

Yes, you simply pass the server parameters into your agent constructor. It integrates directly into your existing workflow.

The tool queries external APIs to fetch real-world holiday data based on your input country code. Your agent then uses this data to adjust timelines dynamically.

Not at all. You can set cacheToolsList to true to keep the tool definitions ready for instant execution.

No, the agent automatically discovers these tools once you add them to the constructor. It works out of the box.

The server only processes IANA timezone strings and ISO country codes. It never touches sensitive user data or private business records.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python