LiveScore MCP is an MCP server published by io.github.holoduke, hosted at livescoremcp.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including fetch, get_day_fixtures, get_fixtures, get_head_to_head, get_league_fixtures.
Football live scores, fixtures, standings, top scorers, matches, teams and players for 1000+ leagues
1 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | 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 |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "fetch",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Fetch a team, player, competition or match",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
| league_key | string | Only this competition (league key from search) |
{
"name": "get_day_fixtures",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD, DD/MM/YYYY, today, tomorrow or yesterday. Default: today in timezone (UTC if none)"
},
"limit": {
"type": "number",
"description": "Maximum matches listed. Default: 150, maximum 500"
},
"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); Eurocups, International or WorldCup for international competitions"
},
"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"
},
"tzoffset": {
"type": "number",
"description": "Day boundaries in this offset from UTC, in minutes (e.g. 120 for UTC+2). Default: from timezone, else 0"
},
"league_key": {
"type": "string",
"description": "Only this competition (league key from search)"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"total",
"returned",
"competitions",
"timezone",
"matches"
],
"properties": {
"total": {
"type": "integer",
"description": "Matches found before any limit was applied"
},
"matches": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"home",
"away",
"status",
"state"
],
"properties": {
"id": {
"type": "string",
"description": "Match id, usable with get_match"
},
"url": {
"type": "string",
"description": "Match page on football-mania.com"
},
"away": {
"type": "string",
"description": "Away team name"
},
"home": {
"type": "string",
"description": "Home team name"
},
"state": {
"type": "string",
"description": "One of scheduled, live, finished, other"
},
"minute": {
"type": "integer",
"description": "Minute played, only while live"
},
"status": {
"type": "string",
"description": "Raw status: a minute while live, FT/HT/Postp. otherwise, or the kick-off time"
},
"country": {
"type": "string",
"description": "Country or confederation of the competition"
},
"awayScore": {
"type": [
"null",
"integer"
],
"description": "Goals for the away team; absent before kick-off"
},
"homeScore": {
"type": [
"null",
"integer"
],
"description": "Goals for the home team; absent before kick-off"
},
"leagueKey": {
"type": "string",
"description": "Competition key, usable with get_standings and get_league_fixtures"
},
"kickoffUtc": {
"type": "string",
"description": "Kick-off in RFC3339 UTC"
},
"competition": {
"type": "string",
"description": "Competition name"
}
},
"additionalProperties": false
}
},
"returned": {
"type": "integer",
"description": "Matches present in this response"
},
"timezone": {
"type": "string",
"description": "Time zone the kick-off times were rendered in"
},
"competitions": {
"type": "integer",
"description": "Distinct competitions represented"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Matches on a date",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Same as get_league_fixtures; accepts the competition key with or without the _small suffix.
| Parameter | 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) |
{
"name": "get_fixtures",
"description": "Same as get_league_fixtures; accepts the competition key with or without the _small suffix.",
"inputSchema": {
"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)"
}
}
},
"annotations": {
"title": "Competition fixtures (alias)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_head_to_head",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Head-to-head record",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_league_fixtures",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Competition fixtures and results",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.
| Parameter | 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) |
{
"name": "get_live_scores",
"description": "Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.",
"inputSchema": {
"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)"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"total",
"returned",
"competitions",
"timezone",
"matches"
],
"properties": {
"total": {
"type": "integer",
"description": "Matches found before any limit was applied"
},
"matches": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"home",
"away",
"status",
"state"
],
"properties": {
"id": {
"type": "string",
"description": "Match id, usable with get_match"
},
"url": {
"type": "string",
"description": "Match page on football-mania.com"
},
"away": {
"type": "string",
"description": "Away team name"
},
"home": {
"type": "string",
"description": "Home team name"
},
"state": {
"type": "string",
"description": "One of scheduled, live, finished, other"
},
"minute": {
"type": "integer",
"description": "Minute played, only while live"
},
"status": {
"type": "string",
"description": "Raw status: a minute while live, FT/HT/Postp. otherwise, or the kick-off time"
},
"country": {
"type": "string",
"description": "Country or confederation of the competition"
},
"awayScore": {
"type": [
"null",
"integer"
],
"description": "Goals for the away team; absent before kick-off"
},
"homeScore": {
"type": [
"null",
"integer"
],
"description": "Goals for the home team; absent before kick-off"
},
"leagueKey": {
"type": "string",
"description": "Competition key, usable with get_standings and get_league_fixtures"
},
"kickoffUtc": {
"type": "string",
"description": "Kick-off in RFC3339 UTC"
},
"competition": {
"type": "string",
"description": "Competition name"
}
},
"additionalProperties": false
}
},
"returned": {
"type": "integer",
"description": "Matches present in this response"
},
"timezone": {
"type": "string",
"description": "Time zone the kick-off times were rendered in"
},
"competitions": {
"type": "integer",
"description": "Distinct competitions represented"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Live football scores",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_match",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Match details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_match_commentary",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"matchId"
],
"properties": {
"url": {
"type": "string"
},
"events": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"team": {
"type": "string"
},
"text": {
"type": "string"
},
"type": {
"type": "string"
},
"minute": {
"type": "string"
},
"player": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Goals, cards and substitutions in order"
},
"ticker": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"team": {
"type": "string"
},
"text": {
"type": "string"
},
"type": {
"type": "string"
},
"minute": {
"type": "string"
},
"player": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Minute-by-minute written commentary, when the competition has it"
},
"matchId": {
"type": "string"
},
"lastUpdated": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Live commentary and events",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_match_report",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"matchId",
"kind",
"home",
"away",
"language",
"text"
],
"properties": {
"url": {
"type": "string"
},
"away": {
"type": "string"
},
"date": {
"type": "string"
},
"home": {
"type": "string"
},
"kind": {
"type": "string",
"description": "report for a finished match, preview for one still to come"
},
"text": {
"type": "string",
"description": "The report or preview, plain text"
},
"score": {
"type": "string"
},
"matchId": {
"type": "string"
},
"sources": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "URLs the report drew on, when recorded"
},
"language": {
"type": "string",
"description": "Language the text was returned in"
},
"leagueKey": {
"type": "string"
},
"competition": {
"type": "string"
},
"generatedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Match report or preview",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.
| Parameter | 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 |
{
"name": "get_player",
"description": "A player: club, position, age, nationality, market value, statistics per season and competition, injuries, transfers and honours.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Player profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "get_standings",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"table"
],
"properties": {
"url": {
"type": "string"
},
"table": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"position",
"team",
"played",
"won",
"drawn",
"lost",
"goalsFor",
"goalsAgainst",
"goalDifference",
"points"
],
"properties": {
"won": {
"type": "integer"
},
"form": {
"type": "string",
"description": "Recent results, most recent last, as W/D/L"
},
"live": {
"type": "boolean",
"description": "true when these points include a match still in play"
},
"lost": {
"type": "integer"
},
"note": {
"type": "string",
"description": "Qualification or relegation note, when the feed carries one"
},
"team": {
"type": "string"
},
"drawn": {
"type": "integer"
},
"group": {
"type": "string",
"description": "Group or stage name, when the competition has more than one table"
},
"played": {
"type": "integer"
},
"points": {
"type": "integer"
},
"teamId": {
"type": "string",
"description": "Usable with get_team"
},
"goalsFor": {
"type": "integer"
},
"position": {
"type": "integer"
},
"goalsAgainst": {
"type": "integer"
},
"goalDifference": {
"type": "integer"
}
},
"additionalProperties": false
},
"description": "Every group's rows in order; each row names its group when there is more than one"
},
"groups": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Group names, when the competition has more than one table"
},
"season": {
"type": "string"
},
"country": {
"type": "string",
"description": "Country the competition is filed under, or the confederation for international competitions"
},
"leagueKey": {
"type": "string"
},
"competition": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "League table",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.
| Parameter | 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 |
{
"name": "get_team",
"description": "A team: recent results and upcoming fixtures, league positions, season statistics, squad with appearances and goals, injuries, transfers, coach, stadium and honours.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Team profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}URL of a team's logo (PNG).
| Parameter | Type | Description |
|---|---|---|
| id * | string | Team ID |
{
"name": "get_team_image",
"description": "URL of a team's logo (PNG).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Team ID"
}
}
},
"annotations": {
"title": "Team logo",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Top scorers of a competition this season: goals, penalty goals, team and nationality.
| Parameter | 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 |
{
"name": "get_top_scorers",
"description": "Top scorers of a competition this season: goals, penalty goals, team and nationality.",
"inputSchema": {
"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"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"scorers"
],
"properties": {
"url": {
"type": "string"
},
"country": {
"type": "string"
},
"scorers": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"rank",
"player",
"goals"
],
"properties": {
"rank": {
"type": "integer"
},
"team": {
"type": "string"
},
"goals": {
"type": "integer"
},
"player": {
"type": "string"
},
"teamId": {
"type": "string",
"description": "Usable with get_team"
},
"playerId": {
"type": "string",
"description": "Usable with get_player"
},
"penalties": {
"type": "integer",
"description": "Of which scored from the penalty spot"
},
"tournament": {
"type": "string",
"description": "Stage name, when the competition splits into more than one"
},
"nationality": {
"type": "string"
}
},
"additionalProperties": false
}
},
"leagueKey": {
"type": "string"
},
"competition": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Top scorers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Connectivity check: echoes the message back.
| Parameter | Type | Description |
|---|---|---|
| message | string | Text to echo |
{
"name": "health",
"description": "Connectivity check: echoes the message back.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"message": {
"type": "string",
"description": "Text to echo"
}
}
},
"annotations": {
"title": "Connectivity check",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "search",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Search teams, players, competitions",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Football (soccer) data from football-mania.com: live scores, fixtures and results, standings, top scorers, match details, teams and players for 1000+ competitions. Workflow: teams, players and competitions can be passed by name; search returns typed ids (team:…, player:…, league:…) that fetch and every other tool accept. get_day_fixtures covers any date; get_live_scores only matches in play right now. Kick-off times are UTC unless you pass timezone: give the user's IANA time zone (e.g. Europe/London, America/Sao_Paulo) when you know it, so times and \"today\" need no conversion. Every answer contains football-mania.com links: cite them when you present the data, so users can open the full match, team or league page.
Names, descriptions and schemas were written by the server and are shown as data.