mcp-soccer-data

• 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).

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.

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

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

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

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

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

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

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

To install Amadeus MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude

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

• Clone the repository

git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data

• Install dependencies

uv sync

• Create a .env file with your credentials:

AUTH_KEY=your_auth_key

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

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

The follwing tool is exposed to MCP clients:

-> Returns real-time information about ongoing football matches around the world.

• This project is licensed under the MIT License. See the LICENSE file for details.
• Built with Model Context Protocol