Submit
holoduke

LiveScore MCP

Community holoduke
Updated

Football Livescore MCP Server — real-time football scores, standings, and match data via Model Context Protocol

LiveScore MCP

Free Model Context Protocol server for real-time football scores, fixtures, team stats, and player data from 1000+ leagues worldwide.

livescoremcp.com

Quick Start

Connect any MCP client to the Streamable HTTP endpoint:

https://livescoremcp.com/mcp

Clients that only support the older SSE transport use https://livescoremcp.com/sse. No API key or account needed.

Claude Code

claude mcp add --transport http livescore https://livescoremcp.com/mcp

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector → https://livescoremcp.com/mcp

ChatGPT

Settings → Apps & Connectors → Create (developer mode) → https://livescoremcp.com/mcp, no authentication. search and fetch follow the format ChatGPT connectors and deep research require.

Cursor, Windsurf, VS Code, Cline and others

{
  "mcpServers": {
    "livescore": {
      "url": "https://livescoremcp.com/mcp"
    }
  }
}

Available Tools

Tool Description
get_live_scores Matches in play right now, with score and minute; filter by country or league
get_day_fixtures All matches on a date (results, live, kick-off times); filter by country or league
get_league_fixtures A competition's latest results, live matches and upcoming fixtures, or one round
get_standings League table: points, goal difference, form, qualification and relegation zones
get_top_scorers Top scorers of a competition
get_head_to_head All-time record of two teams, recent meetings and their next meeting
get_match Match details: events, line-ups, substitutions, statistics, injuries, form, report and head-to-head
get_team Team profile: results, fixtures, squad, injuries, transfers, coach, stadium, honours
get_player Player profile: statistics per season and competition, market value, injuries, transfers
search Find teams, players and competitions; returns typed ids (team:9002, league:EnglandPremierLeague), titles and links
fetch Full details for an id from search (team, player, competition or match)
get_team_image Team logo URL
get_fixtures Alias of get_league_fixtures (kept for 1.0 clients)
health Connectivity check

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.

  • Names or IDs: teams, players and competitions can be passed by name ("Arsenal", "La Liga"); the best search match is used.
  • Time zones: pass timezone (IANA, e.g. Europe/London) and kick-off times and "today" follow it; the default is UTC.
  • Languages: language (en, es, de, fr, pt, pt-BR, ar, …) sets team and competition names and the language of the links.
  • Raw data: format: "json" returns the underlying feed.

Prompts

Clients that support MCP prompts offer these as ready-made commands:

Prompt Arguments
match_preview team_a, team_b
league_roundup league
team_report team
live_now country (optional)

Example Queries

Once connected, just ask your AI assistant:

  • "What are the live scores right now?"
  • "Show me the Premier League table"
  • "Who are the top scorers in La Liga?"
  • "How did Barcelona do this week, and who do they play next?"
  • "Who scored in the Champions League tonight?"
  • "What matches are on this Saturday in Brazil?"
  • "Tell me about Ajax's squad and injuries"
  • "What's the head-to-head between Real Madrid and Barcelona?"

Data Source

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:

Usage Policy

LiveScore MCP is free for personal and non-commercial use.

  • Rate limits are enforced (30 tool calls/min per IP)
  • Bulk scraping and automated data harvesting are not allowed
  • Commercial use requires permission - open an issue to discuss

Tech Stack

  • Go with mcp-go
  • Streamable HTTP (/mcp, stateless) and SSE (/sse) transports
  • Deployed on Coolify

Self-Hosting

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.

git clone https://github.com/holoduke/livescore-mcp.git
cd livescore-mcp
go build -o livescore-mcp .
PORT=8080 ./livescore-mcp

Or with Docker:

docker build -t livescore-mcp .
docker run -p 8080:8080 livescore-mcp

License

MIT

MCP Server · Populars

MCP Server · New