How to Use the Tomorrow.io Extended MCP in Windsurf

Q: What is the difference between getting real-time data and historical data with Tomorrow.io Extended?

The getrealtimeweather tool gives you conditions happening right now. If you need to check what happened last month, you use getrecenthistory. It keeps your agent from confusing current status with past records.

Run complex weather checks for Windsurf, automatically chaining actions to hit your goal.

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 Extended MCP to Windsurf

Create your Vinkius account to connect Tomorrow.io Extended to Windsurf 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 Extended with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Monitor Air Quality with Tomorrow.io Extended MCP Server

Cascade uses `get_air_quality` to pull current atmospheric readings for a specific location. It tells you if the air is safe to breathe, helping you plan outdoor activities without needing multiple manual steps. This goes beyond just knowing the temperature. By accessing `get_air_quality`, your agent gets actionable data about pollutants, letting you make smarter decisions when planning routes or fieldwork.

Forecast Weather Trends with Tomorrow.io Extended MCP Server

Need to know what's coming? Cascade uses `get_weather_forecast` to pull future weather conditions. It doesn’t just give a single prediction; it provides a look ahead, so you can plan resources weeks or days out. It also checks the immediate status with `get_realtime_weather`. This lets your agent build a complete picture of local weather, from right now until next Tuesday.

Identify Hazards and Check History for Windsurf

Before you deploy anything outside, Cascade can check for known issues. It calls `list_weather_alerts` to show any active warnings—things like severe thunderstorm watches or flash flood advisories. If you need context, it uses `get_recent_history`. This pulls back a timeline of past weather data, letting your agent compare current conditions against what's actually happened here before.

Setup guide

Set up Tomorrow.io Extended MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Tomorrow.io Extended MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Tomorrow.io Extended payment history." If connected, Cascade will call the Tomorrow.io Extended tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "tomorrowio-extended-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Extended 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 Extended MCP in Windsurf

Windsurf's Cascade reads your goal and figures out the necessary steps automatically. You just tell it you need to know if a site is safe for construction, and it chains together calls like `get_air_quality` and `list_weather_alerts` without you having to prompt each one.

This MCP Server touches Air Quality data. This is environmental information describing atmospheric pollutants (e.g., PM2.5 levels). The server uses this data to provide actionable insights.

Absolutely. Since Windsurf's Cascade handles multi-step actions, you can set the goal—for example, 'Check if we can run next week.'—and it will execute the necessary sequence of tools like `get_weather_forecast` and `list_weather_alerts` for you.

The `get_realtime_weather` tool gives you conditions happening right now. If you need to check what happened last month, you use `get_recent_history`. It keeps your agent from confusing current status with past records.

Because Cascade is an autonomous agent, it can be integrated into automated flows. You set the desired goal once, and the agent figures out how to pull the relevant data (like `get_weather_forecast`) whenever that flow runs.

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