# WeatherAI.io MCP Server

WeatherAI.io gives Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI assistant instant access to global weather intelligence through 11 native tools. Connect with a single URL — no local se…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add support-weatherai/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list support-weatherai/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get support-weatherai/mcp-server get_current_weather

# Call a tool
npx -y @smithery/cli@latest tool call support-weatherai/mcp-server get_current_weather '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--support-weatherai.run.tools`

**Required config:**
- `apiKey` (query) — Get a free API key at https://weatherai.io/register — add it as ?apiKey=YOUR_KEY to the URL

## Tools (11)

- `get_current_weather` — Get real-time current weather conditions for any location. Returns temperature, feels-like, humidity, wind, UV index, v…
- `get_weather_forecast` — Get a weather forecast for up to 14 days including daily summaries, hourly data, rain chance, and UV index.
- `get_historical_weather` — Retrieve historical weather data for any past date. Useful for event planning retrospectives, insurance claims, and cli…
- `get_future_weather` — Get future weather predictions from 14 to 300 days ahead. Premium endpoint — costs 2 credits per request.
- `get_air_quality` — Get real-time air quality data including AQI, PM2.5, PM10, CO, NO2, SO2, and O3 for any location.
- `get_weather_alerts` — Get active weather warnings and alerts for a location (storms, floods, heat waves, etc.).
- `get_astronomy` — Get sunrise, sunset, moonrise, moonset, moon phase, and moon illumination for a location and date.
- `get_solar_data` — Get solar irradiance and energy generation data for a location and date. Useful for solar panel planning and energy for…
- `get_timezone` — Get timezone information for any location, including UTC offset, local time, and DST status.
- `search_locations` — Search for locations matching a query string. Returns up to 10 matching places with coordinates and country info.
- `ask_ai_weather` — Ask a free-text weather question in plain English. AI interprets your query, fetches the relevant data, and returns a n…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get support-weatherai/mcp-server <tool-name>
```
