io.github.holodukePublished by GitHub account holodukev1.3.1Updated Oct 28, 2026
Football live scores, fixtures, standings, top scorers, matches, teams and players for 1000+ leagues
Free remote MCP server giving an assistant live football scores, fixtures, standings, match details, team and player data from 1000+ leagues.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.holoduke%2Flivescore-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"livescore": {
"type": "http",
"url": "https://livescoremcp.com/mcp"
}
}
}Free Model Context Protocol server for real-time football scores, fixtures, team stats, and player data from 1000+ leagues worldwide.
Connect any MCP client to the Streamable HTTP endpoint:
Clients that only support the older SSE transport use https://livescoremcp.com/sse. No API key or account needed.
Settings → Connectors → Add custom connector → https://livescoremcp.com/mcp
Settings → Apps & Connectors → Create (developer mode) → https://livescoremcp.com/mcp, no authentication. search and fetch follow the format ChatGPT connectors and deep research require.
Tools that return a list or a report also set structuredContent alongside the text, described by the tool's outputSchema, so a client can read fields instead of parsing prose. The text itself is unchanged.
Answers are compact text written for language models: IDs for follow-up calls and a football-mania.com link for every match, team, player and competition. Every tool is read-only.
"Arsenal", "La Liga"); the best search match is used.timezone (IANA, e.g. Europe/London) and kick-off times and "today" follow it; the default is UTC.language (en, es, de, fr, pt, pt-BR, ar, …) sets team and competition names and the language of the links.format: "json" returns the underlying feed.Clients that support MCP prompts offer these as ready-made commands:
Once connected, just ask your AI assistant:
All football data is provided by football-mania.com - a comprehensive football data platform covering 1000+ leagues and competitions worldwide with real-time scores, fixtures, team statistics, player profiles, and match details.
Football Mania is also available as a mobile app:
LiveScore MCP is free for personal and non-commercial use.
The football data comes from football-mania.com's own API, which serves the hosted instance at livescoremcp.com; a self-hosted copy is meant for development and testing.
Or with Docker:
MIT
Source: README.md at commit d71ad1c
Fetch a team, player, competition or match
Full details for an id from search: team:<id>, player:<id>, league:<league key> or match:<id>. Returns the title, the full text, and the football-mania.com url.
idrequiredlanguagetimezoneMatches on a date
All football matches on a date: results, live scores and kick-off times, grouped by competition (biggest competitions first). A busy day has 1000+ matches, so filter by country or league_key when you can.
datelimitformatcountrylanguagetimezonetzoffsetleague_keyCompetition fixtures (alias)
Same as get_league_fixtures; accepts the competition key with or without the _small suffix.
limitroundformatlanguagetimezonecompetitionrequiredHead-to-head record
All-time head-to-head record of two teams: wins, draws, goals, their recent meetings and the next scheduled meeting. Teams by ID or name.
limitformatteam_arequiredteam_brequiredlanguagetimezoneCompetition fixtures and results
Fixtures and results of one competition (league or cup): latest results, matches in play and upcoming matches of the current season, or one round. For the table use get_standings.
limitroundformatlanguagetimezoneleague_keyrequiredLive football scores
Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.
formatcountrylanguagetimezoneleague_keyMatch details
One match in detail: score, status, goals, cards and substitutions with minutes, line-ups, team statistics (possession, shots, corners…), injuries, form, standings of both teams, match report and head-to-head record.
idrequiredh2hformatlanguagetimezoneLive commentary and events
Minute-by-minute written commentary for a match, plus the goals, cards and substitutions in order. Useful while a match is in play, and afterwards to see how it unfolded.
limitformatlanguagematch_idrequiredevents_onlyMatch report or preview
A written report of a finished match, or a preview of one still to come, with the story and the sources it drew on. Available for selected competitions rather than every match; call get_match first if you are not sure the match has one. Translated into es, de, fr, it, pt, nl, ru, ar and tr; other languages fall back to English.
kindlanguagematch_idrequiredPlayer profile
A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.
idrequiredformatlanguageLeague table
Current standings (league table) of a competition: position, played, won, drawn, lost, goals, points, form and the qualification or relegation zone. Group-stage competitions return every group.
formatlanguageleague_keyrequiredTeam profile
A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.
idrequiredsquadformatlanguagetimezoneTeam logo
URL of a team's logo (PNG).
idrequiredTop scorers
Top scorers of a competition this season: goals, penalty goals, team and nationality.
limitformatlanguageleague_keyrequiredConnectivity check
Connectivity check: echoes the message back.
messageSearch teams, players, competitions
Find teams, players and competitions by name. Returns results with an id (team:…, player:…, league:…) for fetch or the other tools, a title, a football-mania.com url and a short summary; teams include their last and next match.
queryrequiredformatcountrylanguagetimezone100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
https://livescoremcp.com/mcpclaude mcp add --transport http livescore https://livescoremcp.com/mcp{ "mcpServers": { "livescore": { "url": "https://livescoremcp.com/mcp" } }}git clone https://github.com/holoduke/livescore-mcp.gitcd livescore-mcpgo build -o livescore-mcp .PORT=8080 ./livescore-mcpdocker build -t livescore-mcp .docker run -p 8080:8080 livescore-mcp