{"openapi":"3.1.0","info":{"title":"SportsData.io College Football (BYOK) API","version":"0.1.0","description":"SportsData.io College Football (BYOK) lets an AI assistant read your own SportsData.io College Football data through the SportsData.io College Football API with a key you supply (SportsData.io College Football API key). Read-only: 11 tools (list_conferences, list_teams, get_current_season, get_season_schedule, list_games_by_week, list_scores_by_date, list_team_players, list_stadiums,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportsdataio-cfb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-cfb/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-cfb/terms"},"servers":[{"url":"https://byok-sportsdataio-cfb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-cfb/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/list_conferences":{"post":{"operationId":"list_conferences","summary":"List NCAA football conferences with their ids and names. Use for \"Which college football conferences exist\".","description":"List NCAA football conferences with their ids and names. Use for \"Which college football conferences exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_conferencesArguments","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 NCAA football teams in short form: abbreviation, school, mascot name, conference and stadium id. Use for \"Which tea","description":"List NCAA football teams in short form: abbreviation, school, mascot name, conference and stadium id. Use for \"Which teams are in the SEC\".","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 NCAA football season details: season year, season type and week, as one object. Use for \"Which week of t","description":"Get the current NCAA football season details: season year, season type and week, as one object. Use for \"Which week of the college football season is it\".","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 NCAA football schedule in short form: game id, week, date, status, teams, scores and stadium id. Use for ","description":"Get a season's NCAA football schedule in short form: game id, week, date, status, teams, scores and stadium id. Use for \"Show the 2025 college football schedule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025, optionally followed by a season type such as PRE, POST or STAR (for example 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_games_by_week":{"post":{"operationId":"list_games_by_week","summary":"List NCAA football games of one week with status, period, time remaining, teams, scores and TV channel; live games updat","description":"List NCAA football games of one week with status, period, time remaining, teams, scores and TV channel; live games update while in progress. Use for \"What were the college football results in week 3 of 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025.","maxLength":10,"title":"Season","type":"string"},"week":{"description":"Week number of the season, starting at 1.","maximum":20,"minimum":1,"title":"Week","type":"integer"}},"required":["season","week"],"title":"list_games_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 NCAA football games on one date in short form with status, teams and scores. Use for \"Which college football games ","description":"List NCAA football games on one date in short form with status, teams and scores. Use for \"Which college football games were played on 2025-SEP-13\".","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 2025-SEP-13.","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 NCAA football roster with name, class, position, jersey number, height and weight. Use for \"Who is on the ","description":"List a team's NCAA football roster with name, class, position, jersey number, height and weight. Use for \"Who is on the Miami roster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example MIA.","maxLength":8,"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 NCAA football stadiums with name, city, state, dome flag and coordinates. Use for \"Which college football stadiums ","description":"List NCAA football stadiums with name, city, state, dome flag and coordinates. Use for \"Which college football stadiums are domes\".","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 NCAA football teams: record, points for and against, home and road record, passing, rus","description":"List season-total statistics for NCAA football teams: record, points for and against, home and road record, passing, rushing and first-down totals. Use for \"Which college team has the most rushing yards this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025, optionally followed by a season type such as PRE, POST or STAR (for example 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 statistics of one NCAA football team's players: games, passing, rushing and receiving yards and touchd","description":"List season-total statistics of one NCAA football team's players: games, passing, rushing and receiving yards and touchdowns, tackles and sacks. Use for \"Who leads Miami in rushing yards this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025, optionally followed by a season type such as PRE, POST or STAR (for example 2025POST).","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example MIA.","maxLength":8,"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_week":{"post":{"operationId":"list_team_game_stats_by_week","summary":"List team game statistics for every NCAA football game of one week: opponent, home or away, score, first downs, passing ","description":"List team game statistics for every NCAA football game of one week: opponent, home or away, score, first downs, passing and rushing yards, penalties. Use for \"How many rushing yards did each team gain in week 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2025.","maxLength":10,"title":"Season","type":"string"},"week":{"description":"Week number of the season, starting at 1.","maximum":20,"minimum":1,"title":"Week","type":"integer"}},"required":["season","week"],"title":"list_team_game_stats_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}}}}