How to Use the AerisWeather MCP in Cursor

Q: How do I connect AerisWeather to the Cursor agent?

Create a .cursor/mcp.json file in your project's root directory. Add the AerisWeather MCP server details Vinkius provides. Once you save the file, the agent will have access to all the tools.

Q: Can I use AerisWeather and Cursor to get historical weather data for my app?

Yes, the getconditions tool can pull historical data back to 2004. You can ask the agent to write a script that fetches and processes this data for a specific location and date range.

Q: Is it possible to get minutely precipitation forecasts with AerisWeather in Cursor?

It is. The getconditions tool supports a minutelyprecip filter. You can instruct the agent to call the tool with that filter to get a hyper-local rain forecast for the next hour.

Inject live AerisWeather API responses directly into your code with Cursor's agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AerisWeather MCP to Cursor

Create your Vinkius account to connect AerisWeather to Cursor 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 AerisWeather with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Code Against Real Weather Data

Use `get_observations` and `get_conditions` to pull real-time weather into your editor. Your agent can query by location ID, search for the closest station, or find data within a geographic area. Stop writing code against static, mock JSON files. Tell Cursor's agent to get the current conditions for a location. This MCP server calls the API and drops the actual response right into your file, so you build with live data from the start.

Test Complex API Logic Efficiently

The `get_batch` tool lets your agent fire multiple requests to the AerisWeather API at once. You can combine up to 31 queries for forecasts, alerts, and observations into a single call. This is perfect for testing functions that need to handle multiple data sources. Have the agent generate a test case that fetches a forecast and an alert for the same location. You get realistic, combined data without writing multiple fetch calls.

A Full Weather MCP Server for Your Agent

This server gives your agent a complete set of weather tools. It can look up locations with `get_places`, check for warnings with `get_alerts`, and pull forecasts with `get_forecasts`. When you're building an app that uses weather data, you can ask the agent questions and get immediate, actionable code. "Write a function that checks for storm alerts in Miami, then get the 3-day forecast if there are none." The agent has the tools to do it.

Setup guide

Set up AerisWeather MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the AerisWeather MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent AerisWeather transactions." If the MCP tools are loaded correctly, Cursor will call the AerisWeather tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "aerisweather-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 AerisWeather. 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 AerisWeather 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 AerisWeather MCP in Cursor

Create a `.cursor/mcp.json` file in your project's root directory. Add the AerisWeather MCP server details Vinkius provides. Once you save the file, the agent will have access to all the tools.

Yes, the `get_conditions` tool can pull historical data back to 2004. You can ask the agent to write a script that fetches and processes this data for a specific location and date range.

It is. The `get_conditions` tool supports a `minutelyprecip` filter. You can instruct the agent to call the tool with that filter to get a hyper-local rain forecast for the next hour.

It saves time and reduces network chatter. Instead of your agent making separate API calls for forecasts, alerts, and observations, it can bundle them into one request. This is especially useful for generating complex test data.

The server only receives the location identifiers and parameters from your agent's requests. It never sees your source code or anything else in your editor. Each request is an isolated transaction inside a Vinkius V8 sandbox.

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