{
  "markdown": "# WeatherAI MCP Server\n\n[![MCP Spec](https://img.shields.io/badge/MCP-2025--03--26-blue)](https://modelcontextprotocol.io)\n[![Tools](https://img.shields.io/badge/tools-11-brightgreen)](#available-tools)\n[![Free Tier](https://img.shields.io/badge/free%20tier-1%2C000%20calls%2Fday-orange)](https://weatherai.io/pricing)\n[![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)\n\n> **11 live weather tools for your AI assistant — one URL, no setup.**\n\nThe 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.\n\n**Hosted endpoint:** `https://api.weatherai.io/mcp`  \n**Transport:** Streamable HTTP (stateless, MCP spec 2025-03-26)  \n**Auth:** API key via query param, header, or Bearer token  \n**Free tier:** 1,000 standard calls/day · 50 premium calls/day\n\n---\n\n## Quick Start\n\n### 1. Get a free API key\n\n[Sign up at weatherai.io](https://weatherai.io/register) — no credit card required.\n\n### 2. Add to your AI client\n\nReplace `YOUR_API_KEY` with the key from your [dashboard](https://weatherai.io/dashboard/keys).\n\n#### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or  \n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"weatherai\": {\n      \"url\": \"https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n#### Cursor\n\nGo to **Cursor → Settings → MCP** or edit `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"weatherai\": {\n      \"url\": \"https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY\"\n    }\n  }\n}\n```\n\n#### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"weatherai\": {\n      \"url\": \"https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY\",\n      \"type\": \"http\"\n    }\n  }\n}\n```\n\n#### Any other MCP client (generic `mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"weatherai\": {\n      \"url\": \"https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY\",\n      \"type\": \"http\",\n      \"transport\": \"streamable-http\"\n    }\n  }\n}\n```\n\n### 3. Start asking weather questions\n\n```\n\"What's the weather like in Tokyo right now?\"\n\"Will it rain in London this weekend?\"\n\"What were temperatures in Paris on 14 July 2023?\"\n\"What's the air quality like in Beijing?\"\n\"When does the sun set in Dubai today?\"\n```\n\n---\n\n## Available Tools\n\nAll 11 tools are registered automatically — no configuration needed.\n\n| Tool | Tier | Description | Key Parameters |\n|------|------|-------------|----------------|\n| `get_current_weather` | Standard | Real-time conditions for any location | `location`, `units` |\n| `get_weather_forecast` | Standard | Daily & hourly forecast up to 14 days | `location`, `days` (1–14), `units` |\n| `get_historical_weather` | Premium | Actual past weather for any date | `location`, `date` (YYYY-MM-DD), `units` |\n| `get_future_weather` | Premium | Predictions 14–300 days ahead | `location`, `start_date`, `end_date`, `units` |\n| `get_air_quality` | Standard | AQI, PM2.5, PM10, CO, NO2, SO2, O3 | `location` |\n| `get_weather_alerts` | Standard | Active government weather warnings | `location` |\n| `get_astronomy` | Standard | Sunrise, sunset, moon phase & illumination | `location`, `date` |\n| `get_solar_data` | Premium | Solar irradiance & energy estimates | `location`, `date`, `units` |\n| `get_timezone` | Standard | UTC offset, local time, DST status | `location` |\n| `search_locations` | Standard | Find cities/places by partial name | `query` |\n| `ask_ai_weather` | Premium | Plain-English weather questions via Claude AI | `question` |\n\n### Tool Details\n\n#### `get_current_weather`\nReturns temperature, feels-like, humidity, wind speed/direction, UV index, visibility, pressure, and cloud cover.\n\n```\nlocation  (required) City name, US zip, UK postcode, lat/lon, or IP address\nunits     (optional) \"metric\" | \"imperial\" — default: metric\n```\n\n#### `get_weather_forecast`\nDaily high/low and hourly breakdown for up to 14 days including precipitation chance and UV index.\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\ndays      (optional) 1–14 — default: 3\nunits     (optional) \"metric\" | \"imperial\" — default: metric\n```\n\n#### `get_historical_weather`\nHour-by-hour actual recorded weather for any past date.\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\ndate      (required) YYYY-MM-DD format — must be a past date\nunits     (optional) \"metric\" | \"imperial\" — default: metric\n```\n\n#### `get_future_weather`\nAI-enhanced extended forecast from 14 to 300 days into the future. Costs **2 premium credits** per request.\n\n```\nlocation    (required) City name, zip/postcode, coordinates, or IP address\nstart_date  (required) YYYY-MM-DD — 14–300 days from today\nend_date    (optional) YYYY-MM-DD — max 30 days per request\nunits       (optional) \"metric\" | \"imperial\" — default: metric\n```\n\n#### `get_air_quality`\nReal-time AQI index plus individual pollutant readings (PM2.5, PM10, CO, NO2, SO2, O3).\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\n```\n\n#### `get_weather_alerts`\nActive government-issued storm, flood, heat, and other weather warnings.\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\n```\n\n#### `get_astronomy`\nSunrise, sunset, moonrise, moonset, moon phase name, and illumination percentage.\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\ndate      (optional) YYYY-MM-DD — defaults to today\n```\n\n#### `get_solar_data`\nSolar irradiance (W/m²) and estimated daily energy generation (kWh/m²).\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\ndate      (optional) YYYY-MM-DD — defaults to today\nunits     (optional) \"metric\" | \"imperial\" — default: metric\n```\n\n#### `get_timezone`\nIANA timezone name, UTC offset (hours), current local time, and DST active flag.\n\n```\nlocation  (required) City name, zip/postcode, coordinates, or IP address\n```\n\n#### `search_locations`\nReturns up to 10 matching places with name, region, country, and coordinates.\n\n```\nquery  (required) Partial or full city/location name\n```\n\n#### `ask_ai_weather` ⭐\nAsk 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.\n\n```\nquestion  (required) e.g. \"Will it be good weather for hiking in the Lake District next weekend?\"\n```\n\n---\n\n## Authentication\n\nThree methods are supported — all equivalent:\n\n| Method | Example |\n|--------|---------|\n| Query parameter | `https://api.weatherai.io/mcp?apiKey=YOUR_KEY` |\n| `X-API-Key` header | `X-API-Key: YOUR_KEY` |\n| Bearer token | `Authorization: Bearer YOUR_KEY` |\n\nQuery parameter is recommended for client config files. Use headers for programmatic access.\n\n---\n\n## Pricing\n\n| Tier | Free Allowance | Overage |\n|------|----------------|---------|\n| Standard tools | 1,000 calls/day | $0.0005 / call |\n| Premium tools | 50 calls/day | $0.001 / call |\n\nCredits are prepaid — [top up from your dashboard](https://weatherai.io/dashboard/billing). No subscription required.\n\nStandard tools: `get_current_weather`, `get_weather_forecast`, `get_air_quality`, `get_weather_alerts`, `get_astronomy`, `get_timezone`, `search_locations`\n\nPremium tools: `get_historical_weather`, `get_future_weather`, `get_solar_data`, `ask_ai_weather`\n\n---\n\n## Machine-Readable Discovery\n\n| File | URL |\n|------|-----|\n| MCP manifest | [`/.well-known/mcp.json`](https://weatherai.io/.well-known/mcp.json) |\n| LLM context | [`/llms.txt`](https://weatherai.io/llms.txt) |\n| OpenAPI spec | [`/openapi.yaml`](https://weatherai.io/openapi.yaml) |\n\n---\n\n## Source Code\n\nThis repository contains the MCP server implementation. The server runs as part of the WeatherAI.io platform at `https://api.weatherai.io/mcp`.\n\n`src/index.ts` is a self-contained adaptation that can also be run standalone:\n\n```bash\nnpm install\nWEATHERAI_API_KEY=your_key npm start\n```\n\nThe standalone server listens on `PORT` (default 3000) and exposes the same `/mcp` endpoint.\n\n---\n\n## Links\n\n- **Website:** [weatherai.io](https://weatherai.io)\n- **MCP docs:** [weatherai.io/mcp](https://weatherai.io/mcp)\n- **API docs:** [weatherai.io/docs](https://weatherai.io/docs)\n- **Pricing:** [weatherai.io/pricing](https://weatherai.io/pricing)\n- **Register:** [weatherai.io/register](https://weatherai.io/register)\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nBuilt by [Zoomash Ltd](https://weatherai.io), England (Company No. 7838145).\n",
  "bytes": 8752,
  "sha": "24cd983ebf8c29186070f4e7dd40c9660371edffcc2ac390deeff33f01221afe",
  "repo_slug": "weatherai-io/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_weatherai_io_weatherai_58eb0a06/readme"
}