Name: city-weather
Price: 0.01 USDC
Availability: InStock

$ man city-weather

agentutility / locale / city-weather

PRICE / CALL

$0.01

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

city-weather — returns current weather by city name with an instant geocoded lookup

synonym alias of weather-current-city — reuses the canonical handler.

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Returns current weather by city name with an instant geocoded lookup. Same Open-Meteo geocoding plus forecast backend as weather-current-city, exposed under concise buyer wording. Use it as a city weather API or instant weather lookup.

INPUT — request schema

property	type	description	req?
city	string	City or place name.	required
country_code	string	Optional two-letter ISO country code.	optional
units	string	— enum: metric · imperial	optional
forecast_days	number	—	optional
hourly	boolean	—	optional

OUTPUT — response shape

field	type	description
query	string	—
resolved_location	string	—
current	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/city-weather \
  -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 city-weather tool from your MCP-aware agent.

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

METADATA

tags: localecityweathercity-weather
methods: POST
cluster: locale
price: $0.01 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
current	Instant current weather by city name: geocodes a city or place name, then returns current Open-Meteo temperature, feels-like, humidity, w…	$0.01
current-weather-city	Current weather city lookup / city-name weather conditions.	$0.01
flight-status	Tracks live aircraft positions from the OpenSky Network.	$0.01
property-tax	Property tax lookup.	$0.01
property-tax-assessment	Searches county assessor records by address or parcel ID for owner, assessed value, and property details.	$0.01
satellite-address	Turns a street address into a cloud-free satellite image in one call.	$0.01
sports-schedule	Returns upcoming games and recent results for major sports leagues: MLB, NBA, NHL, NFL, WNBA, MLS, EPL, La Liga, Bundesliga, and Serie A.	$0.01
weather-current-city	Returns current weather for any city or place name, no coordinates needed.	$0.01