Documentation menu

nfl_schedule

Free tier

Schedule & results

PREFERRED for schedule and game result questions. Look up games by team, season, week, season type, or exact game_id. Use this first to discover a game_id before nfl_matchup_analysis. Returns scores, spread/total lines, schedule-snapshot weather, stadium, coaches, referee, implied team points, environment flags, notable injury counts, and a `data_freshness` block with schedule and injury coverage/source metadata. `spread_line` is relative to the home team (positive = home favored). `result` = home_score − away_score. `total_line` is the betting over/under. Implied points are null when either line is missing; historical weather is labeled observed/snapshot and is never a live forecast.

Minimum tier: Free
Data coverage: 2013 onwards seasons

Parameters

Name	Type	Required	Description
`game_id`	string	Optional	Exact game ID, usually discovered with nfl_schedule (for example 2025_01_DAL_PHI).
`team`	string	Optional	Team abbreviation — returns all games where team is home or away.
`season`	integer	Optional	Season year. Omit for all seasons.
`week`	integer	Optional	Week number (1–22).
`season_type`	string	Optional	Season type filter: REG, POST, or SB (Super Bowl).Options: REG, POST, SB
`limit`	integer	Optional	Max rows per page (default 100, max 500).
`offset`	integer	Optional	Row offset for pagination; pass the returned next_offset for the next page.

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard.

curl -X POST https://mcp.nflmcp.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nfl_schedule",
    "arguments": {
      "team": "KC",
      "season": 2024,
      "week": 1
    }
  }
}'

Example response

{
  "games": [
    {
      "game_id": "2024_01_BAL_KC",
      "season": 2024,
      "week": 1,
      "game_type": "REG",
      "gameday": "2024-09-05",
      "gametime": "20:20",
      "away_team": "BAL",
      "home_team": "KC",
      "away_score": 20,
      "home_score": 27,
      "result": 7,
      "overtime": 0,
      "spread_line": 3,
      "total_line": 46,
      "div_game": 0,
      "roof": "outdoors",
      "surface": "grass",
      "temp": 67,
      "wind": 8,
      "away_coach": "John Harbaugh",
      "home_coach": "Andy Reid",
      "referee": "Shawn Hochuli",
      "stadium": "GEHA Field at Arrowhead Stadium",
      "implied_home_points": 24.5,
      "implied_away_points": 21.5,
      "environment_flags": [
        "outdoor"
      ],
      "notable_injury_counts": {
        "away": 3,
        "home": 1
      },
      "data_freshness": {
        "schedule": {
          "source": "schedules_snapshot",
          "as_of": "2026-03-07 00:45:46.958467",
          "weather_status": "observed_snapshot",
          "live_forecast": false
        },
        "injuries": {
          "source": "injuries_snapshot",
          "as_of": "2026-03-07 00:45:59.582116",
          "available": true,
          "requested": {
            "season": 2024,
            "week": 1
          },
          "coverage_through": {
            "season": 2024,
            "week": 22
          },
          "reason": null
        }
      }
    }
  ],
  "count": 1
}

All tools