⚽ Football Data MCP Server
A Model Context Protocol (MCP) server that gives AI assistants (GitHub Copilot, Claude, etc.) real-time access to football (soccer) data via the football-data.org API.
🏟️ Live scores • 📊 Standings • 👤 Players • ⚽ Top scorers • 🏆 50+ leagues worldwide
📦 Packages
| Package | Description | Docs |
|---|---|---|
football-data-mcp-server | MCP server (npm package, standalone CLI) | Server README |
football-data-mcp-extension | VS Code extension (one-click install) | Extension README |
🛠️ MCP Tools (9 Total)
| Tool | Description |
|---|---|
fb_list_competitions | List available leagues, cups, and tournaments |
fb_get_competition | Get competition details |
fb_get_matches | Get matches by competition, date, status, or matchday |
fb_get_match | Get detailed match info with scores and referees |
fb_get_standings | League table with points, goals, form |
fb_get_team | Team info, squad, coach, venue |
fb_get_team_matches | Team's upcoming and past matches |
fb_get_player | Player profile and statistics |
fb_get_scorers | Top scorers by competition |
🏁 Quick Start
Option 1: VS Code Extension (Recommended)
- Install the extension from VS Code Marketplace
- Set your API key in VS Code settings: Football Data MCP > API Key
- Get a free API key at football-data.org
- Start chatting with your AI assistant about football!
Option 2: Standalone MCP Server
npm install -g football-data-mcp-server
{
"mcpServers": {
"football-data": {
"command": "football-data-mcp-server",
"env": {
"FOOTBALL_MCP_API_KEY": "your-api-key"
}
}
}
}