⚽️ 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
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.
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
dbt MCP Server
dbt-labsA MCP (Model Context Protocol) server for interacting with dbt.
MCP Simple PubMed
andybrandtMCP server for searching and querying PubMed medical papers/research database
Deep Research
u14appUse any LLMs (Large Language Models) for Deep Research. Support SSE API and 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.
MCP From Zero: Quick Data
dislerPrompt focused MCP Server for .json and .csv agentic data analytics for Claude Code
Comments