# AerisWeather MCP > AerisWeather lets your AI agent access professional, global weather intelligence. Query real-time observations, 15-day forecasts, and official warnings for any location worldwide. You can check current conditions using `get_observations`, map out coordinates with `get_places`, or pull historical data to run reports—all through natural conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** weather-api, forecasts, weather-alerts, meteorology, hyper-local-weather ## Description Getting reliable weather context used to mean opening five different websites just to piece together a picture: one for the forecast, another for alerts, and yet another for geographical details. This MCP changes that. You connect it once via Vinkius, and your AI client handles all the legwork. It pulls real-time METAR data, generates multi-day forecasts, or checks if there are active flood warnings—all in one conversation. It’s about getting precise context quickly. Instead of scrolling through dozens of charts, you ask for specific data points: 'What's the precipitation rate in Miami next week?' The agent uses this MCP to find that answer instantly, giving you actionable intelligence whether you're planning a logistics route or running an environmental model. ## Tools ### get_alerts Retrieves official warnings and advisories for active weather dangers in a region. ### get_batch Allows you to query several data types, like observations and forecasts, in one efficient call. ### get_conditions Provides global current, forecast, or historical weather conditions, including precipitation details. ### get_forecasts Generates general weather outlooks for specific locations over an extended period. ### get_observations Pulls the absolute latest, real-time atmospheric data from measured sites (METAR/PWS). ### get_places Gathers basic geographical facts about a location, such as its time zone or population count. ## Prompt Examples **Prompt:** ``` What is the current weather in London? ``` **Response:** ``` I've retrieved the current conditions for London. It's currently 15°C with light rain and a humidity of 78%. Would you like the forecast for the rest of the day? ``` **Prompt:** ``` Show me the 7-day forecast for New York. ``` **Response:** ``` Fetching the 7-day forecast for New York... I see a mix of sun and clouds for the next few days, with temperatures peaking at 22°C on Wednesday. Should I check for any precipitation alerts? ``` **Prompt:** ``` Are there any active weather alerts for Miami? ``` **Response:** ``` Checking for active alerts in Miami... There is currently a 'Flood Watch' in effect until 8:00 PM. Would you like to see the full details of the advisory? ``` ## Capabilities ### Retrieve current weather observations Gets immediate, real-time conditions (METAR/PWS) for specific airports or cities. ### Predict future weather patterns Generates detailed forecasts spanning multiple days and can check minute-by-minute precipitation trends. ### Monitor official warnings Checks authoritative sources for active watches, advisories, and severe storm alerts in a given area. ### Get location details Pulls necessary geographical context like time zones, coordinates, or population size for any place name. ### Process diverse data streams efficiently Combines multiple weather requests (like forecasts and alerts) into a single API call to save cycles and speed up the process. ## Use Cases ### Checking a supply route before shipment A logistics manager needs to know if a cross-country truck route is safe. They ask their agent, which uses `get_alerts` and `get_forecasts`. The agent reports that while the current conditions are fine, there's a 'Flash Flood Watch' coming over the next 48 hours, forcing an immediate reroute. ### Comparing historical climate data A data analyst needs to write a report comparing seasonal average rainfall across three cities. They use `get_conditions` to pull historical precipitation records for the last five years and combine that with current coordinates gathered via `get_places`. ### Verifying airport readiness An air traffic controller needs immediate operational status at an airfield. They use `get_observations` to pull live METAR data for the specific airport ID, confirming visibility and wind speed instantly. ### Planning a large outdoor event The event planner asks their agent what the weather will be like over the next two weeks. The agent uses `get_forecasts` and warns that while today is clear, the chance of high winds increases dramatically mid-week. ## Benefits - Stop guessing the local time. Use `get_places` to pull exact timezone and coordinate information before you even ask about the weather, ensuring your query is anchored correctly. - You don't need multiple requests. Use `get_batch` to check alerts, current conditions, and a 7-day forecast all in one shot. It cuts out redundant API calls. - Need proof of what happened last month? The `get_conditions` tool handles historical data, giving you context beyond simple forecasts for deep analysis. - When coordinating field teams, rely on `get_alerts`. This tool monitors official sources like NWS and MeteoAlarm so you know about watches or advisories before they become problems. - Don't just assume the weather is fine. Use `get_observations` to get raw, measured METAR/PWS data—it's the ground truth for current conditions. ## How It Works The bottom line is that it lets your AI client access professional-grade weather context without you writing any code. 1. First, subscribe to this MCP on Vinkius and enter your AerisWeather Client ID and Secret. 2. Next, tell your AI client exactly what you need—for example: 'What's the weather forecast for New Orleans next week?' 3. The agent invokes the necessary tools (like `get_forecasts`) to pull data, formats the results, and gives you a clear answer in conversation. ## Frequently Asked Questions **How do I check the current weather observations using get_observations?** Use `get_observations` and provide a city or airport ID. This retrieves the most recent, measured METAR/PWS data available for that specific location. **What is the best way to query multiple weather types at once? Use get_batch?** Yep, `get_batch` is your tool. Instead of calling `get_forecasts`, then `get_alerts`, you list both in a single request for maximum efficiency. **Does AerisWeather help me with historical data?** Yes, the `get_conditions` tool supports pulling historical weather datasets, letting you run reports based on past conditions and precipitation records. **I need to know if there are active warnings. Which tool should I use? get_alerts?** `get_alerts` is the one. It checks official sources for current watches, advisories, and any severe weather warnings that might affect your area. **How do I get geographical data or time zone info using `get_places`?** The tool provides detailed place information for cities, stations, and airports. You can pull essential context like coordinates and time zones, which is crucial before running specific weather queries. **Does `get_conditions` support minute-by-minute precipitation forecasts?** Yes, you can get interpolated data for minutely precipitation forecasts. The tool supports this via a filter parameter and covers ranges up to 15 days out. **What kind of information do I get when I use `get_forecasts`?** You receive general weather predictions for specified locations. This output is useful for planning future events, unlike the real-time data provided by observations or alerts. **Is there a standard format required for location inputs across all tools?** No, the input format varies depending on what you need. For instance, `get_observations` accepts IDs like 'city,state', while `get_places` can handle names or station codes. **Can I get minute-by-minute precipitation forecasts?** Yes! Use the `get_conditions` tool with the `filter` parameter set to `minutelyprecip`. This provides high-resolution precipitation data for the immediate future. **How do I check for active weather warnings in a specific area?** Use the `get_alerts` tool and provide the location in the `p` parameter. It will return active watches, warnings, and advisories from official meteorological agencies. **Is it possible to search for cities or airports by name?** Yes! Use the `get_places` tool with the `action` set to `search` and your query. It returns geographical metadata, timezones, and coordinates.