How to Use the Tomorrow.io Plus MCP in Windsurf

Q: Can I check multiple types of alerts with Tomorrow.io Plus and Windsurf?

Yep. You can use listalerts for official weather warnings, or if you want more specific details, run listevents. The MCP Server pulls both categories so your agent has a comprehensive view before deciding what to show the user.

Q: Does Tomorrow.io Plus support advanced location data with Windsurf?

Absolutely. You can use posttimelines to handle complex locations, like those defined by GeoJSON geometries. This is much better than simple point coordinates when mapping out weather patterns for a large area.

Q: How do I manage locations with Tomorrow.io Plus and Windsurf?

You can use the listlocations tool to see all pre-defined spots in your account. If you need a new one, the agent guides you through defining it before running any weather queries.

Build multi-step weather applications with Windsurf.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Visualize Forecasts and History

Need to show how a location's weather has changed? You can get detailed historical data for the last 24 hours using `get_recent_history_weather`. Cascade figures out the sequence: it grabs the history, then uses that context to fetch an hourly forecast via `get_forecast_weather`. This works great when you're building a dashboard. The agent chains these steps automatically—you just set the goal, and Windsurf handles the data retrieval flow.

Check for Active Weather Alerts

Setting up an app that warns users about bad weather? Use `list_alerts` to check every active warning based on specific locations. The MCP Server pulls this list, and Cascade can then use the location data to fetch current conditions with `get_realtime_weather`. It's a two-step process: first, identify *if* there are alerts; second, pull the live details for those areas. This keeps your app accurate.

Map Complex Weather Patterns

You can't just show points on a map—you need tiles and geometry data. The agent uses `get_map_tile` to pull the visual background, while also running `post_timelines` if you have complex areas defined by GeoJSON geometries. If your goal is 'show weather for this polygon,' Windsurf handles both the tile retrieval and the specific temporal data fetching in one shot. It's built for multi-tool planning.

Setup guide

Set up Tomorrow.io Plus 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 Plus 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 Plus payment history." If connected, Cascade will call the Tomorrow.io Plus tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "tomorrowio-plus-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 Plus 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 Plus MCP in Windsurf

You set a goal, and your agent handles the rest. For example, 'Show me weather history for downtown.' Cascade knows it needs to call `get_recent_history_weather` first, then structure the output into a readable chart. You don't have to prompt each step.

Yep. You can use `list_alerts` for official weather warnings, or if you want more specific details, run `list_events`. The MCP Server pulls both categories so your agent has a comprehensive view before deciding what to show the user.

Absolutely. You can use `post_timelines` to handle complex locations, like those defined by GeoJSON geometries. This is much better than simple point coordinates when mapping out weather patterns for a large area.

It exposes everything from raw historical measurements to structured insights. You get fields like temperature and precipitation intensity through `get_timelines`, making it highly flexible for any visualization.

You can use the `list_locations` tool to see all pre-defined spots in your account. If you need a new one, the agent guides you through defining it before running any weather queries.

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