{"openapi":"3.1.0","info":{"title":"Sportradar NCAA Men's Basketball (BYOK) API","version":"0.1.0","description":"Sportradar NCAA Men's Basketball (BYOK) lets an AI assistant read your own Sportradar NCAA Men's Basketball data through the Sportradar NCAA Men's Basketball API with a key you supply (Sportradar NCAA men's basketball API key (trial or production)). Read-only: 9 tools (list_teams, list_seasons, get_daily_schedule, get_season_schedule, get_team_profile, get_current_poll_rankings,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-ncaamb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-ncaamb/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-ncaamb/terms"},"servers":[{"url":"https://byok-sportradar-ncaamb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-ncaamb/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_teams":{"post":{"operationId":"list_teams","summary":"List the NCAA Division I men's basketball teams with id, name, alias and market (school or city). Use for \"Which teams a","description":"List the NCAA Division I men's basketball teams with id, name, alias and market (school or city). Use for \"Which teams are in NCAA men's basketball and what are their ids\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"}},"required":["access_level","language_code"],"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/list_seasons":{"post":{"operationId":"list_seasons","summary":"List the seasons the NCAA men's basketball API covers with year, dates, status and season type. Use for \"Which NCAA men'","description":"List the seasons the NCAA men's basketball API covers with year, dates, status and season type. Use for \"Which NCAA men's basketball seasons are available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"}},"required":["access_level","language_code"],"title":"list_seasonsArguments","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_daily_schedule":{"post":{"operationId":"get_daily_schedule","summary":"List the NCAA men's basketball games on one calendar date with teams, start time, venue, status and points. Up to 300 ga","description":"List the NCAA men's basketball games on one calendar date with teams, start time, venue, status and points. Up to 300 games are returned. Use for \"What were the college basketball scores on 2026-03-14\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"year":{"description":"Four-digit calendar year, for example 2025.","maxLength":200,"title":"Year","type":"string"},"month":{"description":"Two-digit month, 01 to 12.","maxLength":200,"title":"Month","type":"string"},"day":{"description":"Two-digit day of the month, 01 to 31.","maxLength":200,"title":"Day","type":"string"}},"required":["access_level","language_code","year","month","day"],"title":"get_daily_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_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"List games of one NCAA men's basketball season and season type with teams, start time, venue, status and points. Only th","description":"List games of one NCAA men's basketball season and season type with teams, start time, venue, status and points. Only the first 300 games are returned, so prefer get_daily_schedule for one day. Use for \"What does the 2025 NCAA men's basketball postseason schedule look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"season_year":{"description":"Four-digit season year, for example 2026.","maxLength":200,"title":"Season Year","type":"string"},"season_type":{"description":"Season type code: REG or CT or PST.","enum":["REG","CT","PST"],"title":"Season Type","type":"string"}},"required":["access_level","language_code","season_year","season_type"],"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_profile":{"post":{"operationId":"get_team_profile","summary":"Get one NCAA men's basketball team's profile (school, arena, founding year, conference, division, titles) and its coachi","description":"Get one NCAA men's basketball team's profile (school, arena, founding year, conference, division, titles) and its coaching staff. Use for \"Which conference and arena does this college basketball team belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"team_id":{"description":"Team id (UUID) as returned by list_teams.","maxLength":200,"title":"Team Id","type":"string"}},"required":["access_level","language_code","team_id"],"title":"get_team_profileArguments","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_poll_rankings":{"post":{"operationId":"get_current_poll_rankings","summary":"Get the latest AP or USA Today men's basketball poll for a season: rank, team, record and points, plus teams receiving v","description":"Get the latest AP or USA Today men's basketball poll for a season: rank, team, record and points, plus teams receiving votes. Use for \"Who is ranked number one in the AP men's college basketball poll right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"poll_type":{"description":"Poll code: AP (Associated Press) or US (USA Today).","enum":["AP","US"],"title":"Poll Type","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","language_code","poll_type","season_year"],"title":"get_current_poll_rankingsArguments","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_poll_rankings_by_week":{"post":{"operationId":"get_poll_rankings_by_week","summary":"Get the AP or USA Today men's basketball poll for one week of a season: rank, team, record and points. Use for \"What was","description":"Get the AP or USA Today men's basketball poll for one week of a season: rank, team, record and points. Use for \"What was the AP poll top 25 in week 10 of the 2025 season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"poll_type":{"description":"Poll code: AP (Associated Press) or US (USA Today).","enum":["AP","US"],"title":"Poll Type","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"},"ncaa_week":{"description":"Week of the NCAA season: W1 to W20, PRE for preseason, PST for postseason or PSTF for the USA Today postseason final.","maxLength":200,"title":"Ncaa Week","type":"string"}},"required":["access_level","language_code","poll_type","season_year","ncaa_week"],"title":"get_poll_rankings_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/get_net_rankings":{"post":{"operationId":"get_net_rankings","summary":"Get the NCAA NET rankings for a season: NET rank, previous rank, record, conference record, strength of schedule and qua","description":"Get the NCAA NET rankings for a season: NET rank, previous rank, record, conference record, strength of schedule and quadrant records. Up to 400 teams are returned. Use for \"Which teams are highest in the NET rankings and what are their quadrant 1 records\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"},"season_type":{"const":"REG","description":"Season type code: REG.","title":"Season Type","type":"string"}},"required":["access_level","language_code","season_year","season_type"],"title":"get_net_rankingsArguments","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_tournaments":{"post":{"operationId":"list_tournaments","summary":"List the men's basketball tournaments of a season and season type (such as conference tournaments and the NCAA tournamen","description":"List the men's basketball tournaments of a season and season type (such as conference tournaments and the NCAA tournament) with location, status and dates. Use for \"Which college basketball tournaments are played in the 2025 postseason\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","title":"Language Code","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"},"season_type":{"description":"Season type code: REG or CT or PST.","enum":["REG","CT","PST"],"title":"Season Type","type":"string"}},"required":["access_level","language_code","season_year","season_type"],"title":"list_tournamentsArguments","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}}}}