{"openapi":"3.1.0","info":{"title":"Sportradar NBA (BYOK) API","version":"0.1.0","description":"Sportradar NBA (BYOK) lets an AI assistant read your own Sportradar NBA data through the Sportradar NBA API with a key you supply (Sportradar NBA API key (trial or production)). Read-only: 9 tools (list_teams, list_seasons, get_season_schedule, get_daily_schedule, get_team_profile, get_player_profile, get_team_season_statistics, get_league_leaders, get_free_agents). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-nba.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-nba/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-nba/terms"},"servers":[{"url":"https://byok-sportradar-nba.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-nba/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 NBA database with id, name, alias and market (city). Use for \"Which teams are in the NBA and what ","description":"List the teams in the NBA database with id, name, alias and market (city). Use for \"Which teams are in the NBA 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 NBA API covers, with year, dates, status and season type (preseason, regular season, playoffs). Use","description":"List the seasons the NBA API covers, with year, dates, status and season type (preseason, regular season, playoffs). Use for \"Which NBA 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_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"List every game of one NBA season and season type with teams, start time, status and venue (no scores; use get_daily_sch","description":"List every game of one NBA season and season type with teams, start time, status and venue (no scores; use get_daily_schedule for points). Use for \"What is the NBA regular season schedule 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 2026.","maxLength":200,"title":"Season Year","type":"string"},"season_type":{"description":"Season type code: PRE or REG or IST or PIT or PST.","enum":["PRE","REG","IST","PIT","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_daily_schedule":{"post":{"operationId":"get_daily_schedule","summary":"List the NBA games played on one calendar date with teams, start time, status and points. Use for \"Which NBA games are o","description":"List the NBA games played on one calendar date with teams, start time, status and points. Use for \"Which NBA games are on 2025-12-25 and what were the scores\".","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"},"year":{"description":"Four-digit calendar year, for example 2026.","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_team_profile":{"post":{"operationId":"get_team_profile","summary":"Get one team's profile (market, arena, founding year, titles, conference, division) and its roster with positions and je","description":"Get one team's profile (market, arena, founding year, titles, conference, division) and its roster with positions and jersey numbers. Use for \"Who is on the Boston Celtics roster and which arena do they play 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"},"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 player's biography (position, height, weight, college, rookie year), current team and draft details. Use for \"Wh","description":"Get one player's biography (position, height, weight, college, rookie year), current team and draft details. Use for \"Which college did this NBA player attend and when was he drafted\".","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 statistics: team totals and averages, opponent averages, and each player's per-game averages. Use ","description":"Get one team's season statistics: team totals and averages, opponent averages, and each player's per-game averages. Use for \"What are the Miami Heat's per-game stats for 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 IST or PIT or PST.","enum":["PRE","REG","IST","PIT","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_league_leaders":{"post":{"operationId":"get_league_leaders","summary":"Get the NBA statistical leaders for a season and season type, grouped by category with ranks, players and values. Use fo","description":"Get the NBA statistical leaders for a season and season type, grouped by category with ranks, players and values. Use for \"Who leads the NBA in points this 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 IST or PIT or PST.","enum":["PRE","REG","IST","PIT","PST"],"title":"Season Type","type":"string"}},"required":["access_level","language_code","season_year","season_type"],"title":"get_league_leadersArguments","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_free_agents":{"post":{"operationId":"get_free_agents","summary":"List the players currently listed as free agents with position, size, college and experience. Use for \"Which NBA players","description":"List the players currently listed as free agents with position, size, college and experience. Use for \"Which NBA players are currently free agents\".","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_free_agentsArguments","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}}}}