# weatherai

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/weatherai-io/mcp-server  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/weatherai

## Description
WeatherAI — 11 live weather tools for Claude, Cursor, Windsurf and any MCP AI assistant

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "weatherai": {
    "command": "npx",
    "args": ["-y","weatherai"]
  }
}
```

## Documentation & README

# WeatherAI MCP Server

[![MCP Spec](https://img.shields.io/badge/MCP-2025--03--26-blue)](https://modelcontextprotocol.io)
[![Tools](https://img.shields.io/badge/tools-11-brightgreen)](#available-tools)
[![Free Tier](https://img.shields.io/badge/free%20tier-1%2C000%20calls%2Fday-orange)](https://weatherai.io/pricing)
[![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)

> **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](https://modelcontextprotocol.io) 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](https://weatherai.io/register) — no credit card required.

### 2. Add to your AI client

Replace `YOUR_API_KEY` with the key from your [dashboard](https://weatherai.io/dashboard/keys).

#### Claude Desktop

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

```json
{
  "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`:

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

#### Windsurf

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

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

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

```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](https://weatherai.io/dashboard/billing). 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`](https://weatherai.io/.well-known/mcp.json) |
| LLM context | [`/llms.txt`](https://weatherai.io/llms.txt) |
| OpenAPI spec | [`/openapi.yaml`](https://weatherai.io/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:

```bash
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](https://weatherai.io)
- **MCP docs:** [weatherai.io/mcp](https://weatherai.io/mcp)
- **API docs:** [weatherai.io/docs](https://weatherai.io/docs)
- **Pricing:** [weatherai.io/pricing](https://weatherai.io/pricing)
- **Register:** [weatherai.io/register](https://weatherai.io/register)

---

## License

MIT — see [LICENSE](https://github.com/weatherai-io/mcp-server/blob/HEAD/LICENSE).

Built by [Zoomash Ltd](https://weatherai.io), England (Company No. 7838145).