A Python server implementing Model Context Protocol (MCP) for football (soccer) statistics and live match data using the API-Football service.
A Python server implementing Model Context Protocol (MCP) for football (soccer) statistics and live match data using the API-Football service.
This server provides a comprehensive set of tools for accessing football data through the API-Football API. It serves as a bridge between applications and football data services, offering both live match information and historical statistics for leagues, teams, and players worldwide.
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| get_league_id_by_name | Retrieve the league ID for a given league name |
| Example | get_live_match_timeline(team_name="Manchester City") |
| get_all_leagues_id | Retrieve a list of all football leagues with IDs |
| get_standings | Retrieve league standings for multiple leagues and seasons |
| get_league_info | Retrieve information about a specific football league |
| get_league_fixtures | Retrieves all fixtures for a given league and season |
| get_league_schedule_by_date | Retrieves the schedule for a league on specified dates |
| get_player_id | Retrieve player IDs and information for players matching a name |
| get_player_profile | Retrieve a player's profile by their last name |
| get_player_statistics | Retrieve detailed player statistics by seasons and league name |
| get_player_statistics_2 | Retrieve detailed player statistics by seasons and league ID |
| get_team_fixtures | Returns past or upcoming fixtures for a team |
| get_team_fixtures_by_date_range | Retrieve fixtures for a team within a date range |
| get_team_info | Retrieve basic information about a specific team |
| get_fixture_statistics | Retrieves detailed statistics for a specific fixture |
| get_fixture_events | Retrieves all in-game events for a fixture (goals, cards, subs) |
| get_multiple_fixtures_stats | Retrieves statistics for multiple fixtures at once |
| get_live_match_for_team | Checks if a team is currently playing live |
| get_live_stats_for_team | Retrieves live in-game stats for a team in a match |
| get_live_match_timeline | Retrieves real-time timeline of events for a team's live match |
{
"mcpServers": {
"soccer_server": {
"command": "docker",
"args": [
"exec",
"-i",
"soccer_server",
"python",
"soccer_server.py"
],
"env": {
"RAPID_API_KEY_FOOTBALL": "YOUR_RAPID_API_KEY_FOOTBALL"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| RAPID_API_KEY_FOOTBALL | Declared in the maintainer’s client configuration. | Check documentation |
Enables language models to access and query athlete activity data from the Strava API.
Enables interaction with the Strava API through a Model Context Protocol (MCP) server.
Read-only access to your PumpX workout log: sessions, lift history, PRs, routines, measurements.
A Model Context Protocol (MCP) server that integrates Strava with Claude for Desktop, enabling AI-powered analysis of your fitness activities.
Schedule workouts from the MoveMate exercise library and review history, PRs and progression.
Read sleep, readiness, activity, stress, heart rate and workouts from the Oura Ring.