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

APIfootball (BYOK) — connector documentation

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

What APIfootball (BYOK) is for

APIfootball (BYOK) lets an AI assistant read your own APIfootball data through the APIfootball API with a key you supply (APIfootball API key). Read-only: 9 tools (list_countries, list_leagues, get_teams, find_players, get_standings, list_matches, get_head_to_head, get_top_scorers, get_predictions). 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 apiv3.apifootball.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by APIfootball. APIfootball 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 countries does my APIfootball plan cover?"
  • "Which football leagues exist in Spain?"
  • "Which teams play in La Liga (league 302)?"
  • "Show season stats for the player Benzema"
  • "What is the current Premier League table (league 152)?"
  • "What Premier League matches are played between 2026-03-01 and 2026-03-07?"

What it does

  • list_countries: List the countries with football data included in your subscription plan, with their ids (used as country_id elsewhere).
  • list_leagues: List the competitions in your plan, optionally for one country, with league id, name and season.
  • get_teams: Get teams of a league, or one team by id: name, country, founding year and home venue. Give league_id or team_id (one is required).
  • find_players: Find players by name or id and return season statistics: club, position, age, appearances, goals and assists. Give player_name or player_id (one is required).
  • get_standings: Get the league table of a competition: position, played, won, drawn, lost, goals for and against and points (overall, home and away exist in the full answer).
  • list_matches: List fixtures and results between two dates, optionally for one league, country or team, or one match id; set live_only for matches in play.
  • get_head_to_head: Get the previous meetings of two teams (by ids) with dates and scores.
  • get_top_scorers: List the top scorers of a league with rank, player, team, goals, assists and penalty goals.
  • get_predictions: List calculated match predictions for fixtures between two dates, optionally per league, country or match id.

BYOK key

You bring your own APIfootball APIfootball API key (https://apifootball.com/). 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 apiv3.apifootball.com 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.

Notices

APIfootball accounts are individual and must not be shared with other developers; the data available depends on the subscription plan.

Data sources

Live from the APIfootball API (apiv3.apifootball.com) with a BYOK key; documentation: https://apifootball.com/documentation/. 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 APIfootball. APIfootball 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 APIfootball account.

Built for: Worldwide. Languages: English.