{"openapi":"3.1.0","info":{"title":"SportsData.io NHL (BYOK) API","version":"0.1.0","description":"SportsData.io NHL (BYOK) lets an AI assistant read your own SportsData.io NHL data through the SportsData.io NHL API with a key you supply (SportsData.io NHL API key). Read-only: 12 tools (get_standings, list_teams, get_current_season, get_season_schedule, list_scores_by_date, list_team_players, list_stadiums, list_team_season_stats, list_player_season_stats_by_team, list_team_game_stats_by_date,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportsdataio-nhl.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-nhl/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-nhl/terms"},"servers":[{"url":"https://byok-sportsdataio-nhl.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-nhl/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_standings":{"post":{"operationId":"get_standings","summary":"Get regular-season NHL standings for a season: wins, losses, overtime losses, points percentage, conference and division","description":"Get regular-season NHL standings for a season: wins, losses, overtime losses, points percentage, conference and division record and rank, and clinch or elimination flags. Use for \"What are the NHL standings this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year as used by the API (see get_current_season, field ApiSeason), for example 2026.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"get_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_teams":{"post":{"operationId":"list_teams","summary":"List active NHL teams with abbreviation, city, name, conference, division, arena id and head coach. Use for \"Which divis","description":"List active NHL teams with abbreviation, city, name, conference, division, arena id and head coach. Use for \"Which division is Boston in and who coaches them\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_teamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_current_season":{"post":{"operationId":"get_current_season","summary":"Get the current NHL season: season year, start and end year, description, regular season and postseason start dates, and","description":"Get the current NHL season: season year, start and end year, description, regular season and postseason start dates, and the value to pass as season in other tools. Use for \"What NHL season is current and when do the playoffs begin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_current_seasonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"Get a season's NHL schedule in short form: game id, date, status, teams, scores and arena id. Use for \"Show the NHL sche","description":"Get a season's NHL schedule in short form: game id, date, status, teams, scores and arena id. Use for \"Show the NHL schedule for the 2026 season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year as used by the API (see get_current_season, field ApiSeason), for example 2026; a season type suffix such as POST may follow, for example 2026POST.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"get_season_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_scores_by_date":{"post":{"operationId":"list_scores_by_date","summary":"List NHL games played on one date with status, teams, scores and arena id; live games update while in progress. Use for ","description":"List NHL games played on one date with status, teams, scores and arena id; live games update while in progress. Use for \"What were the NHL scores on 2026-JAN-31\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written YYYY-MON-DD with a three-letter month, for example 2026-JAN-31.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_scores_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_players":{"post":{"operationId":"list_team_players","summary":"List a team's NHL roster with name, status, position, jersey number, height and weight. Use for \"Who is on the Boston Br","description":"List a team's NHL roster with name, status, position, jersey number, height and weight. Use for \"Who is on the Boston Bruins roster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example BOS.","maxLength":6,"title":"Team","type":"string"}},"required":["team"],"title":"list_team_playersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_stadiums":{"post":{"operationId":"list_stadiums","summary":"List NHL arenas with address, city, state, country, capacity and coordinates. Use for \"What is the capacity of each NHL ","description":"List NHL arenas with address, city, state, country, capacity and coordinates. Use for \"What is the capacity of each NHL arena\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_stadiumsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_season_stats":{"post":{"operationId":"list_team_season_stats","summary":"List season-total statistics for every NHL team: games, record, goals, assists, shots on goal, power play goals, penalty","description":"List season-total statistics for every NHL team: games, record, goals, assists, shots on goal, power play goals, penalty minutes, hits, blocks and faceoffs. Use for \"Which NHL team has the most power play goals this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year as used by the API (see get_current_season, field ApiSeason), for example 2026; a season type suffix such as POST may follow, for example 2026POST.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"list_team_season_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_player_season_stats_by_team":{"post":{"operationId":"list_player_season_stats_by_team","summary":"List season-total statistics of one NHL team's players: games, goals, assists, shots, plus-minus, penalty minutes, hits,","description":"List season-total statistics of one NHL team's players: games, goals, assists, shots, plus-minus, penalty minutes, hits, and goaltender wins, saves and goals against. Use for \"How many goals did each Boston player score this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year as used by the API (see get_current_season, field ApiSeason), for example 2026; a season type suffix such as POST may follow, for example 2026POST.","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example BOS.","maxLength":6,"title":"Team","type":"string"}},"required":["season","team"],"title":"list_player_season_stats_by_teamArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_game_stats_by_date":{"post":{"operationId":"list_team_game_stats_by_date","summary":"List team game statistics for every NHL game on one date: opponent, home or away, goals, shots, power play goals, penalt","description":"List team game statistics for every NHL game on one date: opponent, home or away, goals, shots, power play goals, penalty minutes, hits and blocks. Use for \"How many shots did each team take on 2026-JAN-31\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written YYYY-MON-DD with a three-letter month, for example 2026-JAN-31.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_team_game_stats_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_transactions_by_date":{"post":{"operationId":"list_transactions_by_date","summary":"List NHL player signings, trades, waivers and releases recorded on one date. Use for \"Which NHL players changed teams on","description":"List NHL player signings, trades, waivers and releases recorded on one date. Use for \"Which NHL players changed teams on 2026-JAN-31\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written YYYY-MON-DD with a three-letter month, for example 2026-JAN-31.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_transactions_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_referees":{"post":{"operationId":"list_referees","summary":"List NHL on-ice officials with position, jersey number, college and years of experience. Use for \"Which NHL referees hav","description":"List NHL on-ice officials with position, jersey number, college and years of experience. Use for \"Which NHL referees have the most experience\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_refereesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}