NHL API: Get scores
Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.
Unofficial. Not affiliated with or endorsed by NHL.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date NHL schedule date in YYYY-MM-DD form, such as 2026-09-29. Defaults to today (UTC).
Not set
- Team optional
team Team name or nickname to include, such as Toronto Maple Leafs or Leafs.
(default)
- Time Zone optional
time_zone Time zone for game start times, such as America/Los_Angeles. Defaults to US Eastern.
America/New_York (default)
Input as JSON
{}Output
{ "games": [ { "arena": "United Center", "period": null, "status": "scheduled", "game_id": 2026020166, "away_team": "Montréal Canadiens", "game_link": "https://www.nhl.com/gamecenter/mtl-vs-chi/2026/10/23/2026020166" , "home_team": "Chicago Blackhawks", "away_goals": null, "home_goals": null, "start_time": "2026-10-23T20:00:00-04:00", "tv_networks": [ "NHLN", "TSN2", "RDS" ], "time_remaining": null, "away_shots_on_goal": null, "home_shots_on_goal": null }, { "arena": "Ball Arena", "period": null, "status": "scheduled", "game_id": 2026020167, "away_team": "Tampa Bay Lightning", "game_link": "https://www.nhl.com/gamecenter/tbl-vs-col/2026/10/23/2026020167" , "home_team": "Colorado Avalanche", "away_goals": null, "home_goals": null, "start_time": "2026-10-23T21:00:00-04:00", "tv_networks": [ "SN360", "TVAS", "The Spot" ], "time_remaining": null, "away_shots_on_goal": null, "home_shots_on_goal": null } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nhl.com/get_scores","input":{}}' # 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": "nhl.com/get_scores" , "input": {}})# 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": "nhl.com/get_scores" , "input": {} }), 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 nhl.com/get_scores# with {}"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": [], "properties": { "date": { "type": "string", "description": "NHL schedule date in YYYY-MM-DD form, such as 2026-09-29. Defaults to today (UTC)." }, "team": { "type": "string", "default": "", "description": "Team name or nickname to include, such as Toronto Maple Leafs or Leafs." }, "time_zone": { "type": "string", "default": "America/New_York" , "description": "Time zone for game start times, such as America/Los_Angeles. Defaults to US Eastern." } }}Output schema
{ "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "required": [ "start_time", "away_team", "home_team", "away_goals", "home_goals", "status", "period", "time_remaining", "away_shots_on_goal", "home_shots_on_goal", "tv_networks", "arena", "game_link", "game_id" ], "properties": { "arena": { "type": [ "string", "null" ] }, "period": { "type": [ "string", "null" ], "description": "Current period during a live game, otherwise null." }, "status": { "enum": [ "scheduled", "live", "final", "final in overtime", "final in shootout" ], "type": "string" }, "game_id": { "type": "integer", "x-fous-developer": true }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_team": { "type": "string" }, "away_goals": { "type": [ "integer", "null" ] }, "home_goals": { "type": [ "integer", "null" ] }, "start_time": { "type": "string", "description": "Game start time in the selected time zone (ISO 8601)." }, "tv_networks": { "type": "array", "items": { "type": "string" } }, "time_remaining": { "type": [ "string", "null" ], "description": "Time remaining in the current period during a live game, otherwise null." }, "away_shots_on_goal": { "type": [ "integer", "null" ] }, "home_shots_on_goal": { "type": [ "integer", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nhl.com/get_scores- Returns
- start time, teams, goals, status, period, shots on goal, TV networks, arena, game link, game id
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 nhl.com/get_scores with the inputs above.
Ask your agent
- What NHL games are on for 2026-03-14 and what time do they start in Pacific time?
- Show me the scores for the Leafs game last night
- Which NHL games were played on 2025-12-27 with final scores and TV networks?
- Any NHL matchups today involving the Boston Bruins, and where is the arena?
- Give me the shots on goal and current period for every NHL game on 2026-01-08 on nhl.com
See more
All NHL methodsGets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.
nhl.com/get_standingsLooks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
nhl.com/get_player_statsGets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.
nba.com/get_scoresGets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
nfl.com/get_scoresLists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
mlb.com/get_scoresGets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone.
espn.com/get_scoresGets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
sports.yahoo.com/get_scoresFinds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores.
espn.com/get_game_summary