# Football Data [Health: Active]

**Category:** 🏃 Sports  
**Repository:** https://github.com/pipeworx-io/mcp-football-data  
**GitHub Stars:** 2  
**npm Downloads (last month):** 768  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/football-data

## Description
Football-Data.org MCP — soccer competitions, matches, standings

## Tools
Capabilities this server exposes over MCP:

- **list_competitions** — List competitions accessible on your plan. Free tier: 12 majors. Use the returned `code` (e.g., "PL", "PD", "CL") for downstream calls.
- **get_competition_matches** — List matches in a competition. Filter by status (SCHEDULED, LIVE, IN_PLAY, PAUSED, FINISHED, POSTPONED, SUSPENDED, CANCELLED), date range, matchday, stage, or season year.
- **get_competition_standings** — League table for a competition season. Returns total / home / away tables.
- **get_team** — Team detail by ID — current squad, coach, competitions, venue.
- **get_team_matches** — A team's matches across competitions. Filter by status, date range, competitions, season, or venue.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "football-data": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-football-data"],
    "env": {
      "PLATFORM_FOOTBALL_DATA_KEY": ""
    }
  }
}
```

**Requires environment variables:** `PLATFORM_FOOTBALL_DATA_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Football Data MCP server does

Football Data MCP server exposes selected football-data.org v4 data through the Model Context Protocol. It covers soccer competitions, matches, standings, and teams. Agents can use the server to discover competitions, retrieve fixtures for a competition or team, inspect standings, and fetch team information.

The available domain tools are `list_competitions`, `get_competition_matches`, `get_competition_standings`, `get_team`, and `get_team_matches`. Match queries support filters such as status, date range, matchday, stage, season, venue, and result limits where applicable.

## How it works

The hosted option uses the Pipeworx gateway at `https://gateway.pipeworx.io/football-data/mcp`. The gateway forwards requests to `https://api.football-data.org/v4/` and authenticates upstream calls with the `X-Auth-Token` header. A hosted connection also exposes shared Pipeworx meta-tools, including `ask_pipeworx`, `discover_tools`, `search_within`, and memory-related tools. The exact tool scope is reported by the connection's `initialize` response.

The same data can be accessed through the full Pipeworx gateway at `https://gateway.pipeworx.io/mcp`. In either hosted configuration, `ask_pipeworx` can route a plain-language question to an appropriate catalog tool. Direct HTTP calls are also available through endpoints such as `/v1/tools/list_competitions`.

For a gateway-free setup, install or run `@pipeworx/mcp-football-data` with `npx`. The local process communicates over stdin and stdout and exposes only the football-data tools, without the gateway's shared meta-tools.

## Setup and configuration

Add the hosted MCP URL to a compatible client:

```json
{
  "mcpServers": {
    "football-data": {
      "url": "https://gateway.pipeworx.io/football-data/mcp"
    }
  }
}
```

The hosted gateway accepts the `PLATFORM_FOOTBALL_DATA_KEY` platform credential. Alternatively, requests can include an API token as `?_apiKey=<token>` after registering with football-data.org. The README identifies the upstream free account limit as 10 requests per minute.

For local stdio use, configure the package command:

```json
{
  "mcpServers": {
    "football-data": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-football-data"]
    }
  }
}
```

## Tools and capabilities

Football Data MCP server includes these tools:

- `list_competitions()` lists available competitions.
- `get_competition_matches(...)` retrieves competition matches with optional status, date, matchday, stage, and season filters.
- `get_competition_standings(...)` retrieves standings, optionally narrowed by season or matchday.
- `get_team(team_id)` retrieves data for a team by ID.
- `get_team_matches(...)` retrieves a team's matches with status, date, venue, season, and limit filters.

## Limitations and notes

The hosted endpoint lists more tools than the five football-specific tools because shared Pipeworx meta-tools are included. The local package does not include those shared tools. The project is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/football-data/readme_