LiveScore MCP

LiveScore MCP

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

[livescoremcp.com](https://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

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](https://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