drio
Open app

Soccer MCP Server

Source

Catalog onlyCatalog onlySTDIO

Overview

Soccer MCP Server is a Python-based server that implements the Model Context Protocol (MCP) to provide access to football statistics and live match data using the API-Football service.

To use the Soccer MCP Server, you need to set up an API key from RapidAPI, clone the repository, install dependencies, and run the server either using Docker or directly with Python.

  • Access to league data including standings, fixtures, and schedules. - Detailed player statistics and profiles. - Live match data including events and timelines. - Match analysis tools for in-depth statistics.
  1. Retrieving live match statistics for ongoing games.
  2. Accessing historical data for football leagues and teams.
  3. Analyzing player performance over different seasons.

Add to your AI client

Use these steps to connect Soccer MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "soccer-mcp-server-obinopaul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "soccer-mcp-server-obinopaul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "soccer-mcp-server-obinopaul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "soccer-mcp-server-obinopaul": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "soccer-mcp-server-obinopaul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "soccer-mcp-server-obinopaul": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-soccer-mcp-server-obinopaul"
      ]
    }
  }
}

FAQ

How do I get an API key?

You can obtain an API key by creating an account on RapidAPI and subscribing to the API-Football API.

Can I run the server without Docker?

Yes, you can run the server directly using Python after setting the necessary environment variables.

What programming language is used for the server?

The server is implemented in Python.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3450,"uuid":"e379b285-ac6a-41ef-a2fe-4562739a855b","name":"soccer-mcp-server","title":"Soccer MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/39696290?v=4","created_at":"$D2025-03-19T16:38:33.063Z","updated_at":"$D2025-03-19T16:43:33.677Z","status":"created","author_name":"obinopaul","author_avatar_url":"https://avatars.githubusercontent.com/u/39696290?v=4","tags":"soccer,football,mcp-server","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/obinopaul/soccer-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-19 11:07:26\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data