{"openapi":"3.1.0","info":{"title":"SportsData.io College Basketball (BYOK) API","version":"0.1.0","description":"SportsData.io College Basketball (BYOK) lets an AI assistant read your own SportsData.io College Basketball data through the SportsData.io College Basketball API with a key you supply (SportsData.io College Basketball API key). Read-only: 12 tools (list_conferences, list_teams, get_current_season, get_season_schedule, get_team_schedule, 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-cbb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-cbb/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-cbb/terms"},"servers":[{"url":"https://byok-sportsdataio-cbb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-cbb/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 basketball conferences with their ids and names. Use for \"Which college basketball conferences exist\".","description":"List NCAA basketball conferences with their ids and names. Use for \"Which college basketball 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 basketball teams in short form: abbreviation, school, mascot name, conference and short display name. Use for ","description":"List NCAA basketball teams in short form: abbreviation, school, mascot name, conference and short display name. Use for \"Which teams are in the Big 12\".","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 basketball season: year, start and end year, description, regular season and postseason start dates","description":"Get the current NCAA basketball season: year, start and end year, description, regular season and postseason start dates and the value to use as season in other tools. Use for \"When does the college basketball postseason start\".","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 basketball schedule in short form: game id, date, status, teams, scores, and tournament round and se","description":"Get a season's NCAA basketball schedule in short form: game id, date, status, teams, scores, and tournament round and seeds. Use for \"Show the 2026 college basketball schedule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026, optionally followed by a season type such as PRE, POST or STAR (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/get_team_schedule":{"post":{"operationId":"get_team_schedule","summary":"Get all games of one NCAA basketball team in a season with status, period, time remaining, teams and scores. Use for \"Wh","description":"Get all games of one NCAA basketball team in a season with status, period, time remaining, teams and scores. Use for \"What is UCLA's schedule this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026, optionally followed by a season type such as PRE, POST or STAR (for example 2026POST).","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example UCLA.","maxLength":8,"title":"Team","type":"string"}},"required":["season","team"],"title":"get_team_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 NCAA basketball games on one date in short form with status, teams and scores. Use for \"Which college basketball ga","description":"List NCAA basketball games on one date in short form with status, teams and scores. Use for \"Which college basketball games were played on 2026-FEB-27\".","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-FEB-27.","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 basketball roster with name, class, position, jersey number, height and weight. Use for \"Who is on th","description":"List a team's NCAA basketball roster with name, class, position, jersey number, height and weight. Use for \"Who is on the UCLA roster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example UCLA.","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 basketball arenas with address, city, state, country, capacity and coordinates. Use for \"What is the capacity ","description":"List NCAA basketball arenas with address, city, state, country, capacity and coordinates. Use for \"What is the capacity of each college basketball 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 NCAA basketball teams: record, points, shooting percentages, rebounds, assists, steals,","description":"List season-total statistics for NCAA basketball teams: record, points, shooting percentages, rebounds, assists, steals, blocks and turnovers. Use for \"Which college team shoots the best from three\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026, optionally followed by a season type such as PRE, POST or STAR (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 NCAA basketball team's players: games, minutes, points, rebounds, assists, steals, b","description":"List season-total statistics of one NCAA basketball team's players: games, minutes, points, rebounds, assists, steals, blocks and shooting percentages. Use for \"How many points did each UCLA player score this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026, optionally followed by a season type such as PRE, POST or STAR (for example 2026POST).","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (field Key), for example UCLA.","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_date":{"post":{"operationId":"list_team_game_stats_by_date","summary":"List team box score statistics for every NCAA basketball game on one date: opponent, home or away, points, shooting perc","description":"List team box score statistics for every NCAA basketball game on one date: opponent, home or away, points, shooting percentages, rebounds, assists and turnovers. Use for \"How did each team shoot on 2026-FEB-27\".","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-FEB-27.","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/get_tournament":{"post":{"operationId":"get_tournament","summary":"Get the NCAA basketball tournament record for a season: tournament id, name and location. Use for \"Where is the 2026 NCA","description":"Get the NCAA basketball tournament record for a season: tournament id, name and location. Use for \"Where is the 2026 NCAA tournament held\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"get_tournamentArguments","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}}}}