Weather forecast and current conditions
weather.forecastWeather data from a global weather data provider — current conditions, short-range forecast, astronomy, historical, marine, and location search. Free, read-only, no wallet needed. Every action requires q, a location: a city name (e.g. "Paris"), "lat,lon" (e.g. "48.85,2.35"), a US/UK/Canadian postal code, or an IATA airport code. Pick one action:
current: current conditions for
q. Optionalaqi(default false) adds basic air quality data.forecast: forecast for
q. Optionaldays— this deployment runs on a data plan capped at 3 days, so only 1-3 is accepted; omit for the provider default. Optionalaqi,alerts(default false, adds active weather alerts for the location where available).astronomy: sunrise/sunset/moonrise/moonset/moon phase for
qondate(required, YYYY-MM-DD).search: resolve a fuzzy
qinto matching locations (name, region, country, lat/lon) — use this first if you only have an approximate place name and need to disambiguate.history: past weather for
qondate(required, YYYY-MM-DD, must be yesterday). This deployment enforces a free-tier data plan that only allows yesterday's date — any other date is rejected before a provider call is made.marine: marine/sailing conditions for
q. This deployment runs on a data plan limited to 1 day of data with no tide information.
Results are for general informational purposes only — do not use them as the sole basis for decisions involving personal safety, aviation, marine navigation, or emergency planning.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Location: city name, "lat,lon", postal code, or airport code. Required for every action. | |
| aqi | No | current / forecast / history: include basic air quality data (default false). | |
| date | No | astronomy / history: date in YYYY-MM-DD format. Required for both. | |
| days | No | forecast: number of forecast days (1-3 on this deployment's plan). Omit for the provider default. | |
| action | Yes | Which weather operation to perform. | |
| alerts | No | forecast: include active weather alerts for the location (default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| message | No |