MCP Football Matches Server

Provides MCP-based football match data from multiple sources with async scraping and structured JSON output.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "davise070893-mcp-gettodayfutbolmatches-usingia": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ruta/a/mcp-partidos",
        "python",
        "run_server.py"
      ]
    }
  }
}

You run an MCP server that scrapes multiple football sources to deliver structured, real-time match data. It supports asynchronous scraping, configurable sources, and a scoring system to highlight the most important games for your workflows or AI integrations.

How to use

You run the MCP Football Matches Server and connect to it with an MCP client or script. Use it to fetch today’s or a specific date’s matches, then filter or sort them by importance to surface the top games. The server outputs data in a structured JSON format optimized for AI processing, including teams, kick-off times, leagues, channels, stadiums, status, and live scores when available.

How to install

# Prerequisites: Python installed on your system
# Optional: install UV to run MCP servers (recommended)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone the project repository
git clone <repo-url>
cd mcp-partidos

# Install dependencies
uv venv
uv pip install -r requirements.txt

# Alternative: standard Python environment without UV
git clone <repo-url>
cd mcp-partidos
pip install -r requirements.txt

Configuration and usage notes

Configure the sources you want to scrape by editing the sources list in the code, add or modify URLs for trusted football fixtures providers, and customize the list of major teams used for scoring.

You can run the server locally and test the scraper against individual sources to verify connectivity and parsing.

Using the server with an MCP client

{
  "mcpServers": {
    "partidos_mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/ruta/a/mcp-partidos", "python", "run_server.py"]
    }
  }
}

Additional notes

You can customize the sources in src/mcp_partidos/config.py to point to ESPN, Goal.com, BBC Sport, Marca, AS, and other supported outlets. You can also define a list of globally important teams to influence the attractiveness scoring.

Tips for Claude integration

If you plan to integrate with Claude, configure the MCP server entry for Claude with the command and arguments to launch the server, then query for the top five most attractive matches today.

Available tools

obtener_partidos_hoy

Retrieves scheduled matches for today, with an option to include sources as a boolean flag.

obtener_partidos_fecha

Fetches matches for a specific date, with an option to include sources.

listar_fuentes

Lists all configured data sources for scraping.

probar_fuente

Tests whether a given source URL is functioning and parseable.