How to Use the Tomorrow.io MCP in OpenAI Agents SDK

Q: Can Tomorrow.io predict pollen counts using the OpenAI Agents SDK?

Yes. You can use getpollenforecast to retrieve daily pollen count indices for a given location, helping your agent plan around seasonal allergies.

Q: Does tomorrowio-mcp support custom time ranges with the OpenAI Agents SDK?

Yep. The getcustomtimelines tool lets you query weather data across arbitrary intervals and specific date ranges, giving your agent total control over the lookback period.

Build reliable weather agents with the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Tomorrow.io MCP to OpenAI Agents SDK

Create your Vinkius account to connect Tomorrow.io 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 Tomorrow.io with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

MCP Server: Real-Time Location Data

Need to know what's happening right now? Use `get_realtime_weather` to pull current conditions for any spot—by city name, zip code, or coordinates. You also get the basics on road safety with `get_road_weather_risk`, which checks for driving hazards. It’s perfect when your agent needs immediate data before running a task. The tool set handles everything from general weather readings to specialized risk assessments like tracking wildfire danger via `get_wildfire_risk`.

Predicting Weather Extremes for OpenAI Agents SDK

The system lets you look way ahead, whether it’s 15 days out using `get_daily_forecast` or a deep dive into the next twelve hours with `get_hourly_forecast`. These tools give you daily extremes and total predicted amounts. Furthermore, if your agent needs to know what happened last Tuesday, `get_historical_weather` pulls actual recorded data. It gives full context by comparing predictions against documented reality.

Advanced Climate Intelligence for OpenAI Agents SDK

Go beyond just temperature. You can check the air quality index with `get_air_quality_index`, or get a specific minute-by-minute rainfall forecast using `get_minutely_precipitation`. These tools feed deep climate data to your agent. Plus, if allergies are a concern, run `get_pollen_forecast` for daily counts. You can even customize the query time window with `get_custom_timelines`, letting your agent pull weather data for non-standard periods.

Setup guide

Set up Tomorrow.io 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 Tomorrow.io tools at runtime.
3

Create your Agent

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

Run the agent

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

The MCP Server allows your OpenAI Agent to call specific functions like `get_hourly_forecast` directly. Your agent auto-discovers the available tools, so you don't have to write any boilerplate connection code.

It provides granular weather intelligence, including daily forecasts (`get_daily_forecast`), real-time conditions (`get_realtime_weather`), and specific risk assessments like wildfire danger.

Yes. You can use `get_pollen_forecast` to retrieve daily pollen count indices for a given location, helping your agent plan around seasonal allergies.

Yep. The `get_custom_timelines` tool lets you query weather data across arbitrary intervals and specific date ranges, giving your agent total control over the lookback period.

This MCP Server handles highly sensitive environmental metrics, including air quality index, precipitation amounts, and real-time location coordinates (lat/lon).

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