Overview
What is Soccer MCP Server?
A Python server implementing the Model Context Protocol (MCP) for football (soccer) statistics and live match data, using the API-Football service via RapidAPI.
How to use Soccer MCP Server?
Set the RAPID_API_KEY_FOOTBALL environment variable with your RapidAPI key. Run the server with python soccer_server.py or mcp run soccer-server.py. For Claude Desktop, configure via Docker (build and run the container) or direct Python execution, adding an entry to claude_desktop_config.json.
Key features of Soccer MCP Server
- League data: standings, fixtures, schedules
- Team information and fixtures
- Player statistics and profiles
- Live match data and real-time timelines
- Match analysis with statistics and events
- 30‑second timeout and graceful shutdown
Use cases of Soccer MCP Server
- Retrieve league standings for multiple leagues and seasons
- Look up player profiles and statistics by season and league
- Get live in‑game stats and events for a specific team
- Fetch past or upcoming fixtures for a team within a date range
- Analyze detailed match statistics and events for one or more fixtures
FAQ from Soccer MCP Server
What API key do I need?
An API key from RapidAPI for the API-Football service. Set it as the environment variable RAPID_API_KEY_FOOTBALL.
How do I install dependencies?
Install the required packages from requirements.txt using pip install -r requirements.txt.
How is the server run?
It runs as a standalone service using Fast MCP. Start it with python soccer_server.py or mcp run soccer-server.py.
How do I shut down the server gracefully?
Signal handlers are implemented; press Ctrl+C for a graceful shutdown.
Can I get live match data for a specific team?
Yes, use tools like get_live_match_for_team, get_live_stats_for_team, and get_live_match_timeline by providing the team name.
