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

Related MCP server: mcp-football

Available Tools

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:

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:

• Google Play

• App Store

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