⚽️ Soccerdata MCP Server

⚽️ Soccerdata MCP Server

By yeonupark GitHub

An MCP server that provides real-time football data based on the SoccerDataAPI.

Overview

What is MCP-Soccerdata?

MCP-Soccerdata is an open-source Model Context Protocol (MCP) server that connects to the SoccerDataAPI to deliver real-time football match information through natural language interactions.

How to use MCP-Soccerdata?

To use MCP-Soccerdata, clone the repository, set up your environment with the required dependencies, and register the server in your MCP-compatible client (e.g., Claude for Desktop) using your API key.

Key features of MCP-Soccerdata?

  • Live football match insights with real-time updates.
  • Detailed match listings including team names, kickoff times, and scores.
  • Comprehensive match details including goal breakdowns and key events.
  • Team lineups and injury statuses.
  • Betting odds and league metadata.

Use cases of MCP-Soccerdata?

  1. Retrieving live scores and match updates.
  2. Analyzing team performance and lineups.
  3. Accessing betting odds for ongoing matches.

FAQ from MCP-Soccerdata?

  • Can MCP-Soccerdata provide data for all football leagues?

Yes! It covers a wide range of leagues and competitions worldwide.

  • Is there a cost to use MCP-Soccerdata?

No, it is open-source and free to use.

  • What programming language is MCP-Soccerdata built with?

MCP-Soccerdata is built using Python.

Content

⚽️ Soccerdata MCP Server

  • MCP-Soccerdata is an open-source Model Context Protocol (MCP) server that connects to the SoccerDataAPI to deliver up-to-date football match information via natural language interactions.

  • Designed for use with MCP-enabled clients such as Claude Desktop, it allows users to retrieve football data by leveraging large language models (LLMs).

✨ Features

🏟️ Live Football Match Insights

MCP-Soccerdata focuses on delivering real-time information about ongoing football matches around the world.

"What football matches are being played right now?"
"What are the predicted lineups for PSG vs Aston Villa today?"
"Please tell me the scores and number of goals from recent football matches."

→ Provides relevant football data in a structured format, including the detailed categories described below.

- Match Listings & Basic Info

  • Global list of all currently active matches
  • Home and away team names
  • Kickoff time and match date
  • Stadium details
  • Current score

- Match Details

  • Match status: scheduled, in progress, or finished
  • Goal breakdown: first half, second half, extra time, penalty shootout
  • Final result: win, draw, or loss

- Key Match Events

  • Goal events (who scored, when, how)
  • Substitutions
  • Yellow and red cards
  • Penalties

- Team Lineups

  • Starting XI
  • Bench players
  • Injury status
  • Team formation

- Odds & Betting Information

  • Win / Draw / Lose odds
  • Over / Under odds
  • Handicap betting odds

- League Metadata

  • League name
  • Country
  • Competition format (e.g., regular season, knockout stage)

⚠️ Focused exclusively on live, upcoming, and recently finished matches

🎥 Demo

mcp (3) (1)

🚀 Quick Start

Prerequisites

  • Python 3.12+
  • uv package manager
  • Soccerdata API account
  • MCP-compatible client (e.g., Claude for Desktop)

1. Clone and Setup

  • Clone the repository
git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data
  • Install dependencies
uv sync

2. Get Your API Key and Set Environment

  • Create a .env file with your credentials:
AUTH_KEY=your_auth_key

Sign up on https://soccerdataapi.com/ and get your own Auth keys.

3. Configure MCP Client

  • Register this server in your MCP client (e.g., Claude for Desktop).

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
      "mcp-soccer-data": {
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
              "run",
              "--env-file",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
              "server.py"
          ]
      }
  }
}

📝 License

No tools information available.
No content found.