{"openapi":"3.1.0","info":{"title":"Sportradar Golf (BYOK) API","version":"0.1.0","description":"Sportradar Golf (BYOK) lets an AI assistant read your own Sportradar Golf data through the Sportradar Golf API with a key you supply (Sportradar Golf API key (trial or production)). Read-only: 7 tools (list_golf_seasons, get_world_rankings, get_tournament_schedule, get_tournament_summary, get_tournament_leaderboard, get_tee_times, get_player_profile). The BYOK key travels with each request, is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-golf.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-golf/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-golf/terms"},"servers":[{"url":"https://byok-sportradar-golf.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-golf/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_golf_seasons":{"post":{"operationId":"list_golf_seasons","summary":"List all golf tours with their available seasons, season ids, years, dates and status. Use for \"Which golf tours and sea","description":"List all golf tours with their available seasons, season ids, years, dates and status. Use for \"Which golf tours and seasons does Sportradar cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"}},"required":["access_level","language_code"],"title":"list_golf_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_world_rankings":{"post":{"operationId":"get_world_rankings","summary":"Get the Official World Golf Ranking for a season year with rank, previous rank, points and events played per player. Use","description":"Get the Official World Golf Ranking for a season year with rank, previous rank, points and events played per player. Use for \"Who are the top 10 golfers in the world golf ranking for 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"season_year":{"description":"Ranking year, 2017 to 2026.","enum":["2017","2018","2019","2020","2021","2022","2023","2024","2025","2026"],"title":"Season Year","type":"string"}},"required":["access_level","language_code","season_year"],"title":"get_world_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_tournament_schedule":{"post":{"operationId":"get_tournament_schedule","summary":"Get the tournament schedule of a tour for a season: name, dates, purse, points, status, winner and venue. Use for \"What ","description":"Get the tournament schedule of a tour for a season: name, dates, purse, points, status, winner and venue. Use for \"What is the PGA Tour schedule for 2025 and who won each event\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"golf_tour":{"description":"Golf tour: champ (PGA Tour Champions), euro (DP World Tour), liv (LIV Golf), lpga, oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour) or usga (2019 only).","enum":["champ","euro","liv","oly","lpga","pga","pgad","usga"],"title":"Golf Tour","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"season_year":{"description":"Season year, 2012 to 2026 (older years depend on the tour).","enum":["2012","2013","2014","2015","2016","2017","2018","2019","2020","2021","2022","2023","2024","2025","2026"],"title":"Season Year","type":"string"}},"required":["access_level","golf_tour","language_code","season_year"],"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_tournament_summary":{"post":{"operationId":"get_tournament_summary","summary":"Get a tournament overview: dates, purse, status, cut line, venue, rounds and the entry field. Use for \"Give me the summa","description":"Get a tournament overview: dates, purse, status, cut line, venue, rounds and the entry field. Use for \"Give me the summary and field of tournament 2cba1945-dc1c-4131-92f4-cfdac8c45060\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"golf_tour":{"description":"Golf tour: champ (PGA Tour Champions), euro (DP World Tour), liv (LIV Golf), lpga, oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour) or usga (2019 only).","enum":["champ","euro","liv","oly","lpga","pga","pgad","usga"],"title":"Golf Tour","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"season_year":{"description":"Season year, 2012 to 2026 (older years depend on the tour).","enum":["2012","2013","2014","2015","2016","2017","2018","2019","2020","2021","2022","2023","2024","2025","2026"],"title":"Season Year","type":"string"},"tournament_id":{"description":"Tournament id from get_tournament_schedule, a UUID such as '2cba1945-dc1c-4131-92f4-cfdac8c45060'.","maxLength":60,"title":"Tournament Id","type":"string"}},"required":["access_level","golf_tour","language_code","season_year","tournament_id"],"title":"get_tournament_summaryArguments","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_leaderboard":{"post":{"operationId":"get_tournament_leaderboard","summary":"Get the leaderboard of a tournament: position, score to par, strokes, money, points and per-round scores for each player","description":"Get the leaderboard of a tournament: position, score to par, strokes, money, points and per-round scores for each player, plus cut line and round status. Use for \"Who is leading tournament 2cba1945-dc1c-4131-92f4-cfdac8c45060\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"golf_tour":{"description":"Golf tour: champ (PGA Tour Champions), euro (DP World Tour), liv (LIV Golf), lpga, oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour) or usga (2019 only).","enum":["champ","euro","liv","oly","lpga","pga","pgad","usga"],"title":"Golf Tour","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"season_year":{"description":"Season year, 2012 to 2026 (older years depend on the tour).","enum":["2012","2013","2014","2015","2016","2017","2018","2019","2020","2021","2022","2023","2024","2025","2026"],"title":"Season Year","type":"string"},"tournament_id":{"description":"Tournament id from get_tournament_schedule, a UUID such as '2cba1945-dc1c-4131-92f4-cfdac8c45060'.","maxLength":60,"title":"Tournament Id","type":"string"}},"required":["access_level","golf_tour","language_code","season_year","tournament_id"],"title":"get_tournament_leaderboardArguments","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_tee_times":{"post":{"operationId":"get_tee_times","summary":"Get the tee times and pairings for one round of a tournament with start holes and players. Use for \"What are the round 1","description":"Get the tee times and pairings for one round of a tournament with start holes and players. Use for \"What are the round 1 tee times for tournament 2cba1945-dc1c-4131-92f4-cfdac8c45060\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"golf_tour":{"description":"Golf tour: champ (PGA Tour Champions), euro (DP World Tour), liv (LIV Golf), lpga, oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour) or usga (2019 only).","enum":["champ","euro","liv","oly","lpga","pga","pgad","usga"],"title":"Golf Tour","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"season_year":{"description":"Season year, 2012 to 2026 (older years depend on the tour).","enum":["2012","2013","2014","2015","2016","2017","2018","2019","2020","2021","2022","2023","2024","2025","2026"],"title":"Season Year","type":"string"},"tournament_id":{"description":"Tournament id from get_tournament_schedule, a UUID such as '2cba1945-dc1c-4131-92f4-cfdac8c45060'.","maxLength":60,"title":"Tournament Id","type":"string"},"round_type":{"description":"rounds for regular rounds or playoff for a playoff.","enum":["rounds","playoff"],"title":"Round Type","type":"string"},"round_number":{"description":"Round number: 01 to 04 (the first playoff round is 01 with round_type playoff).","enum":["01","02","03","04"],"title":"Round Number","type":"string"}},"required":["access_level","golf_tour","language_code","season_year","tournament_id","round_type","round_number"],"title":"get_tee_timesArguments","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 a golfer's profile: country, birthday, height, handedness, turned-pro year, season statistics and recent tournaments","description":"Get a golfer's profile: country, birthday, height, handedness, turned-pro year, season statistics and recent tournaments. Use for \"Show the profile and season statistics of golfer 6db3e736-d86d-4181-aa3b-651b8c1bfdc1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your key: trial or production.","enum":["trial","production"],"title":"Access Level","type":"string"},"language_code":{"description":"Language of names in the answer, for example en.","enum":["da","de","el","en","es","fi","fr","id","it","ja","nl","pt","ru","sr","srl","th","tr","zh","zht"],"title":"Language Code","type":"string"},"player_id":{"description":"Player id (a UUID), for example '6db3e736-d86d-4181-aa3b-651b8c1bfdc1'.","maxLength":60,"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}}}}