- LIVE
- LEAGUES
- DETAILS
- HUMAN
Short answer
How can I get live football scores in my chat?
Your AI uses API-Football to pull live match statuses and results from various leagues. You can ask for specific match updates or a list of ongoing games to see what's happening right now.
The results
What you get from the data
The AI handles the data retrieval so you can focus on the matches.
LIVE
Real-time match tracking
The AI pulls current scores and match statuses. You get live updates on goals and game progress.
LEAGUES
Global league coverage
Access data from different football leagues. Your AI finds the specific fixtures you care about.
DETAILS
Specific fixture info
Get deep dives into specific matches. The AI fetches detailed fixture data when you ask for it.
HUMAN
Manual score checking
The AI provides the data, but you decide which matches to follow. You remain in control of your watchlist.
The workflow
What your AI does when you ask for scores.
The AI acts as a bridge between your chat and the live football data.
Find active games
The AI identifies which matches are currently in progress across different leagues.
list_live_fixturesGet match specifics
When you ask about a specific game, the AI pulls the exact details for that fixture.
get_fixturesFilter by league
The AI narrows down the list of live matches to find the specific league you want to watch.
list_live_fixturesReport scores
The AI translates the raw data into a readable score update in your chat window.
get_fixtures
Try it
Copy these to start.
Use these prompts to test the connection.
Starting points
These are examples. Swap out the league or team names to get the specific info you need.
API-Football Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — API-Football capabilities are ready to use.
{
"mcpServers": {
"api-football-mcp": {
"url": "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"
}
}
}What football matches are live right now?
Show me the live scores for the Premier League.
Give me the details for the current match between Real Madrid and Barcelona.
List all live fixtures happening in La Liga.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Start here
Connect API-Football once, then ask.
One click connects this MCP to your AI client. Your credentials stay encrypted and secure on our end.
Connect API-Football to your AIFAQ
How the score tracking works
- 01
Can the AI place bets on these matches?
No. The AI only retrieves match data and scores. It cannot perform any financial transactions or betting actions.
- 02
Can I ask the AI to change the score?
No. The data is read-only. The AI can only report what is happening in the real world via the API.
- 03
Does it cover all football leagues?
It covers a wide range of leagues provided by the API, but it is limited to the data available in the API-Football database.
- 04
How often does the score update?
The updates depend on how often you ask the AI for the latest information.
- 05
Can the AI send me push notifications when a goal is scored?
No. The AI only responds when you prompt it. It cannot proactively send you messages or alerts.
More questions about API-Football? The Connector page answers them. See everything the API-Football Connector can do
Connect API-Football to Claude, Cursor, ChatGPT & more
