io.github.weatherai-io/weatherai

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).