LiveScore MCP

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.

{
  "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"
  ]
}

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.

{
  "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": []
}

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

{
  "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"
  ]
}

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.

{
  "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"
  ]
}

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.

{
  "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"
  ]
}

Football matches being played right now, worldwide, with score and minute, grouped by competition (biggest competitions first). Optional filters by country or league key.

{
  "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": []
}

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.

{
  "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"
  ]
}

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

{
  "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"
  ]
}

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.

{
  "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"
  ]
}

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

{
  "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"
  ]
}

URL of a team's logo (PNG).

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

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

{
  "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"
  ]
}

Connectivity check: echoes the message back.

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

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.

{
  "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"
  ]
}