Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

holoduke/livescore-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 SSE endpoint:

https://livescoremcp.com/sse

Claude Desktop

Add to your claude_desktop_config.json:

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

Claude Code

claude mcp add livescore https://livescoremcp.com/sse

Works with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and more.

Available Tools

Tool Description
get_live_scores Currently live matches with real-time scores and minute-by-minute updates
get_fixtures Competition fixtures (Champions League, Europa League, World Cup, etc.)
get_league_fixtures League-specific fixtures (e.g. Eredivisie, Premier League)
get_day_fixtures All fixtures for a specific date
get_match Detailed match info with events, lineups, stats, and head-to-head data
get_team Team details including squad and statistics
get_player Player profiles with career stats
get_team_image Team logo URL
search Search teams, players, or competitions by name
health Connectivity check

Example Queries

Once connected, just ask your AI assistant:

  • "What are the live scores right now?"
  • "Show me the Premier League table"
  • "How is Barcelona doing this week?"
  • "Who scored in the Champions League tonight?"
  • "What matches are on this Saturday?"
  • "Tell me about Ajax's squad"

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 requests/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
  • SSE transport for real-time communication
  • Deployed on Coolify

Self-Hosting

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

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors