get_livescoresLABSCO SUMMARY
One tool, one job: what is happening on the pitch right now.
Everything comes back from a single call, which makes it cheap to wire up and hard to misuse — you ask what is being played and get scores, lineups, events and odds in one structured response. The flip side is scope: it is explicitly limited to live, upcoming and recently finished matches, so season tables and historical head-to-heads are not in reach.
What it is
A small MCP server over SoccerDataAPI, focused on matches that are live, about to start, or just finished. One call returns the global list of active matches with team names, kickoff time, stadium and current score, and the detail attached to each — goal breakdown by half, extra time and penalties, substitutions, cards, starting XI and bench with injury status and formation, win/draw/lose, over/under and handicap odds, and the league's name, country and competition format.
What you get
- Real-time information about football matches in progress worldwide, returned as structured data —
get_livescores - Match basics: home and away teams, kickoff time and date, stadium, current score, and whether the match is scheduled, in progress or finished
- Event detail: who scored, when and how, substitutions, yellow and red cards, penalties, and the goal breakdown across first half, second half, extra time and shootout
- Team lineups with the starting XI, the bench, injury status and formation
- Odds for win, draw and lose, over/under, and handicap markets, plus league name, country and competition format
Requirements
A SoccerDataAPI account — sign up there and put the key in AUTH_KEY, in a .env file the client passes with --env-file. Python 3.12+ and the uv package manager; clone the repository, run uv sync, and launch server.py from src/. The published project is mcp-soccer-data 0.1.0. Scope is deliberate: live, upcoming and recently finished matches only — this is not a historical results archive.
Setup effort
Build from source
USE CASES
01
Catching up on matches in progress
Ask what is being played worldwide and get scores, kickoff times and stadiums without opening a livescore site.
02
Checking a predicted lineup before kickoff
Read the starting XI, bench, injury status and formation for an upcoming fixture from the same response.
03
Reconstructing how a match was won
Read the goal breakdown by half and extra time along with substitutions and cards, rather than a bare final score.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- Python 3.12+
- AUTH_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-soccer-data": {
"command": "<YOUR_PATH_TO_PARENT_FOLDER>/uv",
"args": [
"--directory",
"<YOUR_PATH_TO_PARENT_FOLDER>/src/",
"run",
"--env-file",
"<YOUR_PATH_TO_PARENT_FOLDER>/.env",
"server.py"
]
}
}
}
