Metadata-Version: 2.4
Name: football-api-mcp
Version: 0.1.0
Summary: MCP server exposing football-data.org API via the football-api client
Project-URL: Homepage, https://github.com/ice1x/football-api-mcp
Project-URL: Repository, https://github.com/ice1x/football-api-mcp
Project-URL: Issues, https://github.com/ice1x/football-api-mcp/issues
Author-email: ice1x <ilia.iakhin@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: api,football,football-data,mcp,soccer
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: football-api>=0.1.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# football-api-mcp

MCP server for [football-data.org](https://www.football-data.org/) API. Built on [football-api](https://pypi.org/project/football-api/).

## Setup

```bash
pip install football-api-mcp
```

Get a free API key at [football-data.org](https://www.football-data.org/client/register).

## Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "football-data": {
      "command": "python",
      "args": ["-m", "football_api_mcp"],
      "env": {
        "FOOTBALL_DATA_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `get_standings` | League table |
| `get_matches` | Matches by date/status |
| `get_competition_matches` | Matches in a competition |
| `get_team` | Team info |
| `get_team_matches` | Team's matches |
| `get_scorers` | Top scorers |
| `get_person` | Player/coach info |

Competition codes: `PL` `BL1` `SA` `FL1` `PD` `CL` `EC` `WC` `ELC` `PPL` `DED` `BSA`

## License

MIT
