MCP Football Server

MCP Football Server is a lightweight Model Context Protocol (MCP) tool server that provides football (soccer) data to clients and AI assistants via API-Football. Designed for sports analysts and general users, it enables real-time access to fixtures, standings, teams, players, and more.

Features

MCP Football Server exposes a suite of tools that an AI or application can call to fetch football data. Key features include:

• Fixtures by date

• League standings

• Team and player info

• Transfers, injuries, head-to-head

• Easy integration with MCP clients

Setup (Local Server)

1. Clone & install dependencies

   git clone https://github.com/yalmeidarj/mcp-football-server.git
   cd mcp-football-server
   npm install

2. Start in development

   npm run dev

3. Or build for production

   npm run build
   npm start

The server communicates via STDIN/STDOUT using MCP JSON-RPC. The build step transpiles source files into the build/ directory, and npm start runs the compiled server GitHub. After building, you can also use the football command (defined as a binary in the package) to start the server GitHub.

Client Setup (Claude Desktop)

To use with Claude Desktop:

• Add the following to your claude_desktop_config.json:

  {
    "mcpServers": {
      "football": {
        "command": "node",
        "args": ["<path_to>/build/main.js"],
        "env": {
          "RAPIDAPI_KEY": "<your_rapidapi_key>",
          "RAPIDAPI_HOST": "api-football-v1.p.rapidapi.com"
        }
      }
    }
  }

Claude will launch the server automatically and use its tools for football-related queries.

Tech Stack

• Node.js + TypeScript

• MCP SDK for stdio-based tool serving

• node-fetch for API calls

• Zod for parameter validation

License

Released under the ISC License.