Basic lookup2 credits

get_schedule

Upcoming games by week or for the next N days

When to use it

You want what is coming up this week, with kickoff times in UTC and posted lines.

Parameters

Name	Type	Required	Description
team	string	no	Team code to filter
week	integer	no	A specific week of the current season (returns all games that week, played or not)
days	integer	no	Days ahead to look when week is not set (default 7)

Request

bash

curl -X POST https://football-mcp-production.up.railway.app/v1/get_schedule \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "BUF",
  "days": 7
}'

Over MCP, ask for it in plain English and the client calls get_schedule itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.

Response

json

{
  "season": 2026,
  "week": null,
  "days": 7,
  "upcoming_games": [
    {
      "game_id": "2026_02_DET_BUF",
      "season": 2026,
      "game_type": "REG",
      "week": 2,
      "gameday": "2026-09-17",
      "weekday": "Thursday",
      "kickoff": "2026-09-18T00:15:00.000Z",
      "away_team": "DET",
      "home_team": "BUF",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "Highmark Stadium",
      "roof": "outdoors",
      "surface": "a_turf",
      "temp": null,
      "wind": null,
      "div_game": false,
      "away_rest": 4,
      "home_rest": 4,
      "spread_line": 5.5,
      "total_line": 54.5,
      "away_moneyline": 200,
      "home_moneyline": -245,
      "away_qb_name": "Jared Goff",
      "home_qb_name": "Josh Allen",
      "away_qb_id": "00-0033106",
      "home_qb_id": "00-0034857",
      "away_coach": "Dan Campbell",
      "home_coach": "Sean McDermott",
      "referee": null,
      "espn_id": "401872932",
      "pfr_id": "202609170buf"
    }
  ],
  "count": 1
}

Response fields

Field	Type	Description
season	number
week	null
days	number
upcoming_games[]	array	List of objects
upcoming_games[].game_id	string
upcoming_games[].season	number
upcoming_games[].game_type	string
upcoming_games[].week	number
upcoming_games[].gameday	string
upcoming_games[].weekday	string
upcoming_games[].kickoff	string
upcoming_games[].away_team	string
upcoming_games[].home_team	string
upcoming_games[].away_score	null
upcoming_games[].home_score	null
upcoming_games[].result	null
upcoming_games[].total	null
upcoming_games[].overtime	null
upcoming_games[].status	string
upcoming_games[].location	string
upcoming_games[].stadium	string
upcoming_games[].roof	string
upcoming_games[].surface	string
upcoming_games[].temp	null
upcoming_games[].wind	null
upcoming_games[].div_game	boolean
upcoming_games[].away_rest	number
upcoming_games[].home_rest	number
upcoming_games[].spread_line	number
upcoming_games[].total_line	number
upcoming_games[].away_moneyline	number
upcoming_games[].home_moneyline	number
upcoming_games[].away_qb_name	string
upcoming_games[].home_qb_name	string
upcoming_games[].away_qb_id	string
upcoming_games[].home_qb_id	string
upcoming_games[].away_coach	string
upcoming_games[].home_coach	string
upcoming_games[].referee	null
upcoming_games[].espn_id	string