Servers Playground How we check Add a server Log in

LiveScore MCP

Working · 219 ms

io.github.holoduke/livescore-mcpv1.3.1

Football live scores, fixtures, standings, top scorers, matches, teams and players for 1000+ leagues

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

fetch Read-only

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.

idstring, required

Typed id from search, e.g. team:9002, player:474972, league:EnglandPremierLeague, match:3868859

languagestring

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

timezonestring

IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

LiveScore MCP MCP server | mcptry

Tools (16)

fetch

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.

read-only

Argument	Type	Description
id*	string	Typed id from search, e.g. team:9002, player:474972, league:EnglandPremierLeague, match:3868859
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Typed id from search, e.g. team:9002, player:474972, league:EnglandPremierLeague, match:3868859"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    }
  }
}

get_day_fixtures

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.

read-only

Argument	Type	Description
date	string	YYYY-MM-DD, DD/MM/YYYY, today, tomorrow or yesterday. Default: today in timezone (UTC if none)
limit	number	Maximum matches listed. Default: 150, maximum 500
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
country	string	Only this country, in English (e.g. England, Spain); Eurocups, International or WorldCup for international competitions
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC
tzoffset	number	Day boundaries in this offset from UTC, in minutes (e.g. 120 for UTC+2). Default: from timezone, else 0

get_fixtures

Same as get_league_fixtures; accepts the competition key with or without the _small suffix.

read-only

Argument	Type	Description
limit	number	Results and upcoming matches listed, each. Default: 10
round	string	Only this round/matchday number
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC
competition*	string	League key (e.g. EurocupsUEFAChampionsLeague)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "competition"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Results and upcoming matches listed, each. Default: 10"
    },
    "round": {
      "type": "string",
      "description": "Only this round/matchday number"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    },
    "competition": {
      "type": "string",
      "description": "League key (e.g. EurocupsUEFAChampionsLeague)"
    }
  }
}

get_head_to_head

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.

read-only

Argument	Type	Description
limit	number	Meetings listed. Default: 10
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
team_a*	string	First team: ID (e.g. 9002) or name (e.g. Arsenal)
team_b*	string	Second team: ID or name
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

Input schema (JSON)

{
  "type": "object",
  "required": [
    "team_a",
    "team_b"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Meetings listed. Default: 10"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "team_a": {
      "type": "string",
      "description": "First team: ID (e.g. 9002) or name (e.g. Arsenal)"
    },
    "team_b": {
      "type": "string",
      "description": "Second team: ID or name"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    }
  }
}

get_league_fixtures

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.

read-only

Argument	Type	Description
limit	number	Results and upcoming matches listed, each. Default: 10
round	string	Only this round/matchday number (e.g. 7)
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC
league_key*	string	League key from search (e.g. EnglandPremierLeague, SpainPrimeraDivision, EurocupsUEFAChampionsLeague), or the competition name

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league_key"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Results and upcoming matches listed, each. Default: 10"
    },
    "round": {
      "type": "string",
      "description": "Only this round/matchday number (e.g. 7)"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    },
    "league_key": {
      "type": "string",
      "description": "League key from search (e.g. EnglandPremierLeague, SpainPrimeraDivision, EurocupsUEFAChampionsLeague), or the competition name"
    }
  }
}

get_live_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.

read-only

Argument	Type	Description
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
country	string	Only this country, in English (e.g. England, Spain, Brazil); international club and national-team competitions use Eurocups, International or WorldCup
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC
league_key	string	Only this competition (league key from search, e.g. EnglandPremierLeague)

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "country": {
      "type": "string",
      "description": "Only this country, in English (e.g. England, Spain, Brazil); international club and national-team competitions use Eurocups, International or WorldCup"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    },
    "league_key": {
      "type": "string",
      "description": "Only this competition (league key from search, e.g. EnglandPremierLeague)"
    }
  }
}

get_match

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.

read-only

Argument	Type	Description
id*	string	Match ID (from fixtures, live scores or search)
h2h	boolean	Include the head-to-head record. Default: true
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Match ID (from fixtures, live scores or search)"
    },
    "h2h": {
      "type": "boolean",
      "description": "Include the head-to-head record. Default: true"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    }
  }
}

