⚽️ Soccerdata MCP Server
@yeonupark
About ⚽️ Soccerdata MCP Server
An MCP server that provides real-time football data based on the SoccerDataAPI.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-soccer-data": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@yeonupark/mcp-soccer-data",
"--client",
"claude"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
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.
Frequently asked questions
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.
Basic information
More Data & Analytics MCP servers
ScrapeCheck
FieldmodeLLCVerify scraped data against the live source page. Signed verdicts, $0.01 via x402.
Batru
BatruReal, calibrated win-rate predictions, pick recommendations, counters, synergy and tier lists for Dota 2, Deadlock and Marvel Rivals, from production models trained on ~20M matches. Free hosted endpoint (Streamable HTTP)
SportsTrackLive
STL SolutionsSportsTrackLive is a remote MCP server available at https://mcp.sportstracklive.com. SportsTrackLive is a Live Tracking solution and let you record, share and relive your Tracks! SportsTrackLive provide a real-time tra
Context.dev
Yahia BakourContext.dev is the web-data infrastructure for AI products and agents, one API that turns the web into clean, structured, LLM-ready data. MCP available at https://mcp.context.dev.
Bounce Watch - Company Signal Intelligence
bouncewatchBounce Watch tells you what just changed at a company, and when. Who raised money. Who hired a senior person. Who opened an office, won a customer, or announced a partnership. Every event carries its own date, so you ca
Comments