The Weather Channel API: List weather alerts
Lists 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.
Unofficial. Not affiliated with or endorsed by The Weather Channel.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Location, required
location City, street address, ZIP or postcode, for example Oklahoma City or 85004.
Oklahoma City
Input as JSON
{ "location": "Oklahoma City"}Output
{ "alerts": [ { "alert_id": "20891a4e-07af-3b50-87ae-c5a60a60f7f2", "severity": "Minor", "page_link": "https://weather.com/us/oklahoma/city/oklahoma-city/localalerts" , "alert_name": "Air Quality Alert", "alert_text": "...AIR QUALITY ALERT IN EFFECT FROM 10 AM TO 10 PM CDT FRIDAY...\n\nThe following statement was issued by the Oklahoma Department of\nEnvironmental Quality until 10 PM CDT Saturday evening.\n\nAn Air Quality Alert for Ozone has been issued for Friday, October\n23rd for the Oklahoma City Metropolitan area …", "expiry_time": "2026-10-23T15:15:00-05:00", "areas_covered": "Oklahoma County", "effective_time": null, "issuing_agency": "National Weather Service" } ], "matched_place": "Oklahoma City, Oklahoma, United States", "weather_com_link": "https://weather.com/us/oklahoma/city/oklahoma-city/localalerts" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"weather.com/list_weather_alerts","input":{"location":"Oklahoma City"}}' # 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/list_weather_alerts" , "input": { "location": "Oklahoma City" }})# 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/list_weather_alerts" , "input": { "location": "Oklahoma City" } }), 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/list_weather_alerts# with {"location":"Oklahoma City"}"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": { "location": { "type": "string", "description": "City, street address, ZIP or postcode, for example Oklahoma City or 85004." } }}Output schema
{ "type": "object", "required": [ "matched_place", "weather_com_link", "alerts" ], "properties": { "alerts": { "type": "array", "items": { "type": "object", "required": [ "alert_name", "severity", "issuing_agency", "effective_time", "expiry_time", "areas_covered", "alert_text", "page_link", "alert_id" ], "properties": { "alert_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "severity": { "type": [ "string", "null" ] }, "page_link": { "type": "string" }, "alert_name": { "type": "string" }, "alert_text": { "type": [ "string", "null" ] }, "expiry_time": { "type": [ "string", "null" ] }, "areas_covered": { "type": [ "string", "null" ] }, "effective_time": { "type": [ "string", "null" ] }, "issuing_agency": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Active alerts, most severe first." }, "matched_place": { "type": "string", "description": "The place matched by The Weather Channel." }, "weather_com_link": { "type": "string", "description": "The alert page for this place." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
weather.com/list_weather_alerts- Returns
- alerts (name, severity, agency, times, areas, text, page link), matched place, alert page link
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/list_weather_alerts with the inputs above.
Ask your agent
- Are there any active severe weather warnings for Oklahoma City right now?
- What weather alerts are in effect for ZIP code 85004?
- Show me the most serious storm advisories currently active near Tulsa, Oklahoma.
- On weather.com, list any active alerts for 10001 and which agencies issued them.
- Is there a flood watch or tornado warning for the Phoenix area today?
See more
All The Weather Channel methodsGets 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.
weather.com/get_current_weatherGets 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 US weather watches, warnings and advisories for a city, address, ZIP code or state, most severe first, then newest.
weather.gov/list_weather_alertsGets 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_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 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_weatherLists current alerts for a named National Park Service park from its Current Conditions page, in the order shown on the page.
nps.gov/list_park_alerts