get_match_commentary

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.

read-only

Argument	Type	Description
limit	number	Maximum ticker entries, most recent last. Default: 60, maximum 300
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
match_id*	string	Match id from get_live_scores, get_day_fixtures or search
events_only	boolean	true: only goals, cards and substitutions, skipping the running commentary. Default: false

Input schema (JSON)

{
  "type": "object",
  "required": [
    "match_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum ticker entries, most recent last. Default: 60, maximum 300"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "match_id": {
      "type": "string",
      "description": "Match id from get_live_scores, get_day_fixtures or search"
    },
    "events_only": {
      "type": "boolean",
      "description": "true: only goals, cards and substitutions, skipping the running commentary. Default: false"
    }
  }
}

get_match_report

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.

read-only

Argument	Type	Description
kind	string	auto (default): report if one exists, otherwise preview. report: only a finished-match report. preview: only a pre-match preview
language	string	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
match_id*	string	Match id from get_live_scores, get_day_fixtures or search

Input schema (JSON)

{
  "type": "object",
  "required": [
    "match_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "auto",
        "report",
        "preview"
      ],
      "type": "string",
      "description": "auto (default): report if one exists, otherwise preview. report: only a finished-match report. preview: only a pre-match preview"
    },
    "language": {
      "type": "string",
      "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"
    },
    "match_id": {
      "type": "string",
      "description": "Match id from get_live_scores, get_day_fixtures or search"
    }
  }
}

get_player

A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.

read-only

Argument	Type	Description
id*	string	Player ID (e.g. 474972), or the player name (best search match is used)
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Player ID (e.g. 474972), or the player name (best search match is used)"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    }
  }
}

get_standings

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.

read-only

Argument	Type	Description
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
league_key*	string	League key from search (e.g. EnglandPremierLeague), or the competition name

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league_key"
  ],
  "properties": {
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "league_key": {
      "type": "string",
      "description": "League key from search (e.g. EnglandPremierLeague), or the competition name"
    }
  }
}

get_team

A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.

read-only

Argument	Type	Description
id*	string	Team ID (e.g. 9002 Arsenal, 13183 Ajax), or the team name (best search match is used)
squad	boolean	Include the full squad. Default: true
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Team ID (e.g. 9002 Arsenal, 13183 Ajax), or the team name (best search match is used)"
    },
    "squad": {
      "type": "boolean",
      "description": "Include the full squad. Default: true"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    }
  }
}

get_team_image

URL of a team's logo (PNG).

read-only

Argument	Type	Description
id*	string	Team ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

get_top_scorers

Top scorers of a competition this season: goals, penalty goals, team and nationality.

read-only

Argument	Type	Description
limit	number	Players listed. Default: 20
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
language	string	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
league_key*	string	League key from search (e.g. SpainPrimeraDivision), or the competition name

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league_key"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Players listed. Default: 20"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "language": {
      "type": "string",
      "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"
    },
    "league_key": {
      "type": "string",
      "description": "League key from search (e.g. SpainPrimeraDivision), or the competition name"
    }
  }
}

health

Connectivity check: echoes the message back.

read-only

Argument	Type	Description
message	string	Text to echo

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "message": {
      "type": "string",
      "description": "Text to echo"
    }
  }
}

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.

read-only

Argument	Type	Description
query*	string	Name or part of it (e.g. Arsenal, Mbappé, Premier League)
format	string	text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters
country	string	Prefer results from this country (in English)
language	string	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
timezone	string	IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Name or part of it (e.g. Arsenal, Mbappé, Premier League)"
    },
    "format": {
      "enum": [
        "text",
        "json"
      ],
      "type": "string",
      "description": "text (default): compact summary with IDs and links. json: the raw data feed, minified and capped at 60,000 characters"
    },
    "country": {
      "type": "string",
      "description": "Prefer results from this country (in English)"
    },
    "language": {
      "type": "string",
      "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"
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone for kick-off times and dates, e.g. Europe/London, America/New_York, Asia/Riyadh. Default: UTC"
    }
  }
}