{"openapi":"3.1.0","info":{"title":"SportsData.io Soccer (BYOK) API","version":"0.1.0","description":"SportsData.io Soccer (BYOK) lets an AI assistant read your own SportsData.io Soccer data through the SportsData.io Soccer API with a key you supply (SportsData.io Soccer API key). Read-only: 10 tools (list_areas, list_competitions, get_standings, list_teams, list_season_teams, list_venues, get_season_schedule, list_scores_by_date, list_team_players, list_team_game_stats_by_date). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportsdataio-soccer.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-soccer/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-soccer/terms"},"servers":[{"url":"https://byok-sportsdataio-soccer.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-soccer/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_areas":{"post":{"operationId":"list_areas","summary":"List soccer areas (countries and regions) with their country codes. Use for \"Which areas does the soccer data cover\".","description":"List soccer areas (countries and regions) with their country codes. Use for \"Which areas does the soccer data cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_areasArguments","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_competitions":{"post":{"operationId":"list_competitions","summary":"List soccer competitions with id, key, area, gender, type and format; use the id or key as competition in other tools. U","description":"List soccer competitions with id, key, area, gender, type and format; use the id or key as competition in other tools. Use for \"What is the competition key for the English Premier League\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_competitionsArguments","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_standings":{"post":{"operationId":"get_standings","summary":"Get a competition's standings for a season grouped by round: each round with its dates and the standings table (team, ga","description":"Get a competition's standings for a season grouped by round: each round with its dates and the standings table (team, games, wins, draws, losses, goals, points). Use for \"What is the Premier League table for 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"season":{"description":"Season year, for example 2025.","maxLength":6,"title":"Season","type":"string"}},"required":["competition","season"],"title":"get_standingsArguments","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_teams":{"post":{"operationId":"list_teams","summary":"List the teams of a soccer competition with id, key, names, area, home venue, city, founding year and nicknames. Use for","description":"List the teams of a soccer competition with id, key, names, area, home venue, city, founding year and nicknames. Use for \"Which teams play in the Premier League\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"}},"required":["competition"],"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_season_teams":{"post":{"operationId":"list_season_teams","summary":"List the teams that took part in one season of a competition, by season id. Use for \"Which teams were in season 2 of com","description":"List the teams that took part in one season of a competition, by season id. Use for \"Which teams were in season 2 of competition 8\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"seasonid":{"description":"Season id from the competition hierarchy (CompetitionDetails or Competitions), for example 1.","title":"Seasonid","type":"integer"}},"required":["competition","seasonid"],"title":"list_season_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_venues":{"post":{"operationId":"list_venues","summary":"List soccer venues with city, country, capacity, surface, opening year and coordinates. Use for \"Which stadiums have the","description":"List soccer venues with city, country, capacity, surface, opening year and coordinates. Use for \"Which stadiums have the biggest capacity\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"Get a competition season's schedule in short form: game id, date, status, teams, scores and winner. Use for \"Show the Pr","description":"Get a competition season's schedule in short form: game id, date, status, teams, scores and winner. Use for \"Show the Premier League 2025 fixtures\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"season":{"description":"Season year, for example 2025.","maxLength":6,"title":"Season","type":"string"}},"required":["competition","season"],"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/list_scores_by_date":{"post":{"operationId":"list_scores_by_date","summary":"List a competition's games on one date in short form: status, period, clock, teams and scores; live games update while i","description":"List a competition's games on one date in short form: status, period, clock, teams and scores; live games update while in progress. Use for \"What were the Premier League scores on 2025-09-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"date":{"description":"Game date written YYYY-MM-DD, for example 2025-09-01.","maxLength":10,"title":"Date","type":"string"}},"required":["competition","date"],"title":"list_scores_by_dateArguments","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_team_players":{"post":{"operationId":"list_team_players","summary":"List a team's players in a competition with name, position, jersey number, preferred foot, height, weight and nationalit","description":"List a team's players in a competition with name, position, jersey number, preferred foot, height, weight and nationality. Use for \"Who is in team 516's squad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"teamid":{"description":"Team id as returned by list_teams (field TeamId), for example 516.","title":"Teamid","type":"integer"}},"required":["competition","teamid"],"title":"list_team_playersArguments","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_team_game_stats_by_date":{"post":{"operationId":"list_team_game_stats_by_date","summary":"List team match statistics for a competition's games on one date: possession, goals, shots, cards, passes, corners and f","description":"List team match statistics for a competition's games on one date: possession, goals, shots, cards, passes, corners and fouls. Use for \"What was the possession in each Premier League game on 2025-09-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"competition":{"description":"Competition id or key as returned by list_competitions, for example EPL, MLS, 1 or 8.","maxLength":12,"title":"Competition","type":"string"},"date":{"description":"Game date written YYYY-MM-DD, for example 2025-09-01.","maxLength":10,"title":"Date","type":"string"}},"required":["competition","date"],"title":"list_team_game_stats_by_dateArguments","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}}}}