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

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_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 and get the IDs and league keys the other tools use
`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. Pass format: "json" for the raw data. All tools take a language (en, es, de, fr, pt, pt-BR, ar, …) for names and links; all times are UTC. Every tool is read-only.

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"

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