LiveScore MCP
Football live scores, fixtures, standings, top scorers, matches, teams and players for 1000+ leagues
Should I use this
Quality & Safety
Findings (1)
- LOWin get_top_scorers
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"livescore-mcp": {
"url": "https://livescoremcp.com/mcp"
}
}
}Remote endpoints
https://livescoremcp.com/mcpstreamable-httphttps://livescoremcp.com/ssesseWhat it can do
Tool inventory
Tools (14)
π’fetch(id, language, timezone)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Typed id from search, e.g. team:9002, player:474972, league:EnglandPremierLeague, match:3868859",
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"id"
]
}π’get_day_fixtures(country, date, format, language, league_key, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"country": {
"description": "Only this country, in English (e.g. England, Spain); Eurocups, International or WorldCup for international competitions",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD, DD/MM/YYYY, today, tomorrow or yesterday. Default: today in timezone (UTC if none)",
"type": "string"
},
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"league_key": {
"description": "Only this competition (league key from search)",
"type": "string"
},
"limit": {
"description": "Maximum matches listed. Default: 150, maximum 500",
"type": "number"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
},
"tzoffset": {
"description": "Day boundaries in this offset from UTC, in minutes (e.g. 120 for UTC+2). Default: from timezone, else 0",
"type": "number"
}
},
"required": []
}π’get_fixtures(competition, format, language, limit, round, ...)
Same as get_league_fixtures; accepts the competition key with or without the _small suffix.
Input Schema
{
"type": "object",
"properties": {
"competition": {
"description": "League key (e.g. EurocupsUEFAChampionsLeague)",
"type": "string"
},
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"limit": {
"description": "Results and upcoming matches listed, each. Default: 10",
"type": "number"
},
"round": {
"description": "Only this round/matchday number",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"competition"
]
}π’get_head_to_head(format, language, limit, team_a, team_b, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"limit": {
"description": "Meetings listed. Default: 10",
"type": "number"
},
"team_a": {
"description": "First team: ID (e.g. 9002) or name (e.g. Arsenal)",
"type": "string"
},
"team_b": {
"description": "Second team: ID or name",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"team_a",
"team_b"
]
}π’get_league_fixtures(format, language, league_key, limit, round, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"league_key": {
"description": "League key from search (e.g. EnglandPremierLeague, SpainPrimeraDivision, EurocupsUEFAChampionsLeague), or the competition name",
"type": "string"
},
"limit": {
"description": "Results and upcoming matches listed, each. Default: 10",
"type": "number"
},
"round": {
"description": "Only this round/matchday number (e.g. 7)",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"league_key"
]
}π’get_live_scores(country, format, language, league_key, timezone)
Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.
Input Schema
{
"type": "object",
"properties": {
"country": {
"description": "Only this country, in English (e.g. England, Spain, Brazil); international club and national-team competitions use Eurocups, International or WorldCup",
"type": "string"
},
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"league_key": {
"description": "Only this competition (league key from search, e.g. EnglandPremierLeague)",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": []
}π’get_match(format, h2h, id, language, timezone)
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.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"h2h": {
"description": "Include the head-to-head record. Default: true",
"type": "boolean"
},
"id": {
"description": "Match ID (from fixtures, live scores or search)",
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"id"
]
}π’get_player(format, id, language)
A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"id": {
"description": "Player ID (e.g. 474972), or the player name (best search match is used)",
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
}
},
"required": [
"id"
]
}π’get_standings(format, language, league_key)
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.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"league_key": {
"description": "League key from search (e.g. EnglandPremierLeague), or the competition name",
"type": "string"
}
},
"required": [
"league_key"
]
}π’get_team(format, id, language, squad, timezone)
A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"id": {
"description": "Team ID (e.g. 9002 Arsenal, 13183 Ajax), or the team name (best search match is used)",
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"squad": {
"description": "Include the full squad. Default: true",
"type": "boolean"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"id"
]
}π’get_team_image(id)
URL of a team's logo (PNG).
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Team ID",
"type": "string"
}
},
"required": [
"id"
]
}π’get_top_scorers(format, language, league_key, limit)
Top scorers of a competition this season: goals, penalty goals, team and nationality.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"league_key": {
"description": "League key from search (e.g. SpainPrimeraDivision), or the competition name",
"type": "string"
},
"limit": {
"description": "Players listed. Default: 20",
"type": "number"
}
},
"required": [
"league_key"
]
}π’health(message)
Connectivity check: echoes the message back.
Input Schema
{
"type": "object",
"properties": {
"message": {
"description": "Text to echo",
"type": "string"
}
},
"required": []
}π’search(country, format, language, query, timezone)
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.
Input Schema
{
"type": "object",
"properties": {
"country": {
"description": "Prefer results from this country (in English)",
"type": "string"
},
"format": {
"description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters",
"enum": [
"text",
"json"
],
"type": "string"
},
"language": {
"description": "Language for team, competition and country names, and for the football-mania.com links (en, es, de, fr, it, pt, pt-BR, nl, ar, ru, tr, id, β¦). Default: en",
"type": "string"
},
"query": {
"description": "Name or part of it (e.g. Arsenal, MbappΓ©, Premier League)",
"type": "string"
},
"timezone": {
"description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC",
"type": "string"
}
},
"required": [
"query"
]
}Community
Evidence