{"openapi":"3.1.0","info":{"title":"Sportradar MLB (BYOK) API","version":"0.1.0","description":"Sportradar MLB (BYOK) lets an AI assistant read your own Sportradar MLB data through the Sportradar MLB API with a key you supply (Sportradar MLB API key (trial or production)). Read-only: 9 tools (list_teams, list_seasons, get_daily_schedule, get_season_schedule, get_team_profile, get_player_profile, list_venues, get_team_season_statistics, list_awards). The BYOK key travels with each request,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-mlb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-mlb/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-mlb/terms"},"servers":[{"url":"https://byok-sportradar-mlb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-mlb/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 MLB teams with id, name, market (city) and abbreviation. Use for \"Which teams are in MLB and what are their ids","description":"List the MLB teams with id, name, market (city) and abbreviation. Use for \"Which teams are in MLB and what are their ids\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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 MLB API covers with year, dates, status and season type. Use for \"Which MLB seasons are available\".","description":"List the seasons the MLB API covers with year, dates, status and season type. Use for \"Which MLB seasons are available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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 MLB games on one calendar date with teams, start time, venue, team records and status. Use for \"Which MLB games","description":"List the MLB games on one calendar date with teams, start time, venue, team records and status. Use for \"Which MLB games are on 2025-07-04\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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 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_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"List the games of one MLB season and season type with teams, start time, venue and status. A full season is long, so onl","description":"List the games of one MLB season and season type with teams, start time, venue and status. A full season is long, so only the first 200 games are returned; use get_daily_schedule for a given day. Use for \"When are the MLB postseason games in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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: PRE or REG or PST or AST or WBC.","enum":["PRE","REG","PST","AST","WBC"],"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 MLB team's profile (market, ballpark, founding year, titles, league, division) and its roster with positions, je","description":"Get one MLB team's profile (market, ballpark, founding year, titles, league, division) and its roster with positions, jersey numbers and batting and throwing hands. Use for \"Who is on the Los Angeles Dodgers roster and where is their ballpark\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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_player_profile":{"post":{"operationId":"get_player_profile","summary":"Get one MLB player's profile: position, jersey number, height, weight, batting and throwing hand, rookie year and debut.","description":"Get one MLB player's profile: position, jersey number, height, weight, batting and throwing hand, rookie year and debut. Use for \"Which hand does this MLB player bat and throw with\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"title":"Access Level","type":"string"},"language_code":{"const":"en","description":"Language of names in the answer, for example en.","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/list_venues":{"post":{"operationId":"list_venues","summary":"List MLB ballparks with city, country, capacity, surface and stadium type. Use for \"Which MLB ballparks have a retractab","description":"List MLB ballparks with city, country, capacity, surface and stadium type. Use for \"Which MLB ballparks have a retractable roof or an indoor stadium type\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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_venuesArguments","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 hitting, pitching and fielding totals for a season and season type. Use for \"What were the Yankees","description":"Get one team's season hitting, pitching and fielding totals for a season and season type. Use for \"What were the Yankees' team hitting and pitching totals in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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: PRE or REG or PST or WBC.","enum":["PRE","REG","PST","WBC"],"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/list_awards":{"post":{"operationId":"list_awards","summary":"List the MLB awards known to the API with id, name, description and type. Use for \"Which awards does the MLB API cover\".","description":"List the MLB awards known to the API with id, name, description and type. Use for \"Which awards does the MLB API cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: production or trial or tracking or trial-tracking.","enum":["production","trial","tracking","trial-tracking"],"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}}}}