The Weather Channel API: Get current weather
Gets current conditions and today's high and low from The Weather Channel for a city, postcode, ZIP code or street address worldwide. Street addresses are geocoded exactly first; some observations omit gusts or other measurements.
Unofficial. Not affiliated with or endorsed by The Weather Channel.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Units optional
units Measurement units, for example metric; defaults to imperial.
imperial
One of
imperial,metric. Defaultimperial.- Location, required
location City, street address, ZIP code or postcode, for example Chicago or SW1A 1AA.
1600 Pennsylvania Ave NW, Washington, DC
Input as JSON
{ "units": "imperial", "location": "1600 Pennsylvania Ave NW, Washington, DC"}Output
{ "place": "White House, 1600, Pennsylvania Avenue Northwest, Ward 2, Washington, District of Columbia, 20500, United States", "sunset": "2026-09-28T18:55:25-04:00", "sunrise": "2026-09-28T07:01:25-04:00", "humidity": { "unit": "%", "value": 72 }, "latitude": 38.8976387, "pressure": { "unit": "inHg", "value": 29.95 }, "uv_index": { "unit": "index", "value": 0 }, "uv_level": "Low", "dew_point": { "unit": "°F", "value": 59 }, "longitude": -77.0365525, "today_low": { "unit": "°F", "value": 61 }, "wind_gust": { "unit": "mph", "value": null }, "conditions": "Cloudy", "feels_like": { "unit": "°F", "value": 68 }, "moon_phase": "Waning Gibbous", "today_high": { "unit": "°F", "value": 71 }, "visibility": { "unit": "mi", "value": 10 }, "wind_speed": { "unit": "mph", "value": 6 }, "temperature": { "unit": "°F", "value": 68 }, "wind_direction": "North-northwest", "observation_time": "2026-09-28T20:21:47-04:00", "weather_com_link": "https://weather.com/weather/today/l/38.8976387,-77.0365525" , "weather_com_location_key": "7dc1d1f0f971fb2f1015d2619d4cb577636a50fef8affa579c521a0d38d87b35"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"weather.com/get_current_weather","input":{"units":"imperial","location":"1600 Pennsylvania Ave NW, Washington, DC"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "weather.com/get_current_weather" , "input": { "units": "imperial", "location": "1600 Pennsylvania Ave NW, Washington, DC" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "weather.com/get_current_weather" , "input": { "units": "imperial", "location": "1600 Pennsylvania Ave NW, Washington, DC" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run weather.com/get_current_weather# with {"units":"imperial","location":"1600 Pennsylvania Ave NW, Washington, DC"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "location" ], "properties": { "units": { "enum": [ "imperial", "metric" ], "type": "string", "default": "imperial", "description": "Measurement units, for example metric; defaults to imperial." }, "location": { "type": "string", "minLength": 1, "description": "City, street address, ZIP code or postcode, for example Chicago or SW1A 1AA." } }}Output schema
{ "type": "object", "required": [ "place", "observation_time", "conditions", "wind_direction", "uv_level", "moon_phase", "sunrise", "sunset", "weather_com_link", "weather_com_location_key", "latitude", "longitude", "temperature", "feels_like", "today_high", "today_low", "humidity", "wind_speed", "wind_gust", "uv_index", "visibility", "pressure", "dew_point" ], "properties": { "place": { "type": "string", "description": "Matched place name and region." }, "sunset": { "type": [ "string", "null" ], "description": "Local sunset time in ISO 8601 with UTC offset." }, "sunrise": { "type": [ "string", "null" ], "description": "Local sunrise time in ISO 8601 with UTC offset." }, "humidity": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Relative humidity with an explicit measurement unit.", "additionalProperties": false }, "latitude": { "type": "number", "description": "Matched latitude." }, "pressure": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Barometric pressure with an explicit measurement unit.", "additionalProperties": false }, "uv_index": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Current UV index with an explicit measurement unit.", "additionalProperties": false }, "uv_level": { "type": [ "string", "null" ], "description": "UV level in words." }, "dew_point": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Dew point with an explicit measurement unit.", "additionalProperties": false }, "longitude": { "type": "number", "description": "Matched longitude." }, "today_low": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Today's forecast low with an explicit measurement unit.", "additionalProperties": false }, "wind_gust": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Wind gust speed with an explicit measurement unit.", "additionalProperties": false }, "conditions": { "type": [ "string", "null" ], "description": "Current weather conditions in words." }, "feels_like": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Feels-like temperature with an explicit measurement unit.", "additionalProperties": false }, "moon_phase": { "type": [ "string", "null" ], "description": "Moon phase in words." }, "today_high": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Today's forecast high with an explicit measurement unit.", "additionalProperties": false }, "visibility": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Visibility with an explicit measurement unit.", "additionalProperties": false }, "wind_speed": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Wind speed with an explicit measurement unit.", "additionalProperties": false }, "temperature": { "type": "object", "required": [ "value", "unit" ], "properties": { "unit": { "type": "string" }, "value": { "type": [ "number", "null" ] } }, "description": "Air temperature with an explicit measurement unit.", "additionalProperties": false }, "wind_direction": { "type": [ "string", "null" ], "description": "Compass direction in words." }, "observation_time": { "type": [ "string", "null" ], "description": "Local observation time in ISO 8601 with UTC offset." }, "weather_com_link": { "type": "string", "description": "Weather page for the matched location." }, "weather_com_location_key": { "type": [ "string", "null" ], "description": "The Weather Channel place identifier." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
weather.com/get_current_weather- Returns
- conditions, temperature, feels like, today's high and low, humidity, wind, UV, visibility, pressure, dew point, sunrise, sunset, moon phase
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method weather.com/get_current_weather with the inputs above.
Ask your agent
- What's the weather like right now in Chicago? Need temperature, feels like, and wind.
- Check weather.com for current conditions at SW1A 1AA in metric units, including today's high and low.
- Is it humid in Miami at the moment? Also tell me the UV index and when sunset is.
- Current temperature and pressure at 1600 Pennsylvania Avenue NW, Washington DC, please.
- Using The Weather Channel, get me the conditions in Tokyo right now in Celsius, plus visibility, dew point, and moon phase.
See more
All The Weather Channel methodsGets The Weather Channel's daily forecast for a city, address, ZIP code or postcode: up to 15 upcoming days with highs, lows, conditions, rain chance, wind, humidity, UV and sun times.
weather.com/get_daily_forecastGets the next 1 to 48 hourly forecasts for a city, address, ZIP code or postcode from The Weather Channel, with times local to the matched place.
weather.com/get_hourly_forecastLists active severe weather alerts for a city, address, ZIP or postcode on The Weather Channel, most severe first. An empty list means no active alerts.
weather.com/list_weather_alertsGets current conditions and RealFeel for a city or postal code on AccuWeather. The UV level follows standard UV-index ranges. Air quality is null unless it is shown with the current conditions.
accuweather.com/get_current_weatherGets the latest observed weather from a nearby National Weather Service station for a US city, address, or ZIP code. Measurements the station does not report are null.
weather.gov/get_current_conditionsGets current MSN Weather conditions for a city, address or ZIP code. The place is found through OpenStreetMap Nominatim. Matches for broad searches are approximate.
msn.com/get_current_weatherLooks up the National Weather Service seven-day day and night forecast for a U.S. city, address, or ZIP code. Forecast availability depends on NWS land-grid coverage.
weather.gov/get_forecastGets daily weather and time-ordered airport observations for a past date near a city, airport, or ZIP code. Summary averages use the available observations; missing measurements are null.
wunderground.com/get_historical_weather