LiveScore MCP

by holoduke

359 downloads

Not rated

GitHub

About

Free MCP server for real-time football live scores, fixtures, team stats, and player data. Connect Claude, Cursor, or any MCP client to 1000+ leagues worldwide via SSE transport. No API key required.

Details

Author: holoduke
Downloads: 359
Categories: Other, Web Scraping, Developer Tools, API

- Real‑time live scores with minute‑by‑minute updates
- Fixtures for competitions (Champions League, World Cup, etc.)
- League‑specific fixtures (e.g., Premier League, Eredivisie)
- Detailed match info including events, lineups, and head‑to‑head
- Team details with squad and statistics
- Player profiles with career stats
- Search teams, players, or competitions by name
- Free for personal and non‑commercial use (30 requests/min per IP)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name LiveScore MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Connect any MCP client to the SSE endpoint https://livescoremcp.com/sse. For Claude Desktop, add the URL to claude_desktop_config.json under the livescore server. For Claude Code, run claude mcp add livescore https://livescoremcp.com/sse. The server also supports self‑hosting via Go build or Docker.

`get_day_fixtures`

Get all fixtures for a specific date. All timestamps are GMT/UTC.

`get_fixtures`

Get fixtures for a specific competition (e.g. EurocupsUEFAChampionsLeague_small). All timestamps are GMT/UTC.

`get_league_fixtures`

Get fixtures for a specific league (e.g. NetherlandsEredivisie). All timestamps are GMT/UTC.

`get_live_scores`

Get currently live football matches and scores. All timestamps are GMT/UTC.

`get_match`

Get detailed match information (events, lineups, stats) with optional head-to-head data

`get_player`

Get detailed player information (stats, career) by player ID

`get_team`

Get detailed team information (squad, stats) by team ID

`get_team_image`

Get team logo PNG URL by team ID

`health`

Health check - echo back a message

`search`

Search for teams, players, or competitions by name

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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:
- Google Play
- App Store

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_day_fixtures

get_fixtures

get_league_fixtures

get_live_scores

get_match

get_player

get_team

get_team_image

health

search

Claude Desktop / Cursor

McpServers

LiveScore MCP

Quick Start

Claude Desktop

Claude Code

Available Tools

Example Queries

Data Source

Usage Policy

Tech Stack

Self-Hosting

License

Install

More like this

@mendableai/firecrawl Mcp Server

Sequential Thinking

Sentry

Github

Filesystem

EverArt

`get_day_fixtures`

`get_fixtures`

`get_league_fixtures`

`get_live_scores`

`get_match`

`get_player`

`get_team`

`get_team_image`

`health`

`search`