How to Use the Tomorrow.io Plus MCP in Mastra AI

Q: How do I ensure Tomorrow.io Plus data is retried with Mastra AI?

Mastra AI automatically handles retries for tools like getforecastweather. If the first attempt fails, it tries again using a structured backoff schedule until successful.

Q: Can Tomorrow.io Plus list all event categories with Mastra AI?

Yes, you can use listinsights to retrieve every available pre-defined insight category. This allows your complex workflow to map and track specific weather events using listevents.

Q: Does tomorrow.io plus support listing all account locations with Mastra AI?

You can use listlocations to get a complete list of defined areas. This data feeds into other tools, allowing your workflow to process multiple regions sequentially.

Build reliable workflows for weather data using Mastra AI.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Reliably Fetch Forecasts

You can set up a multi-step workflow to get the next week's forecast. If your initial call to `get_forecast_weather` fails due to an API timeout, Mastra AI will automatically retry using exponential backoff. This means your complex operational flow doesn't break over transient network errors. The system handles the failure and tries again until it gets valid data.

Manage Complex Location Data

Need to analyze a weather pattern across a specific, non-standard area? Use `post_timelines` with GeoJSON geometries. Mastra AI runs this tool call and waits for the result before moving on. This workflow guarantees that even if one part of your analysis fails (like listing events via `list_events`), you still get confirmation or a clear error, allowing controlled branching.

Automate Historical Data Retrieval

A critical task is compiling weather history. Your workflow can call `get_recent_history_weather` and then use that data to trigger an alert check via `list_alerts`. If alerts are active, the flow proceeds to notify the admin. Mastra AI ensures this sequence runs reliably; if listing alerts fails, it doesn't stop the whole process.

Setup guide

Set up Tomorrow.io Plus MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Tomorrow.io Plus tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "tomorrowio-plus-mcp-client",
  servers: {
    "tomorrowio-plus-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Tomorrow.io Plus Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Tomorrow.io Plus tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Tomorrow.io Plus transactions"
);
console.log(result.text);

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 Mastra AI

Mastra AI automatically handles retries for tools like `get_forecast_weather`. If the first attempt fails, it tries again using a structured backoff schedule until successful.

Yes, you can use `list_insights` to retrieve every available pre-defined insight category. This allows your complex workflow to map and track specific weather events using `list_events`.

Use it when the data retrieval is critical and must survive failures—for instance, fetching historical weather records or checking active alerts repeatedly.

You can use `list_locations` to get a complete list of defined areas. This data feeds into other tools, allowing your workflow to process multiple regions sequentially.

This server touches location coordinates and weather condition data (e.g., temperature, precipitationIntensity). The reliability of the workflow ensures that this sensitive information is processed only through controlled, managed steps.

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