# 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.

- Page: https://fous.com/methods/msn.com/get-forecast
- Method: `msn.com/get_forecast`, version 1
- Website: msn.com
- Returns: matched place, daily forecasts, optional hourly forecasts, page link, coordinates
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `days` | integer | no | `5` | Number of forecast days, such as 5. Default 10. |
| `units` | string | no |  | Temperature units, such as celsius. Defaults to fahrenheit in the US and celsius elsewhere. One of "fahrenheit", "celsius". |
| `location` | string | yes | `"Atlanta"` | City, address, or ZIP code, such as Atlanta or 10001. |
| `include_hourly` | boolean | no | `true` | Include the next 24 hourly forecasts, such as true. Default false. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "days": 5,
  "location": "Atlanta",
  "include_hourly": true
}
```

Its output:

```json
{
  "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"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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.

## Input schema

```json
{
  "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

```json
{
  "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"
    }
  }
}
```

## See more

- [MSN API: Get current weather](https://fous.com/methods/msn.com/get-current-weather.md): Gets 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 API: Get stock quote](https://fous.com/methods/msn.com/get-stock-quote.md): Gets 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 API: List market movers](https://fous.com/methods/msn.com/list-market-movers.md): Lists 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.
- [The Weather Channel API: Get daily forecast](https://fous.com/methods/weather.com/get-daily-forecast.md): Gets 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.
- [NWS API: Get National Weather Service forecast](https://fous.com/methods/weather.gov/get-forecast.md): Looks 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.
- [NWS API: Get hourly forecast](https://fous.com/methods/weather.gov/get-hourly-forecast.md): Looks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it.
- [The Weather Channel API: Get hourly forecast](https://fous.com/methods/weather.com/get-hourly-forecast.md): Gets 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.
- [The Weather Channel API: Get current weather](https://fous.com/methods/weather.com/get-current-weather.md): 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.
- [All MSN methods](https://fous.com/methods/msn.com.md)
