{"uid":"cap_NjAwT2pn5QdmxJpAgAH2F","slug":"agentutility-weather-by-city-name-493bf4de","name":"AgentUtility Weather by City Name","description":"Returns current weather for any city or place name, no coordinates needed. Geocodes the name with Open-Meteo, chooses the best match with optional country_code, then returns current temperature, feels-like, humidity, wind, precipitation, WMO weather code, timezone, and optional daily/hourly forecast from Open-Meteo. Use it as a city weather API or instant weather lookup by place name.","url":"https://x402.agentutility.ai/weather-current-city","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["city"],"properties":{"city":{"type":"string","description":"City or place name, e.g. 'Paris', 'San Francisco', or 'Springfield'."},"query":{"type":"string","description":"Alias for city."},"units":{"enum":["metric","imperial"],"type":"string","description":"Metric or imperial output units. Default metric."},"hourly":{"type":"boolean","description":"If true, include hourly temperature, precipitation, and weather code arrays."},"country_code":{"type":"string","description":"Optional two-letter ISO country code to disambiguate, e.g. 'US', 'FR', 'JP'."},"forecast_days":{"type":"number","description":"Daily forecast days to include, 1-7. Default 1."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"object","properties":{"forecast":{"type":"string"},"geocoding":{"type":"string"}}},"current":{"type":"object","properties":{"wind_speed":{"type":"integer"},"temperature":{"type":"integer"},"humidity_pct":{"type":"integer"},"weather_code":{"type":"integer"},"apparent_temperature":{"type":"integer"}}},"resolved_location":{"type":"object","properties":{"name":{"type":"string"},"admin1":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"country_code":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"query":"San Francisco","source":{"forecast":"https://open-meteo.com","geocoding":"https://open-meteo.com/en/docs/geocoding-api"},"current":{"wind_speed":9,"temperature":62,"humidity_pct":78,"weather_code":3,"apparent_temperature":60},"resolved_location":{"name":"San Francisco","admin1":"California","latitude":37.7749,"longitude":-122.4194,"country_code":"US"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RLYJHqa1F_Eoy3coNzl1b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current weather conditions and optional forecasts for any city or place name by geocoding it automatically via Open-Meteo.","exampleAgentPrompt":"What's the current weather in Tokyo, Japan? Give me the temperature in Celsius, humidity, wind speed, and include a 3-day forecast.","exampleUseCases":[{"title":"Travel packing decision helper","prompt":"What's the current weather in Amsterdam, Netherlands right now — temperature, feels-like, and whether it's raining? Use metric units."},{"title":"Daily morning briefing automation","prompt":"Pull today's weather for Chicago, US in imperial units — I need temperature, humidity, wind speed, and a 5-day daily forecast for my morning summary."},{"title":"Remote team location awareness","prompt":"What's the weather like right now in Bangalore, India? Give me temperature, humidity, and the WMO weather code so I know if it's clear or stormy."}],"resultDescription":"A JSON object containing the resolved location (name, admin region, latitude, longitude, country code), current conditions (temperature, apparent temperature, humidity percentage, wind speed, WMO weather code), and optionally arrays of daily or hourly forecast data. Also includes source attribution URLs for geocoding and forecast data.","failureModes":["City name not recognized or too ambiguous — returns no match or wrong location without country_code disambiguation","Multiple cities share the same name and no country_code provided — may return wrong city","Open-Meteo geocoding API unavailable — upstream failure","Invalid country_code format — may cause geocoding failure","forecast_days out of 1-7 range — may return error or clamped result","Network timeout from Open-Meteo backend — propagated as server error"],"whenToPreferThis":"Prefer this endpoint when you need current weather by city or place name without knowing coordinates, especially when coordinate geocoding is inconvenient. It wraps Open-Meteo's geocoding and forecast APIs into a single call and returns a rich set of current conditions plus optional forecasts. Choose this over raw Open-Meteo if you want a simple city-name-in, weather-out interface with USDC micropayment settlement via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:18:24.446Z","isFirstParty":false}