Soccer MCP Server

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.