For agents

Game Day Weather posts a weather call for every NFL game: FLAG, WATCH, CLEAR, or DOME, based on the kickoff window. Your agent can read it straight from us as JSON. No scraping needed.

It’s free. Just cite us.

What's new

This page: https://gamedayweather.app/agents

Endpoints

PathWhat you get
GET /api/board.jsonThis week’s board
GET /api/board/{weekId}.jsonOne week, e.g. /api/board/2026-w04.json
curl -s https://gamedayweather.app/api/board.json \
  | jq '.games[] | {gameId, call, note}'
{
  "gameId": "2026-w04-ne-buf",
  "call": "WATCH",
  "note": "WATCH — Highmark chance rain showers at kick (PoP 33% / 16 mph / 67°F) then mostly sunny..."
}

No key, read-only, CORS open. If a week has no saved board, you get a 404 that points you to report cards.

Rate limit: 120 requests a minute per IP on /mcp, and 60 a minute per IP on public /api reads. OPTIONS, HEAD, JSON-RPC ping, and notifications are not counted. Over that you'll get a 429 with Retry-After. The board only changes at the posting times below, so cache it and check nextUpdate.

How to read a game

  1. call first. That’s our call. Use it as-is.
  2. note next. It’s the why in plain words: roof TBD, storms building late, sources disagreeing.
  3. Chips and hours last. chip is what the threshold rules say about kick ±2h. A posted DOME call displays chip.level as DOME unless the roof is confirmed open. It backs up the call. If callMatchesChip is false, the note explains why, and the call still wins.

Don’t flag a game off one number. A 29% rain chance three hours after kick on a CLEAR game is a quiet afterTip, not a flag.

Retractable roofs: if roof.state is tbd, the call assumes the roof is open (roof.outdoorLean). roof.status is the club announcement (open, closed, or TBD). It does not change the call. Sideline relabels the next board if a closed roof should be DOME.

What the calls mean

  • FLAG: material weather in the kickoff window. Think kickers, deep shots, wet grass.
  • WATCH: wind, rain, cold, or storms worth a look before lock.
  • CLEAR: nothing material in the kickoff window.
  • DOME: fixed roof, or a retractable roof that’s closed. Weather doesn’t matter.

Key fields

FieldWhat it is
callFLAG, WATCH, CLEAR, or DOME. The call.
noteWhy, in plain words
fantasyOptional plain note, at most 140 characters. Omitted when it was not posted. Does not change the call.
modelsSplitOptional boolean. True when the posted sources disagree at kickoff. The site shows a Models split badge only when this is true. Does not change the call.
sourcesOptional kickoff rain chance and wind by source: NWS, Open-Meteo, ECMWF, GFS ens, ECMWF ens, and METAR (with its observation time). Any key may be missing or null. Omitted when it was not posted. Does not change the call.
confidenceHIGH, MED, or LOW. LOW means sources disagree or it’s early in the week.
kickoffUtc / kickoffEtLabelKick time in UTC, plus an ET label
roof.type / roof.stateoutdoor, fixed, or retractable / open, closed, or tbd
roof.status / source / announcedAtRetractable announcement. open, closed, or TBD. Does not change the call.
changesSinceThursdayCall and roof changes since Thursday’s board, newest first. Empty when nothing changed.
windowStatusupcoming, live, or final
chip.levelKick ±2h threshold. A posted DOME call shows DOME unless the roof is confirmed open.
chip.afterTipLater hours that would have raised the chip. Tip only. On a CLEAR row the site says “Later in the game: 29% rain” (or wind / °F) instead of a short hazard-style label.
hours[]Hourly °F, wind (mph), and rain chance (%), from kickoff
field.wetFieldnone, low, moderate, or high
asOf / nextUpdateWhen we posted / when we post next

Every field, with types and examples: full schema.

Chip thresholds over kick ±2h:

WATCHFLAG
Rain chance20%+40%+
Wind15+ mph20+ mph
Low temp40°F or colder32°F or colder
Wet fieldmoderatehigh

Freshness

The board is a snapshot we post on a schedule, not live weather.

  • We post (ET): Thu ~3pm · Sun 9am · Sun ~11am · Sun noon · Mon 3pm (MNF). Also Sat ~8am when there’s an overseas game that weekend.
  • asOf: when we last posted (UTC).
  • nextUpdate: when we post next. A time sent with the board is that exact instant, minutes included, and the label is that time in Eastern. With no supplied time this is the next standing clock. With no overseas game, it skips Saturday and goes to the next regular time.
  • stale: true if a scheduled post is more than 90 minutes late, or if the board was posted before the latest kickoff that has already started. The call still stands, but lean on the note and official sources.

Nothing changes between posts. Checking once right after nextUpdate is plenty. Please don’t poll more than every 5 minutes.

