Api Football

What Api Football does

The Api Football MCP server connects AI agents with API-Football data through a focused set of football tools. It covers match schedules and results, league tables, team and competition discovery, match predictions, player availability, club squads, head-to-head history, and API account status.

The server fits the 🏃 Sports category and is intended for questions that require current or recent football information. For example, an agent can find fixtures for a league, identify a team ID before making another query, compare two clubs’ previous meetings, or inspect which players are injured or unavailable.

The integration is independent and unofficial. It is not affiliated with, endorsed by, or published by the upstream provider.

How it works

The Api Football MCP server can be connected through a Pipeworx-hosted MCP endpoint or started locally as a stdio process. The hosted pack endpoint lists the football tools together with shared Pipeworx meta-tools. Those shared tools can route broader questions through the wider Pipeworx catalog. The full Pipeworx gateway is another hosted connection option.

A local installation exposes only the Api Football pack’s tools and communicates over standard input and output. Both deployment paths use MCP operations such as initialization, tool listing, and tool calls. The gateway also provides HTTP access for individual tool calls; requests made without the reserved paid key require the caller to provide its own key as _apiKey.

Setup and configuration

For a hosted connection, add the pack endpoint to an MCP client:

{
  "mcpServers": {
    "api-football": {
      "url": "https://gateway.pipeworx.io/api-football/mcp"
    }
  }
}

The package can also run locally with no Pipeworx account or gateway round trip:

{
  "mcpServers": {
    "api-football": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-api-football"]
    }
  }
}

The local process can be started directly with npx -y @pipeworx/mcp-api-football.

Tools and capabilities

• fixtures returns upcoming or recent matches filtered by league, team, or date, including kickoff time, teams, scores when available, venue, and status.
• standings returns a league table with rank, points, goal difference, and form.
• team_search and league_search resolve names to IDs used by other queries.
• predictions provides API-Football match probabilities, advice, form, and head-to-head context.
• football_injuries reports injured or unavailable players, the stated reason, and whether the player is ruled out or doubtful.
• football_squad returns club players with shirt number, position, age, and nationality.
• h2h returns the last requested number of matches between two teams.
• api_football_status reports plan status, expiry, daily usage, daily limit, and the vendor’s per-minute limit without consuming quota.

Limitations and notes

League and team lookups are useful prerequisites when a later tool requires an ID. Example league IDs in the documentation include 1 for the FIFA World Cup, 39 for the English Premier League, and 140 for La Liga.

The hosted pack endpoint includes shared gateway tools in addition to the football tools, so its reported tool count can exceed the list above. The local stdio package exposes only the pack tools. The account-status tool deliberately excludes the account name and email.