How to Use the Business Timezone & Holiday Scheduler MCP in LangChain

Q: How do I initialize Business Timezone & Holiday Scheduler in LangChain?

Install langchain-mcp-adapters and use the client pointing to the Vinkius MCP Server endpoint. Call client.gettools() to load the calendar tools. Pass them to your agent constructor to start scheduling.

Keep LangChain agents from scheduling meetings on Tokyo bank holidays.

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 LangChain

Create your Vinkius account to connect Business Timezone & Holiday Scheduler to LangChain 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 LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Calculate exact target dates inside LangChain runs

The `add_business_days` tool determines future dates by skipping weekends and country-specific public holidays. Your agent calls this tool within a ReAct chain to figure out the actual deadline before passing it to the next step. LangSmith traces the entire operation so you see the exact input country code and the calculated date. You get clean ISO strings instead of letting your LLM guess how calendar math works.

Convert timezones across multi-step MCP chains

The `convert_timezone` tool translates dates between IANA zones like America/New_York and Europe/London. It feeds the correct offset directly into your LangChain agent's context using this MCP tool. This prevents timezone drift when your pipeline processes multiple international schedules. The output of one timezone conversion flows straight into your next database insert tool.

Chain holiday checks with LangChain tools

This MCP Server works directly with `MultiServerMCPClient` to combine calendar logic with your other tools. Your agent checks if a date is a holiday before writing a database record. Setup requires just `pip install langchain-mcp-adapters langgraph`. You pass the tools to your agent and let it coordinate complex scheduling tasks without manual date logic.

Setup guide

Set up Business Timezone & Holiday Scheduler MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Business Timezone & Holiday Scheduler tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "business-timezone-holiday-scheduler-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Business Timezone & Holiday Scheduler transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Your LangChain agent passes standard ISO country codes directly to the `add_business_days` tool. The MCP server queries the Nager.Date API to filter out local public holidays. This happens mid-chain before the agent returns the final date.

Yes, every holiday calculation and timezone shift shows up in your LangSmith dashboard. You see the exact inputs, outputs, and latency for these MCP tools. This makes debugging scheduling chains straightforward.

Install `langchain-mcp-adapters` and use the client pointing to the Vinkius MCP Server endpoint. Call `client.get_tools()` to load the calendar tools. Pass them to your agent constructor to start scheduling.

The MCP Server returns a clear error message specifying that the IANA string is invalid. Your agent reads this error and can ask the user for a valid zone like Europe/Paris. No silent failures occur.

The server only processes the dates, times, country codes, and IANA timezone strings you send. Vinkius runs the code in an isolated V8 sandbox that deletes all runtime data as soon as the execution finishes. No calendar data is stored permanently.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript