⚽️ Soccerdata MCP Server
@yeonupark
About ⚽️ Soccerdata MCP Server
An MCP server that provides real-time football data based on the SoccerDataAPI.
Basic information
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
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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.
More Data & Analytics MCP servers
PubMed Analysis MCP Server
DarkroasterA PubMed MCP server.
Healthcare MCP Server
CicatriizA Model Context Protocol (MCP) server providing AI assistants with access to healthcare data and medical information tools, including FDA drug info, PubMed, medRxiv, NCBI Bookshelf, clinical trials, ICD-10, DICOM metadata, and a medical calculator.
ArXiv MCP Server
blazickjpA Model Context Protocol server for searching and analyzing arXiv papers
Google Ads MCP
cohnenAn MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th
HubSpot MCP Server
baryhuangA Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.
Comments