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 — weather forecast / hourly forecast / current weather / temperature / precipitation / uv index / sunrise-sunset / open-meteo / weather api

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Weather forecast / hourly forecast / current weather / temperature / precipitation / UV index / sunrise-sunset / Open-Meteo / weather API. 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.

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.org/v1/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 once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the weather-forecast tool to ..."

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
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005
vin-decode	VIN decoder / VIN lookup / decode VIN / vehicle identification number / NHTSA vPIC wrapper.	$0.005
visa-requirements	Visa requirements lookup.	$0.005
weather	Weather API / weather forecast / current weather / hourly forecast.	$0.005
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
country-info	Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002

/weather-forecast(1)