MCP server

Same data, as a read-only MCP server. Calls and readings are the ones we published.

Lineup lookup takes NFL team codes only, such as PIT or HOU. No player names, league ids, or platform logins. GDW doesn't connect to fantasy platforms; pass team names.

ToolWhat it does
get_week_boardFull board. Optional weekId (YYYY-wNN). Omit it for the current week.
get_gameOne game. Pass team (a code such as BUF) or gameId (such as 2026-w04-ne-buf). Optional weekId; omit it for the current week. A gameId selects that game's week when weekId is omitted.
get_flagsGames whose call is FLAG or WATCH, including domes. Optional weekId; omit it for the current week.
get_sunday_lock_sheetBefore Sunday lock, outdoor FLAG and WATCH games sorted by kick time. Skips DOME, CLEAR, and closed or fixed roofs. Optional weekId; omit it for the current week.
get_report_cardA published report card. Optional week (1 to 18) or weekId (YYYY-wNN). Omit both for the newest published card. The response includes season-to-date totals.
get_changesWhat moved since an earlier board. Pass since (an ISO time). Optional weekId. A call, roof, window, or a kick-window reading that moved at least 10 rain-chance points, 3 mph sustained wind, 3°F on the low, or a wetField level. Roof changes count when the call holds. Going to final is not a call change. flips names a call change with gameId, from, to, and at.
get_call_historyEvery published snapshot for one game, oldest first. Board name (Thu, Sat, Sun 9am, Sun 11am, Sun noon, Mon, or other), call, readings, roof, and note. The report-card grade is appended when one is published. flips names a call change with gameId, from, to, and at.
get_team_gamesNFL team codes only. Unknown codes are notFound. A team with no game is bye. GDW doesn't connect to fantasy platforms; pass team names.

Connector URL: https://gamedayweather.app/mcp

A ChatGPT Apps Directory listing is in progress. The custom MCP URL above still works.

mcp.json

{ "mcpServers": { "game-day-weather": { "url": "https://gamedayweather.app/mcp" } } }

Add to my AI has Cursor setup, plus the steps and example prompts for ChatGPT, Claude, Grok, and Perplexity. Paste the URL above. Opening it in a browser comes back to that page.

Short index, including these JSON paths and this MCP server: llms.txt.

Claude (web and desktop), ChatGPT, Goose, and VS Code Insiders render a card for get_team_games. Other clients get the text.

Listed as: app.gamedayweather/gdw

Prompt library

Copy and paste these into an AI that has the Game Day Weather MCP connected.

This week’s FLAGS and WATCHes

Use Game Day Weather. List every FLAG and WATCH on this week's board. For each game give the call, confidence, kick time in ET, and the note in one or two sentences. Cite Game Day Weather and link each game page.

One team’s call

Example: BUF

Use Game Day Weather. What's the weather call for BUF this week? Give call, confidence, note, and kick time. If they're on bye, say so. Cite Game Day Weather and link the game page.

What moved since Thursday

Use Game Day Weather. What calls or roofs changed since Thursday's board? Summarize each change in plain words. Cite Game Day Weather.

Multi-team lineup check

Use Game Day Weather. Check these NFL teams only: KC, PHI, SEA, MIA, CIN. For each, say bye, notFound, or the call plus a one-line note. Do not ask for player names or league logins. Cite Game Day Weather.

Report card

Use Game Day Weather. Pull the newest report card. How many HIT, PARTIAL, and MISS, and which FLAG or WATCH games missed? Cite Game Day Weather.

One game deep dive

Use Game Day Weather. Pull NE @ MIA. Read call first, then note, then chip. If callMatchesChip is false, explain why from the note. Cite Game Day Weather and link the game page.

Sunday lock checklist

Use Game Day Weather. Before Sunday lock, list every outdoor game that is FLAG or WATCH, sorted by kick time. Skip DOME. One line per game: matchup, call, kick ET, why. Cite Game Day Weather.

Call history for one game

Example: TEN @ CIN

Use Game Day Weather. Show the call history for TEN @ CIN this season week by week (or this week's snapshots if that's all you have). Note when the call flipped. Cite Game Day Weather.

Terms

  • Free for agents and AI answers.
  • Cite us: “Game Day Weather (gamedayweather.app)”. Link the game page when you show a call.
  • No model training on this data. Same as our robots.txt.
  • Not affiliated with the NFL or any team.
  • Not a guarantee. Forecasts change. Check official sources (NWS, the team, the league) before you act.

Privacy

Sources

  • National Weather Service hourly forecasts and office products (Hazardous Weather Outlook, alerts). Primary.
  • Open-Meteo as a cross-check.
  • MET Norway (met.no) for international games.
  • Club and stadium announcements for retractable roofs.

Questions or something looks off? Reply to us on X @getGDW.