{"openapi":"3.1.0","info":{"title":"SportsData.io NFL (BYOK) API","version":"0.1.0","description":"SportsData.io NFL (BYOK) lets an AI assistant read your own SportsData.io NFL data through the SportsData.io NFL API with a key you supply (SportsData.io NFL API key). Read-only: 12 tools (get_standings, list_teams, get_season_schedule, list_scores_by_week, list_scores_by_date, list_timeframes, list_team_players, list_team_season_stats, list_player_season_stats_by_team, list_stadiums,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportsdataio-nfl.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-nfl/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-nfl/terms"},"servers":[{"url":"https://byok-sportsdataio-nfl.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-nfl/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 standings for every NFL team in a season: record, points for and against, division and conference ran","description":"Get regular-season standings for every NFL team in a season: record, points for and against, division and conference rank, streak and clinch flags. Use for \"What are the NFL standings for the 2025 season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025.","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 the active NFL teams with abbreviation, city, name, conference, division, bye week, head coach, coordinators and sc","description":"List the active NFL teams with abbreviation, city, name, conference, division, bye week, head coach, coordinators and schemes. Use for \"Which division is the Washington team in and who coaches it\".","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_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"Get a season's full game schedule with game ids, date, week, status and home and away team abbreviations. Use for \"Show ","description":"Get a season's full game schedule with game ids, date, week, status and home and away team abbreviations. Use for \"Show the 2025 regular season schedule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, optionally followed by a season type: 2025REG (regular season, default), 2025PRE or 2025POST.","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_week":{"post":{"operationId":"list_scores_by_week","summary":"List scores for all games in a week, with status, quarter, clock and TV channel; updates live during games. Use for \"Wha","description":"List scores for all games in a week, with status, quarter, clock and TV channel; updates live during games. Use for \"What were the scores in week 1 of the 2025 NFL season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, optionally followed by a season type: 2025REG (regular season, default), 2025PRE or 2025POST.","maxLength":10,"title":"Season","type":"string"},"week":{"description":"Week number: preseason 0 to 4, regular season 1 to 18, postseason 1 to 4.","maximum":22,"minimum":0,"title":"Week","type":"integer"}},"required":["season","week"],"title":"list_scores_by_weekArguments","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 scores for all games played on one date, with status, quarter, clock and TV channel. Use for \"Which NFL games were ","description":"List scores for all games played on one date, with status, quarter, clock and TV channel. Use for \"Which NFL games were on 2025-SEP-07 and who won\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written as YYYY-MON-DD with a three-letter month, for example 2025-SEP-07.","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_timeframes":{"post":{"operationId":"list_timeframes","summary":"Show season and week timeframes (current, upcoming, completed, recent or all) with start and end dates and the season an","description":"Show season and week timeframes (current, upcoming, completed, recent or all) with start and end dates and the season and week values to use in other tools. Use for \"What NFL week is it right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"description":"Which timeframes: current, upcoming, completed, recent or all.","enum":["current","upcoming","completed","recent","all"],"title":"Type","type":"string"}},"required":["type"],"title":"list_timeframesArguments","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 roster with name, number, position, status, height, weight, college, experience, age and depth chart posit","description":"List a team's roster with name, number, position, status, height, weight, college, experience, age and depth chart position. Use for \"Who is on the Washington roster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team abbreviation as returned by list_teams (Key), for example WAS or KC.","maxLength":5,"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_team_season_stats":{"post":{"operationId":"list_team_season_stats","summary":"List season-total offensive, passing, rushing and takeaway statistics for all teams in a season. Use for \"Which NFL team","description":"List season-total offensive, passing, rushing and takeaway statistics for all teams in a season. Use for \"Which NFL team gained the most yards in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, optionally followed by a season type: 2025REG (regular season, default), 2025PRE or 2025POST.","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 player statistics for one team: games, passing, rushing, receiving, sacks, tackles and fantasy points.","description":"List season-total player statistics for one team: games, passing, rushing, receiving, sacks, tackles and fantasy points. Use for \"How many yards did each Washington player have in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, optionally followed by a season type: 2025REG (regular season, default), 2025PRE or 2025POST.","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (Key), for example WAS or KC.","maxLength":5,"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_stadiums":{"post":{"operationId":"list_stadiums","summary":"List NFL stadiums with city, state, country, capacity, playing surface, roof type and coordinates. Use for \"Which NFL st","description":"List NFL stadiums with city, state, country, capacity, playing surface, roof type and coordinates. Use for \"Which NFL stadiums have a dome and how many seats\".","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_bye_weeks":{"post":{"operationId":"list_bye_weeks","summary":"List each team's bye week in a season. Use for \"Which teams have a bye in week 9 of 2025\".","description":"List each team's bye week in a season. Use for \"Which teams have a bye in week 9 of 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, optionally followed by a season type: 2025REG (regular season, default), 2025PRE or 2025POST.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"list_bye_weeksArguments","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 player signings, trades, waivers, releases, draft picks and retirements recorded on one date. Use for \"Who was sign","description":"List player signings, trades, waivers, releases, draft picks and retirements recorded on one date. Use for \"Who was signed or released in the NFL on 2025-SEP-02\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Transaction date written as YYYY-MON-DD with a three-letter month, for example 2025-SEP-02.","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}}}}