WeatherAI MCP Server

11 live weather tools for your AI assistant — one URL, no setup.

The WeatherAI MCP server gives Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI assistant instant access to real-time weather, forecasts, historical data, air quality, astronomy, solar irradiance, and a plain-English AI weather interface.

Hosted endpoint: https://api.weatherai.io/mcp Transport: Streamable HTTP (stateless, MCP spec 2025-03-26) Auth: API key via query param, header, or Bearer token Free tier: 1,000 standard calls/day · 50 premium calls/day

Quick Start

1. Get a free API key

Sign up at weatherai.io — no credit card required.

2. Add to your AI client

Replace YOUR_API_KEY with the key from your dashboard.

#### Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Restart Claude Desktop after saving.

#### Cursor

Go to Cursor → Settings → MCP or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

#### Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http"
    }
  }
}

#### Any other MCP client (generic mcp.json)

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http",
      "transport": "streamable-http"
    }
  }
}

3. Start asking weather questions

"What's the weather like in Tokyo right now?"
"Will it rain in London this weekend?"
"What were temperatures in Paris on 14 July 2023?"
"What's the air quality like in Beijing?"
"When does the sun set in Dubai today?"

Available Tools

All 11 tools are registered automatically — no configuration needed.

Tool Details

#### get_current_weather Returns temperature, feels-like, humidity, wind speed/direction, UV index, visibility, pressure, and cloud cover.

location  (required) City name, US zip, UK postcode, lat/lon, or IP address
units     (optional) "metric" | "imperial" — default: metric

#### get_weather_forecast Daily high/low and hourly breakdown for up to 14 days including precipitation chance and UV index.

location  (required) City name, zip/postcode, coordinates, or IP address
days      (optional) 1–14 — default: 3
units     (optional) "metric" | "imperial" — default: metric

#### get_historical_weather Hour-by-hour actual recorded weather for any past date.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (required) YYYY-MM-DD format — must be a past date
units     (optional) "metric" | "imperial" — default: metric

#### get_future_weather AI-enhanced extended forecast from 14 to 300 days into the future. Costs 2 premium credits per request.

location    (required) City name, zip/postcode, coordinates, or IP address
start_date  (required) YYYY-MM-DD — 14–300 days from today
end_date    (optional) YYYY-MM-DD — max 30 days per request
units       (optional) "metric" | "imperial" — default: metric

#### get_air_quality Real-time AQI index plus individual pollutant readings (PM2.5, PM10, CO, NO2, SO2, O3).

location  (required) City name, zip/postcode, coordinates, or IP address

#### get_weather_alerts Active government-issued storm, flood, heat, and other weather warnings.

location  (required) City name, zip/postcode, coordinates, or IP address

#### get_astronomy Sunrise, sunset, moonrise, moonset, moon phase name, and illumination percentage.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today

#### get_solar_data Solar irradiance (W/m²) and estimated daily energy generation (kWh/m²).

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today
units     (optional) "metric" | "imperial" — default: metric

#### get_timezone IANA timezone name, UTC offset (hours), current local time, and DST active flag.

location  (required) City name, zip/postcode, coordinates, or IP address

#### search_locations Returns up to 10 matching places with name, region, country, and coordinates.

query  (required) Partial or full city/location name

#### ask_ai_weather ⭐ Ask any weather question in plain English. The AI interprets the intent, calls the relevant tools, and returns a natural-language answer plus the underlying JSON data. Costs 2 premium credits per request.

question  (required) e.g. "Will it be good weather for hiking in the Lake District next weekend?"

Authentication

Three methods are supported — all equivalent:

Query parameter is recommended for client config files. Use headers for programmatic access.

Pricing

Credits are prepaid — top up from your dashboard. No subscription required.

Standard tools: get_current_weather, get_weather_forecast, get_air_quality, get_weather_alerts, get_astronomy, get_timezone, search_locations

Premium tools: get_historical_weather, get_future_weather, get_solar_data, ask_ai_weather

Machine-Readable Discovery

Source Code

This repository contains the MCP server implementation. The server runs as part of the WeatherAI.io platform at https://api.weatherai.io/mcp.

src/index.ts is a self-contained adaptation that can also be run standalone:

npm install
WEATHERAI_API_KEY=your_key npm start

The standalone server listens on PORT (default 3000) and exposes the same /mcp endpoint.

Links

• Website: weatherai.io
• MCP docs: weatherai.io/mcp
• API docs: weatherai.io/docs
• Pricing: weatherai.io/pricing
• Register: weatherai.io/register

License

MIT — see LICENSE.

Built by Zoomash Ltd, England (Company No. 7838145).