MCP.so
Sign In

⚽️ Soccerdata MCP Server

@yeonupark

Repository

About ⚽️ Soccerdata MCP Server

An MCP server that provides real-time football data based on the SoccerDataAPI.

Basic information

Category

Data & Analytics

License

MIT

Runtime

python

Transports

stdio

Publisher

yeonupark

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.

Comments

More Data & Analytics MCP servers

ArXiv MCP Server

blazickjp

A Model Context Protocol server for searching and analyzing arXiv papers

2.9K

Deep Research

u14app

Use any LLMs (Large Language Models) for Deep Research. Support SSE API and MCP server.

4.6K

MCP From Zero: Quick Data

disler

Prompt focused MCP Server for .json and .csv agentic data analytics for Claude Code

149

mcp-simple-arxiv

andybrandt

Tool to work with arXiv, provide LLM with ability to search and read papers from there

199

Bright Data MCP

luminati-io

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K