English Français العربية

LiveScore MCP

Official registry Games, sports and entertainment

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

Source code Website Documentation

What can you do with LiveScore MCP?

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http livescore-mcp 'https://livescoremcp.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "livescore-mcp": {
            "type": "http",
            "url": "https://livescoremcp.com/mcp"
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse livescore-mcp 'https://livescoremcp.com/sse'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "livescore-mcp": {
            "type": "sse",
            "url": "https://livescoremcp.com/sse"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. LiveScore MCP
  2. Quick Start
  3. Available Tools
  4. Prompts
  5. Example Queries
  6. Data Source
  7. Usage Policy
  8. Tech Stack
  9. Self-Hosting
  10. License

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

ToolDescription
get_live_scoresMatches in play right now, with score and minute; filter by country or league
get_day_fixturesAll matches on a date (results, live, kick-off times); filter by country or league
get_league_fixturesA competition's latest results, live matches and upcoming fixtures, or one round
get_standingsLeague table: points, goal difference, form, qualification and relegation zones
get_top_scorersTop scorers of a competition
get_head_to_headAll-time record of two teams, recent meetings and their next meeting
get_matchMatch details: events, line-ups, substitutions, statistics, injuries, form, report and head-to-head
get_teamTeam profile: results, fixtures, squad, injuries, transfers, coach, stadium, honours
get_playerPlayer profile: statistics per season and competition, market value, injuries, transfers
searchFind teams, players and competitions; returns typed ids (team:9002, league:EnglandPremierLeague), titles and links
fetchFull details for an id from search (team, player, competition or match)
get_team_imageTeam logo URL
get_fixturesAlias of get_league_fixtures (kept for 1.0 clients)
get_match_reportWritten report of a finished match, or a preview of one to come, with its sources; translated into nine languages
get_match_commentaryMinute-by-minute commentary plus goals, cards and substitutions in order
healthConnectivity check

Tools that return a list or a report also set structuredContent alongside the text, described by the tool's outputSchema, so a client can read fields instead of parsing prose. The text itself is unchanged.

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:

PromptArguments
match_previewteam_a, team_b
league_roundupleague
team_reportteam
live_nowcountry (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

Frequently asked questions

What is LiveScore MCP?

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

How do I install LiveScore MCP?

It runs as a remote server. In Claude Code: claude mcp add --transport http livescore-mcp 'https://livescoremcp.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does LiveScore MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is LiveScore MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains LiveScore MCP?

It is published by holoduke. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.