# WeatherAI.io

> WeatherAI.io is an AI-powered weather intelligence API platform by Zoomash Ltd. It gives developers and AI assistants access to real-time weather, forecasts, historical data, air quality, astronomy, solar data, and more — enhanced with machine-learning accuracy improvements and a plain-English AI query interface.

WeatherAI.io offers a REST API with 11 endpoints, an MCP (Model Context Protocol) server for direct AI assistant integration, and a developer dashboard for API key management, usage tracking, and billing. 1,000 free standard calls per day; pay-as-you-go credits for premium and overage usage.

## Getting started

- [API Documentation](https://weatherai.io/docs): Full reference for all 11 endpoints, parameters, and response fields.
- [MCP Server](https://weatherai.io/mcp): Connect Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI assistant to all 11 weather tools using a single URL.
- [Pricing](https://weatherai.io/pricing): Free tier (1,000 standard calls/day, 50 premium calls/day) plus pay-as-you-go credits.
- [Register](https://weatherai.io/register): Create a free account and generate an API key.
- [OpenAPI Spec](https://weatherai.io/openapi.yaml): Machine-readable OpenAPI 3.0 specification for all endpoints.

## API endpoints

All endpoints are prefixed with `https://api.weatherai.io/v1/`. Authentication via `X-API-Key` header, `?apiKey=` query param, or `Authorization: Bearer <key>`.

- [Current Weather](https://weatherai.io/apis/current-weather): `GET /v1/current` — Real-time conditions for any location. Returns temperature, humidity, wind, UV index, visibility, pressure, and cloud cover.
- [Weather Forecast](https://weatherai.io/apis/weather-forecast): `GET /v1/forecast` — Daily and hourly forecast up to 14 days. Includes rain chance, UV index, sunrise/sunset.
- [Historical Weather](https://weatherai.io/apis/historical-weather): `GET /v1/history` — Actual past weather for any date. Requires `dt` parameter in YYYY-MM-DD format.
- [Future Weather](https://weatherai.io/apis/future-weather): `GET /v1/future` — Predictions 14–300 days ahead. Requires `dt` start date; optional `end_dt`.
- [Air Quality](https://weatherai.io/apis/air-quality): `GET /v1/airquality` — AQI, PM2.5, PM10, CO, NO2, SO2, and O3.
- [Weather Alerts](https://weatherai.io/apis/weather-alerts): `GET /v1/alerts` — Active government-issued warnings and advisories.
- [Astronomy](https://weatherai.io/apis/astronomy): `GET /v1/astronomy` — Sunrise, sunset, moonrise, moonset, moon phase, and illumination.
- [Solar Data](https://weatherai.io/apis/solar-data): `GET /v1/solar` — Solar irradiance and estimated energy generation.
- [Timezone](https://weatherai.io/apis/timezone): `GET /v1/timezone` — UTC offset, local time, and DST status.
- [Location Search](https://weatherai.io/apis/location-search): `GET /v1/search` — Find matching cities and places by partial name.
- [AI Weather Query](https://weatherai.io/apis/ai-weather): `POST /v1/ai` — Ask a plain-English weather question; returns a natural-language answer plus raw JSON data.

## MCP server

WeatherAI.io hosts a Model Context Protocol (MCP) server at `https://api.weatherai.io/mcp`. It exposes all 11 endpoints as native AI tools with no configuration beyond pointing your client at the URL.

Transport: Streamable HTTP (stateless, MCP spec 2025-03-26).
Authentication: `?apiKey=YOUR_API_KEY` query param, `X-API-Key` header, or `Authorization: Bearer` header.
Discovery: `https://weatherai.io/.well-known/mcp.json`

MCP tools available: `get_current_weather`, `get_weather_forecast`, `get_historical_weather`, `get_future_weather`, `get_air_quality`, `get_weather_alerts`, `get_astronomy`, `get_solar_data`, `get_timezone`, `search_locations`, `ask_ai_weather`.

## Company

Zoomash Ltd, registered in England and Wales (Company No. 7838145). VAT No. 123233754.
Contact: [Contact form](https://weatherai.io/contact).