Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

SportsData.io Soccer (BYOK) — connector documentation

  • MCP endpoint: https://byok-sportsdataio-soccer.connectorbay.com/mcp
  • REST API: POST https://byok-sportsdataio-soccer.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-sportsdataio-soccer.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own SportsData.io Soccer SportsData.io Soccer API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-sportsdataio-soccer.connectorbay.com/health · Tool schemas: https://byok-sportsdataio-soccer.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-sportsdataio-soccer · agent@connectorbay.com

What SportsData.io Soccer (BYOK) is for

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 travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.sportsdata.io. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SportsData.io Soccer. SportsData.io Soccer and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which areas does the soccer data cover?"
  • "What is the competition key for the English Premier League?"
  • "What is the Premier League table for 2025?"
  • "Which teams play in the Premier League?"
  • "Which teams were in season 2 of competition 8?"
  • "Which stadiums have the biggest capacity?"

What it does

  • list_areas: List soccer areas (countries and regions) with their country codes.
  • list_competitions: List soccer competitions with id, key, area, gender, type and format; use the id or key as competition in other tools.
  • get_standings: 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).
  • list_teams: List the teams of a soccer competition with id, key, names, area, home venue, city, founding year and nicknames.
  • list_season_teams: List the teams that took part in one season of a competition, by season id.
  • list_venues: List soccer venues with city, country, capacity, surface, opening year and coordinates.
  • get_season_schedule: Get a competition season's schedule in short form: game id, date, status, teams, scores and winner.
  • list_scores_by_date: List a competition's games on one date in short form: status, period, clock, teams and scores; live games update while in progress.
  • list_team_players: List a team's players in a competition with name, position, jersey number, preferred foot, height, weight and nationality.
  • list_team_game_stats_by_date: List team match statistics for a competition's games on one date: possession, goals, shots, cards, passes, corners and fouls.

BYOK key

You bring your own SportsData.io Soccer SportsData.io Soccer API key (https://sportsdata.io/developers/api-documentation/soccer). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.sportsdata.io over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the SportsData.io Soccer API (api.sportsdata.io) with a BYOK key; documentation: https://sportsdata.io/developers/api-documentation/soccer. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SportsData.io Soccer. SportsData.io Soccer and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your SportsData.io Soccer account.

Built for: Worldwide. Languages: English.