Api Football
live SportsAPI-Football: live fixtures, standings, predictions, H2H, and league search for global soccer/football. BYO key.
Tools
fixtures 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.
No parameters required.
Try it
standings Current standings table for a league. Returns rank, team, points, goal difference, form. Use league=1 for World Cup.
No parameters required.
Try it
team_search Look up a team by name + country to get its team_id for use in other tools.
No parameters required.
Try it
league_search Look up a league/tournament/competition by name to get its league_id.
No parameters required.
Try it
predictions 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.
No parameters required.
Try it
football_injuries 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
No parameters required.
Try it
football_squad 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.
No parameters required.
Try it
h2h Head-to-head record between two teams. Returns last N matches with scores.
No parameters required.
Try it
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
curl -X POST https://gateway.pipeworx.io/api-football/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -X POST https://gateway.pipeworx.io/api-football/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"fixtures","arguments":{}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("fixtures", {});// Or ask in plain English:
const answer = await px.ask("api-football: live fixtures, standings, predictions, h2h, and league search for global soccer/football");