SoccerDataAPI

SoccerDataAPI

This MCP server provides real-time football match data based on the SoccerDataAPI.

24
Stars
7
Forks
0
Releases

Overview

Soccerdata MCP Server is an open-source MCP server that connects to SoccerDataAPI to deliver up-to-date football match information through natural language interactions. It is designed for use with MCP-enabled clients like Claude Desktop, enabling users to retrieve football data by leveraging large language models (LLMs). The server focuses on live football insights and provides a comprehensive data set including: live match listings with home and away teams, kickoff times, stadium details, and current scores; match details such as status (scheduled, in progress, finished), goal breakdown (first half, second half, extra time, penalties), and final result; key events including goals, substitutions, yellow and red cards, and penalties; team lineups (Starting XI, bench players, injuries, formations); odds and betting information (win/draw/lose, over/under, handicaps); and league metadata (league name, country, competition format). It concentrates on live, upcoming, and recently finished matches and exposes a get_livescores() tool for real-time query responses. Quick-start guidance covers dependencies, obtaining an API key, and configuring the MCP client.

Details

Owner
yeonupark
Language
Python
License
MIT License
Updated
2025-12-07

Features

Live Football Match Insights

Provides real-time information about ongoing football matches around the world.

Match Listings & Basic Info

Global list of active matches, home/away team names, kickoff times, stadium details, and current score.

Match Details

Includes match status (scheduled, in progress, finished), goal breakdown, and final result.

Key Match Events

Captures goal events, substitutions, yellow/red cards, and penalties.

Team Lineups

Provides Starting XI, bench players, injury status, and team formation.

Odds & Betting Information

Offers win/draw/lose odds, over/under odds, and handicap betting odds.

League Metadata

Includes league name, country, and competition format.

Audience

MCP-enabled clientsUse LLMs to fetch real-time football data via natural language queries.

Tags

footballsoccerlive scoresreal-time dataMCPSoccerDataAPIlineupseventsoddsleague metadata