{"openapi":"3.1.0","info":{"title":"Sportradar NFL (BYOK) API","version":"0.1.0","description":"Sportradar NFL (BYOK) lets an AI assistant read your own Sportradar NFL data through the Sportradar NFL API with a key you supply (Sportradar NFL API key (trial or production)). Read-only: 10 tools (list_teams, list_seasons, get_weekly_schedule, get_current_week_schedule, get_team_profile, get_player_profile, get_team_season_statistics, get_game_boxscore, get_seasonal_awards, list_tournaments)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-nfl.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-nfl/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-nfl/terms"},"servers":[{"url":"https://byok-sportradar-nfl.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-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/list_teams":{"post":{"operationId":"list_teams","summary":"List the teams in the NFL database with id, name, alias and market (city). Use for \"Which teams are in the NFL and what ","description":"List the teams in the NFL database with id, name, alias and market (city). Use for \"Which teams are in the NFL 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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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 NFL API covers with year, dates, status and season type. Use for \"Which NFL seasons are available\".","description":"List the seasons the NFL API covers with year, dates, status and season type. Use for \"Which NFL 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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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_weekly_schedule":{"post":{"operationId":"get_weekly_schedule","summary":"List the games of one NFL week (season year, season type and week number) with teams, start time, venue, broadcast netwo","description":"List the games of one NFL week (season year, season type and week number) with teams, start time, venue, broadcast network and status. Use for \"What NFL games are scheduled for week 9 of 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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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: PRE or REG or PST.","enum":["PRE","REG","PST"],"title":"Season Type","type":"string"},"nfl_season_week":{"description":"Week number within the season type, for example 1 (regular season weeks run 1 to 18).","maxLength":200,"title":"Nfl Season Week","type":"string"}},"required":["access_level","language_code","season_year","season_type","nfl_season_week"],"title":"get_weekly_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_current_week_schedule":{"post":{"operationId":"get_current_week_schedule","summary":"List the games of the current NFL week with teams, start time, venue, broadcast network and status. Use for \"Which NFL g","description":"List the games of the current NFL week with teams, start time, venue, broadcast network and status. Use for \"Which NFL games are being played this week\".","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":{"description":"Language of names in the answer, for example en.","maxLength":200,"title":"Language Code","type":"string"}},"required":["access_level","language_code"],"title":"get_current_week_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 NFL team's profile (market, venue, founding year, titles, conference, division, coaches) and its player list wit","description":"Get one NFL team's profile (market, venue, founding year, titles, conference, division, coaches) and its player list with positions and jersey numbers. Use for \"Who plays for the Kansas City Chiefs and where do they play home games\".","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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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_player_profile":{"post":{"operationId":"get_player_profile","summary":"Get one NFL player's profile: position, jersey, height, weight, college, rookie year, experience, current team and draft","description":"Get one NFL player's profile: position, jersey, height, weight, college, rookie year, experience, current team and draft details. Use for \"Which college did this NFL player attend and what round was he drafted in\".","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":{"description":"Language of names in the answer, for example en.","maxLength":200,"title":"Language Code","type":"string"},"player_id":{"description":"Player id (UUID) as returned by get_team_profile.","maxLength":200,"title":"Player Id","type":"string"}},"required":["access_level","language_code","player_id"],"title":"get_player_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 team's season totals (points, touchdowns, rushing, passing, first downs) and a player list with games played and","description":"Get one team's season totals (points, touchdowns, rushing, passing, first downs) and a player list with games played and started. Use for \"What were the Buffalo Bills' 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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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: PRE or REG or PST.","enum":["PRE","REG","PST"],"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_game_boxscore":{"post":{"operationId":"get_game_boxscore","summary":"Get a game's status, clock, attendance, weather and period-by-period scoring (home and away points). Use for \"What was t","description":"Get a game's status, clock, attendance, weather and period-by-period scoring (home and away points). Use for \"What was the score by quarter of this NFL game and what was the weather\".","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":{"description":"Language of names in the answer, for example en.","maxLength":200,"title":"Language Code","type":"string"},"game_id":{"description":"Game id (UUID) as returned by get_weekly_schedule.","maxLength":200,"title":"Game Id","type":"string"}},"required":["access_level","language_code","game_id"],"title":"get_game_boxscoreArguments","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 NFL awards of a season and season type with their recipients. Use for \"Who won the NFL awards for the 2024 seas","description":"List the NFL awards of a season and season type with their recipients. Use for \"Who won the NFL awards for the 2024 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":{"description":"Season type code: REG or PST.","enum":["REG","PST"],"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_tournaments":{"post":{"operationId":"list_tournaments","summary":"List special NFL tournaments or events for a season and season type (such as the Pro Bowl) with location, status and dat","description":"List special NFL tournaments or events for a season and season type (such as the Pro Bowl) with location, status and dates. Use for \"Which special NFL events are scheduled for 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":{"description":"Language of names in the answer, for example en.","maxLength":200,"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":"PST","description":"Season type code: 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}}}}