MSN API: Get forecast
Gets up to 10 days of MSN Weather forecasts for a city, address, or ZIP code, with optional hourly forecasts for the next 24 hours.
Unofficial. Not affiliated with or endorsed by MSN.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Days optional
days Number of forecast days, such as 5.
5
Whole number from 1 to 10. Default
10.- Units optional
units Temperature units, such as celsius. Defaults to fahrenheit in the US and celsius elsewhere.
Not set
One of
fahrenheit,celsius.- Location, required
location City, address, or ZIP code, such as Atlanta or 10001.
Atlanta
- Include Hourly optional
include_hourly Include the next 24 hourly forecasts, such as true.
true
True or false. Default
false.
Input as JSON
{ "days": 5, "location": "Atlanta", "include_hourly": true}Output
{ "daily": [ { "low": 50, "date": "2026-10-23", "high": 74, "weekday": "Friday", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F&cvid=6adb2442289048a7b7c678d47b05971d&day=1" , "conditions": "Sunny", "wind_speed": 4, "wind_direction": "E", "wind_speed_unit": "mph", "chance_of_precipitation_percent": 0 }, { "low": 51, "date": "2026-10-24", "high": 70, "weekday": "Saturday", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F&cvid=6adb2442289048a7b7c678d47b05971d&day=2" , "conditions": "Sunny", "wind_speed": 7, "wind_direction": "ENE", "wind_speed_unit": "mph", "chance_of_precipitation_percent": 0 }, { "low": 50, "date": "2026-10-25", "high": 70, "weekday": "Sunday", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F&cvid=6adb2442289048a7b7c678d47b05971d&day=3" , "conditions": "Sunny", "wind_speed": 6, "wind_direction": "ENE", "wind_speed_unit": "mph", "chance_of_precipitation_percent": 0 } ], "hourly": [ { "time": "2026-10-23T05:00:00.000-04:00", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F" , "conditions": "Clear", "temperature": 55, "chance_of_precipitation_percent": null }, { "time": "2026-10-23T06:00:00-04:00", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F" , "conditions": "Clear", "temperature": 54, "chance_of_precipitation_percent": 0 }, { "time": "2026-10-23T07:00:00-04:00", "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F" , "conditions": "Clear", "temperature": 53, "chance_of_precipitation_percent": 0 } ], "latitude": 33.7485, "longitude": -84.3915, "page_link": "https://www.msn.com/en-us/weather/forecast/in-Atlanta,Ga.?loc=eyJsIjoiQXRsYW50YSIsInIiOiJHYS4iLCJyMiI6IkZ1bHRvbiBDb3VudHkiLCJjIjoiVW5pdGVkIFN0YXRlcyIsImkiOiJVUyIsImciOiJlbi11cyIsIngiOiItODQuMzkxNSIsInkiOiIzMy43NDg1In0%3D&weadegreetype=F" , "matched_place": "Atlanta, Georgia", "temperature_unit": "fahrenheit"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"msn.com/get_forecast","input":{"days":5,"location":"Atlanta","include_hourly":true}}' # 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": "msn.com/get_forecast" , "input": { "days": 5, "location": "Atlanta", "include_hourly": True }})# 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": "msn.com/get_forecast" , "input": { "days": 5, "location": "Atlanta", "include_hourly": true } }), 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 msn.com/get_forecast# with {"days":5,"location":"Atlanta","include_hourly":true}"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": { "days": { "type": "integer", "default": 10, "maximum": 10, "minimum": 1, "description": "Number of forecast days, such as 5." }, "units": { "enum": [ "fahrenheit", "celsius" ], "type": "string", "description": "Temperature units, such as celsius. Defaults to fahrenheit in the US and celsius elsewhere." }, "location": { "type": "string", "minLength": 1, "description": "City, address, or ZIP code, such as Atlanta or 10001." }, "include_hourly": { "type": "boolean", "default": false, "description": "Include the next 24 hourly forecasts, such as true." } }}Output schema
{ "type": "object", "required": [ "matched_place", "temperature_unit", "daily", "hourly", "page_link", "latitude", "longitude" ], "properties": { "daily": { "type": "array", "items": { "type": "object", "required": [ "date", "weekday", "high", "low", "conditions", "chance_of_precipitation_percent", "wind_speed", "wind_speed_unit", "wind_direction", "page_link" ], "properties": { "low": { "type": [ "number", "null" ] }, "date": { "type": "string", "format": "date" }, "high": { "type": [ "number", "null" ] }, "weekday": { "type": "string" }, "page_link": { "type": "string" }, "conditions": { "type": [ "string", "null" ] }, "wind_speed": { "type": [ "number", "null" ] }, "wind_direction": { "type": [ "string", "null" ] }, "wind_speed_unit": { "type": "string" }, "chance_of_precipitation_percent": { "type": [ "number", "null" ] } } } }, "hourly": { "type": "array", "items": { "type": "object", "required": [ "time", "temperature", "conditions", "chance_of_precipitation_percent", "page_link" ], "properties": { "time": { "type": "string" }, "page_link": { "type": "string" }, "conditions": { "type": [ "string", "null" ] }, "temperature": { "type": [ "number", "null" ] }, "chance_of_precipitation_percent": { "type": [ "number", "null" ] } } } }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "page_link": { "type": "string" }, "matched_place": { "type": "string" }, "temperature_unit": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
msn.com/get_forecast- Returns
- matched place, daily forecasts, optional hourly forecasts, page link, coordinates
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 msn.com/get_forecast with the inputs above.
Ask your agent
- What's the 7-day weather outlook for Denver, Colorado in celsius?
- I need a 10-day forecast for ZIP code 94103 with hourly breakdowns for tomorrow.
- Can you pull up the weather for Lisbon for the next 5 days, in celsius?
- Check the MSN forecast for 30301 over the next 3 days and include hourly temps.
- Give me a 10-day Fahrenheit forecast for Chicago with the matched location and coordinates.
See more
All MSN methodsGets 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 a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours.
msn.com/get_stock_quoteLists MSN Money's current leading stock gainers, losers, or most-active shares in a selected market, in MSN's order. Lists may contain fewer than 50 stocks and prices may be delayed.
msn.com/list_market_moversGets 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_forecastLooks 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_forecastLooks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it.
weather.gov/get_hourly_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_forecastGets 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_weather