Name: weather-forecast
Price: 0.005 USDC
Availability: InStock

$ man weather-forecast

agentutility / locale / weather-forecast

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

weather-forecast — returns current conditions, a 1-7 day daily forecast, and an optional hourly forecast for any latitude/longitude

SYNOPSIS

POST https://x402.agentutility.ai/weather-forecast
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Returns current conditions, a 1-7 day daily forecast, and an optional hourly forecast for any latitude/longitude. Daily includes temp max/min, precipitation total + probability, sunrise/sunset, max UV index, and WMO weather code. Current includes temperature, apparent temperature, humidity %, wind speed/direction, precipitation, weather code, and is_day. Metric or imperial units. Wraps the public Open-Meteo API, no auth, commercial-OK, CC-BY 4.0. Use it as a weather forecast API, hourly forecast, current weather, temperature, or UV index and sunrise-sunset lookup.

INPUT — request schema

property	type	description	req?
latitude	number	Decimal degrees, range [-90, 90]. Positive north.	required
longitude	number	Decimal degrees, range [-180, 180]. Positive east.	required
units	string	'metric' (°C, km/h, mm) or 'imperial' (°F, mph, inch). Default 'metric'. enum: metric · imperial	optional
forecast_days	number	Number of forecast days, 1-7. Default 3.	optional
hourly	boolean	If true, include hourly temperature, precipitation, and weather code arrays. Default false.	optional

OUTPUT — response shape

field	type	description
location	string	Latitude/longitude pair (and resolved timezone) the forecast was generated for.
current	string	Current conditions block: temperature, apparent temp, humidity, wind, precipitation, weather code, is_day.
daily	string	1-7 day daily forecast: temp max/min, precipitation total + probability, sunrise/sunset, max UV, WMO code.
units	string	Unit system applied to the response, either metric (°C, mm, km/h) or imperial (°F, in, mph).
source	string	Upstream data provider, Open-Meteo (CC-BY 4.0, commercial-OK, no auth).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/weather-forecast \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the weather-forecast tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: weatherforecastweather-forecasthourly-forecastopen-meteouv-indexprecipitationlocale
methods: POST
cluster: locale
price: $0.005 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
air-quality	Returns current air quality readings and AQI category for any latitude/longitude, with optional hourly forecast rows for the next 1-72 hours.	$0.005
airport-code-lookup	Resolves airport codes to airport name, municipality, country, region, coordinates, elevation, scheduled-service flag, homepage, and Wiki…	$0.005
astro-times	Sunrise sunset times.	$0.005
climate-data	Returns historical daily temperature, precipitation, humidity, wind, and solar radiation for any latitude/longitude.	$0.005
country-info	Country info lookup.	$0.005
current-weather	Looks up current weather conditions for a latitude/longitude: temperature, humidity, precipitation, wind, and WMO condition code.	$0.005
holiday-lookup	Holiday calendar.	$0.005
iata-airport-info	Looks up airport metadata from an IATA or ICAO code.	$0.005