⚽️ Soccerdata MCP Server

What is ⚽️ Soccerdata MCP Server?

An open-source Model Context Protocol (MCP) server that connects to the SoccerDataAPI to deliver up‑to‑date football match information through natural language interactions. It is designed for MCP‑enabled clients such as Claude Desktop, enabling users to query live match data via large language models.

How to use ⚽️ Soccerdata MCP Server?

Install via Smithery (npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude), or clone the repository, install dependencies with uv sync, set your API key in a .env file, and register the server in your MCP client’s configuration (e.g., claude_desktop_config.json). The server exposes a single tool, get_livescores(), which returns real‑time information about ongoing matches worldwide.

Key features of ⚽️ Soccerdata MCP Server

• Live match listings with team names, scores, and kickoff times
• Detailed match status (scheduled, in progress, finished)
• Goal breakdowns by half, extra time, and penalties
• Key events: goals, substitutions, cards, penalties
• Starting XI, bench players, injuries, and formations
• Win/Draw/Lose, Over/Under, and handicap betting odds
• League metadata (name, country, competition format)

Use cases of ⚽️ Soccerdata MCP Server

• Ask “What football matches are being played right now?” and get a global list
• Query predicted lineups and formations for a specific upcoming match
• Retrieve final scores and goal details for recently finished matches
• Get live betting odds for ongoing or scheduled games
• Obtain league context (e.g., competition stage, country) for any match

FAQ from ⚽️ Soccerdata MCP Server

What data does ⚽️ Soccerdata MCP Server provide?

It provides real‑time information on currently active, upcoming, and recently finished football matches, including lineups, key events, scores, odds, and league metadata.

Does the server support historical match data?

No. The server focuses exclusively on live, upcoming, and recently finished matches; historical data is not available.

What are the runtime requirements?

Python 3.12 or later, the uv package manager, a SoccerDataAPI account, and an MCP‑compatible client (e.g., Claude for Desktop).

How do I obtain an API key?

Sign up at https://soccerdataapi.com/ to get an authentication key, then store it in a .env file as AUTH_KEY=your_auth_key.

Is the server open source and how is it licensed?

Yes, it is open source under the MIT License. The source code is available on GitHub.