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	Tier	Description	Key Parameters
get_current_weather	Standard	Real-time conditions for any location	location, units
get_weather_forecast	Standard	Daily & hourly forecast up to 14 days	location, days (1–14), units
get_historical_weather	Premium	Actual past weather for any date	location, date (YYYY-MM-DD), units
get_future_weather	Premium	Predictions 14–300 days ahead	location, start_date, end_date, units
get_air_quality	Standard	AQI, PM2.5, PM10, CO, NO2, SO2, O3	location
get_weather_alerts	Standard	Active government weather warnings	location
get_astronomy	Standard	Sunrise, sunset, moon phase & illumination	location, date
get_solar_data	Premium	Solar irradiance & energy estimates	location, date, units
get_timezone	Standard	UTC offset, local time, DST status	location
search_locations	Standard	Find cities/places by partial name	query
ask_ai_weather	Premium	Plain-English weather questions via Claude AI	question

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:

Method	Example
Query parameter	https://api.weatherai.io/mcp?apiKey=YOUR_KEY
X-API-Key header	X-API-Key: YOUR_KEY
Bearer token	Authorization: Bearer YOUR_KEY

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

---

Pricing

Tier	Free Allowance	Overage
Standard tools	1,000 calls/day	$0.0005 / call
Premium tools	50 calls/day	$0.001 / call

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

File	URL
MCP manifest	/.well-known/mcp.json
LLM context	/llms.txt
OpenAPI spec	/openapi.yaml

---

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