Soccer MCP Server
obinopaulLABSCO SUMMARY
A thin, honest wrapper over one good data source.
There is nothing clever here and that is fine — API-Football is the data, and the value is having it reachable mid-conversation rather than in a separate tab. The one thing to plan for is your RapidAPI quota, since a curious assistant will make more calls than you expect.
What it is
A lightweight Node.js MCP server that fronts API-Football, so an assistant can answer match and league questions with live data instead of stale training knowledge. Parameters are validated with Zod before a request goes out, and the server communicates over stdio.
What you get
Fixtures for a given date, league standings, team and player information, transfer records, injury lists and head-to-head history between two sides — each exposed as a tool the client can call directly.
Requirements
An API-Football key through RapidAPI: RAPIDAPI_KEY, with RAPIDAPI_HOST set to api-football-v1.p.rapidapi.com. Node.js and TypeScript; from a clone, npm install then either npm run dev or npm run build and npm start. The client entry points at build/main.js, and the package also installs a football binary that starts the server.
Setup effort
Build from source — git clone https://github.com/yalmeidarj/mcp-football-server.git
USE CASES
01
Checking what is on today
Pull fixtures for a date and read the schedule without opening a results site.
02
Settling an argument about form
Read the current standings and the head-to-head record between two sides.
03
Checking a squad before a match
Look up the team, its players and the current injury list.
BEFORE YOU INSTALL
What to know first
Requires
RAPIDAPI_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/yalmeidarj/mcp-football-server.git
cd mcp-football-server
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"football": {
"command": "node",
"args": [
"<YOUR_PATH_TO>/build/main.js"
],
"env": {
"RAPIDAPI_KEY": "<YOUR_RAPIDAPI_KEY>",
"RAPIDAPI_HOST": "api-football-v1.p.rapidapi.com"
}
}
}
}
