How to Use the Calendarific Alternative MCP in OpenAI Agents SDK

Q: What happens if an agent requests an invalid country code?

The agent calls listsupportedcountries to verify the inputs first. If the country isn't supported, your agent handles the error gracefully rather than failing during execution.

Verify global holiday conflicts directly inside your OpenAI Agents SDK production flows without hardcoding regional calendars.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calendarific Alternative MCP to OpenAI Agents SDK

Create your Vinkius account to connect Calendarific Alternative 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 Calendarific Alternative with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Global Holiday Verification via OpenAI Agents SDK

The `get_holidays` tool pulls real-time holiday schedules directly into your OpenAI Agents SDK runtime using this MCP Server to prevent scheduling errors. Your agents query specific country codes and years, instantly receiving validated public, religious, or bank holiday lists. Because you are deploying to production, caching is critical. Set `cacheToolsList=True` in your server configuration so your OpenAI agents don't waste execution time re-fetching the tool definitions on every single run.

Dynamic Country Validation on This MCP Server

The `list_supported_countries` tool lets your agent check which regions are supported before attempting to fetch holiday calendars. This prevents your OpenAI agents from throwing unhandled errors when users input obscure or unsupported regions. You configure this by passing the server to your Agent constructor via `mcp_servers=[server]`. The agent queries the endpoint, verifies the country code, and gracefully handles unsupported locations before triggering downstream tasks.

Multi-Agent Handoffs for Holiday-Aware Scheduling

The `get_holidays` tool feeds clean temporal data directly into OpenAI's specialized routing agents. When a scheduling agent detects a calendar conflict, it hands the task off to a validation agent equipped with this tool. This setup uses `MCPServerStreamableHttp` to stream clean JSON payloads straight to the OpenAI dashboard. You track the entire tool execution path, ensuring your production agents never book a meeting on a national holiday.

Setup guide

Set up Calendarific Alternative 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 Calendarific Alternative tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Calendarific Alternative tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Calendarific Alternative 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="Calendarific Alternative Agent",
            instructions="You have access to Calendarific Alternative 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 Calendarific. 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 Calendarific Alternative 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 Calendarific Alternative MCP in OpenAI Agents SDK

Install the SDK using pip, then initialize the server using `MCPServerStreamableHttp`. Pass this instance directly into your Agent constructor using the `mcp_servers` list. Turn on `cacheToolsList=True` to keep your agent runs fast.

Yes, it does. Your OpenAI agents automatically discover the holiday tools when you register the server. You don't need to manually define schemas or write custom validation wrappers.

Absolutely. You route holiday queries to a specialized agent that possesses the `get_holidays` tool. If a user asks about regional closures, the primary agent hands off execution to this holiday-aware agent instantly.

The agent calls `list_supported_countries` to verify the inputs first. If the country isn't supported, your agent handles the error gracefully rather than failing during execution.

Vinkius hosts this server in an ephemeral V8 sandbox, meaning your country and year query parameters are never stored. Once the holiday payload is delivered back to your OpenAI agent, the session data is wiped.

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