How to Use the Nager.Date MCP in Google ADK

Q: How do I initialize Nager.Date with Google ADK?

Install google-adk and create an McpToolset using StreamableHttpServerParameters. Pass that toolset into the tools array of your LlmAgent.

Q: Can Google ADK filter which Nager.Date tools the agent sees?

Yes. Use the optional toolnames filter on the toolset constructor. This lets you expose just isholidaytoday while hiding the broader worldwide search tools.

Q: How do I handle rate limits with large context models?

Gemini can pull bulk data via getnextholidaysworldwide once and store it in context. This minimizes repeated calls to the API for the duration of the session.

Give Google ADK agents real-time access to global holidays. Cross-reference Nager.Date calendars with your BigQuery supply chain data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nager.Date MCP to Google ADK

Create your Vinkius account to connect Nager.Date to Google ADK 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 Nager.Date with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cross-Reference Holidays with BigQuery

Enterprise agents need to connect external reality with internal data. You can pipe Nager.Date's `get_public_holidays` directly into a Google ADK agent that also has access to your BigQuery logistics tables. The Gemini model reads the holiday schedule, cross-references it with your warehouse inventory, and flags potential delivery delays. You get a unified view of your operations without writing custom ETL pipelines for calendar data.

Feed the 1M+ Token Context Window

Gemini's massive context window changes how you handle temporal data. Your agent can pull the entire year's schedule for 50 different regions using `get_next_holidays` and hold it all in memory. Instead of making piecemeal API calls every time a user asks a question, the agent digests the global calendar upfront. It uses `list_available_countries` to map the regions, loads the dates, and answers complex cross-border scheduling queries instantly.

Targeted MCP Server Tool Exposure

Sometimes you only want your agent checking today's status, not pulling historical data. Google ADK lets you restrict the exposed tools using the `tool_names` filter when setting up your MCP Server connection. You can limit the agent to just `is_holiday_today` and `get_country_details`. This keeps the agent focused, reduces token usage, and prevents it from wandering into irrelevant global queries when it should be routing a specific package.

Setup guide

Set up Nager.Date MCP in Google ADK

Prerequisites

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

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Nager.Date tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Nager.Date_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Nager.Date tools via MCP.",
    tools=mcp_tools,
)

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. 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 Nager.Date 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 Nager.Date MCP in Google ADK

Install `google-adk` and create an `McpToolset` using `StreamableHttpServerParameters`. Pass that toolset into the `tools` array of your `LlmAgent`.

Yes. Use the optional `tool_names` filter on the toolset constructor. This lets you expose just `is_holiday_today` while hiding the broader worldwide search tools.

It works perfectly. Your Gemini models running on Vertex AI can query the Nager.Date MCP Server directly to adjust enterprise workflows based on regional closures.

Gemini can pull bulk data via `get_next_holidays_worldwide` once and store it in context. This minimizes repeated calls to the API for the duration of the session.

The server strictly reads ISO country codes and date strings. Your proprietary BigQuery schemas and Vertex AI prompts remain entirely on Google Cloud infrastructure and are never transmitted to the holiday API.

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