MCP server

Api Football

io.github.pipeworx-io/api-football

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

API-Football MCP — comprehensive soccer/football data

From the maker's README Part of Pipeworx — an MCP gateway connecting AI agents to 1872+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider. Source

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

51

Token cost

About 27,845 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http api-football https://gateway.pipeworx.io/api-football/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.api-football]
url = "https://gateway.pipeworx.io/api-football/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"api-football":{"type":"http","url":"https://gateway.pipeworx.io/api-football/mcp"}}}

Antigravity

agy mcp add api-football https://gateway.pipeworx.io/api-football/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"api-football","server_url":"https://gateway.pipeworx.io/api-football/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"api-football","server_url":"https://gateway.pipeworx.io/api-football/mcp"}

Tools

• api_football_status ~168 tokens
  API-Football account status for the key in use: subscription plan name, whether it is active and when it ends, requests used today against the daily limit, and the per-minute limit the vendor reports in its rate-limit headers. The vendor does not count this call against the quota. Use it to tell a r
• fixtures ~285 tokens
  Get match fixtures (upcoming + recent) by league, team, or date. Use league=1 for FIFA World Cup, league=39 for EPL, league=140 for La Liga. Returns kickoff, teams, score (if played), venue, status.
• football_injuries ~266 tokens
  Currently injured and unavailable football players for a club or a league — who is out, the injury or reason, and whether they are ruled out or merely doubtful. Covers Serie A, the Premier League, La Liga, the Bundesliga, Ligue 1 and other competitions worldwide. Use for questions about which player
• football_squad ~143 tokens
  The current player squad for a football club — every player with shirt number, position, age and nationality. Use for questions about who plays for a club, squad lists, and a team roster.
• h2h ~127 tokens
  Head-to-head record between two teams. Returns last N matches with scores.
• league_search ~135 tokens
  Look up a league/tournament/competition by name to get its league_id.
• predictions ~133 tokens
  API-Football's own match-outcome predictions. Returns home/draw/away win probabilities, advice, h2h context, form. Use for "who will win" research on specific fixtures.
• standings ~157 tokens
  Current standings table for a league. Returns rank, team, points, goal difference, form. Use league=1 for World Cup.
• team_search ~128 tokens
  Look up a team by name + country to get its team_id for use in other tools.

Browse

• GitHub tools
• Email
• GitHub and code hosting
• Sports

Related MCP servers

• Espn
  ESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.
• Openligadb
  OpenLigaDB MCP — community-run, keyless football / soccer match data.
• Tipmaster Consensus
  Friday expert picks on 25 football matches from players with records since 1997. Read-only, free.
• Jogo
  Find pickup soccer or drop-in football games via your AI. 70+ cities, one-click RSVP.
• Football Data
  Football-Data.org MCP — soccer competitions, matches, standings
• Sportmonks
  Sportmonks Football MCP — wraps the Sportmonks Football v3 API
• Thesportsdb
  TheSportsDB MCP — sports catalog (teams, players, events)
• Football Odds History
  football-odds-history — historical football (soccer) results and odds from sportsbooks, sourced…

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.pipeworx-io/api-football.svg)](https://aptlynx.net/servers/io.github.pipeworx-io/api-football)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents