{"openapi":"3.1.0","info":{"title":"Sportradar NCAA Football (BYOK) API","version":"0.1.0","description":"Sportradar NCAA Football (BYOK) lets an AI assistant read your own Sportradar NCAA Football data through the Sportradar NCAA Football API with a key you supply (Sportradar NCAA football API key (trial or production)). Read-only: 10 tools (list_teams, list_seasons, get_current_poll_rankings, get_poll_rankings_by_week, list_tournaments, get_tournament_schedule, get_team_profile,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-ncaafb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-ncaafb/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-ncaafb/terms"},"servers":[{"url":"https://byok-sportradar-ncaafb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-ncaafb/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 football teams with id, name, alias and market (school or city). Use for \"Which teams are in NCAA football","description":"List the NCAA football teams with id, name, alias and market (school or city). Use for \"Which teams are in NCAA football 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 football API covers with year, dates, status and season type. Use for \"Which NCAA football sea","description":"List the seasons the NCAA football API covers with year, dates, status and season type. Use for \"Which NCAA football 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_current_poll_rankings":{"post":{"operationId":"get_current_poll_rankings","summary":"Get the latest college football poll for a season: rank, team, record and points. Use for \"Who is ranked number one in t","description":"Get the latest college football poll for a season: rank, team, record and points. Use for \"Who is ranked number one in the AP college football 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 as listed by the API: AP25 (Associated Press), EU25 (Amway Coaches), CFP25 (College Football Playoff), FCS25 (FCS Media) or FCSC25 (AFCA FCS Coaches).","enum":["AP25","EU25","CFP25","FCS25","FCSC25"],"title":"Poll Type","type":"string"},"season_year":{"description":"Four-digit season year, for example 2026.","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 college football poll for one week of a season: rank, team, record and points. Use for \"What did the College Foo","description":"Get the college football poll for one week of a season: rank, team, record and points. Use for \"What did the College Football Playoff rankings look like in week 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"},"poll_type":{"description":"Poll code as listed by the API: AP25 (Associated Press), EU25 (Amway Coaches), CFP25 (College Football Playoff), FCS25 (FCS Media) or FCSC25 (AFCA FCS Coaches).","enum":["AP25","EU25","CFP25","FCS25","FCSC25"],"title":"Poll Type","type":"string"},"season_year":{"description":"Four-digit season year, for example 2026.","maxLength":200,"title":"Season Year","type":"string"},"week_number":{"description":"Two-digit week number of the NCAA football season, 01 to 21.","maxLength":200,"title":"Week Number","type":"string"}},"required":["access_level","language_code","poll_type","season_year","week_number"],"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/list_tournaments":{"post":{"operationId":"list_tournaments","summary":"List the football tournaments of a season and season type (such as the College Football Playoff and bowl games) with loc","description":"List the football tournaments of a season and season type (such as the College Football Playoff and bowl games) with location, status and dates. Use for \"Which college football playoff and bowl events are scheduled for 2025\".","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":"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}},"/v1/tools/get_tournament_schedule":{"post":{"operationId":"get_tournament_schedule","summary":"Get the rounds and games of one football tournament (for example the College Football Playoff) with teams, start times a","description":"Get the rounds and games of one football tournament (for example the College Football Playoff) with teams, start times and status. Use for \"What are the College Football Playoff rounds and matchups\".","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"},"tournament_id":{"description":"Tournament id (UUID) as returned by list_tournaments.","maxLength":200,"title":"Tournament Id","type":"string"}},"required":["access_level","language_code","tournament_id"],"title":"get_tournament_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 football team's profile (school, stadium, subdivision, conference, division, titles) and its coaching staff","description":"Get one NCAA football team's profile (school, stadium, subdivision, conference, division, titles) and its coaching staff. Use for \"Which conference and stadium does this college football 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_team_season_statistics":{"post":{"operationId":"get_team_season_statistics","summary":"Get one NCAA football team's season totals (points, touchdowns, rushing, passing, first downs) for a season and season t","description":"Get one NCAA football team's season totals (points, touchdowns, rushing, passing, first downs) for a season and season type. Use for \"What were this college team's passing and rushing totals in the 2025 regular 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"},"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"},"team_id":{"description":"Team id (UUID) as returned by list_teams.","maxLength":200,"title":"Team Id","type":"string"}},"required":["access_level","language_code","season_year","season_type","team_id"],"title":"get_team_season_statisticsArguments","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_seasonal_awards":{"post":{"operationId":"get_seasonal_awards","summary":"List the NCAA football awards of a season and season type with their recipients. Use for \"Who won the college football a","description":"List the NCAA football awards of a season and season type with their recipients. Use for \"Who won the college football awards in 2025\".","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_seasonal_awardsArguments","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_awards":{"post":{"operationId":"list_awards","summary":"List the NCAA football awards known to the API with id, name, description and type. Use for \"Which awards does the NCAA ","description":"List the NCAA football awards known to the API with id, name, description and type. Use for \"Which awards does the NCAA football API cover\".","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_awardsArguments","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}}}}