Soccer MCP Server logo

Soccer MCP Server

by obinopaul

A Python server implementing the Model Context Protocol (MCP) for accessing football statistics and live match data from the API-Football service. It acts as a bridge between applications and football data, providing comprehensive access to leagues, teams, and players worldwide.

View on GitHub

Last updated: N/A

What is Soccer MCP Server?

This server is a Python implementation of the Model Context Protocol (MCP) designed to provide access to football (soccer) data via the API-Football API. It enables applications to retrieve live match information and historical statistics for leagues, teams, and players globally.

How to use Soccer MCP Server?

To use the server, you need an API key from RapidAPI for the API-Football service. Configure the server by setting the RAPID_API_KEY_FOOTBALL environment variable. The server can be run directly using Python or within a Docker container. Example usage is provided for each tool, demonstrating how to retrieve specific data like league standings, player profiles, and live match events.

Key features of Soccer MCP Server

  • Access to league data (standings, fixtures, schedules)

  • Team information and fixtures retrieval

  • Player statistics and profiles access

  • Live match data (events, statistics, timelines)

  • Match analysis capabilities

Use cases of Soccer MCP Server

  • Building applications that display live football scores and statistics

  • Creating tools for analyzing player performance and team strategies

  • Developing interfaces for accessing historical football data

  • Integrating football data into chatbots or virtual assistants

FAQ from Soccer MCP Server

What API is used for football data?

The server uses the API-Football API via RapidAPI.

How do I configure the API key?

Set the RAPID_API_KEY_FOOTBALL environment variable with your API key.

Can I retrieve live match data?

Yes, the server provides tools for accessing live match events, statistics, and timelines.

Is Docker support available?

Yes, the README provides instructions for running the server within a Docker container.

What data can I retrieve for a specific player?

You can retrieve a player's profile, statistics by season and league, and player ID.