Skip to main content

football-api-mcp

MCP server for football-data.org API. Built on football-api.

Setup

pip install football-api-mcp

Get a free API key at football-data.org.

Claude Desktop

Add to claude_desktop_config.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

Metadata

Release files for football-api-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for football-api-mcp 0.1.0
File Size Uploaded
football_api_mcp-0.1.0.tar.gz 7.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for football-api-mcp 0.1.0
File Interpreter ABI Platform
football_api_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 12.6 kB

Release files / football_api_mcp-0.1.0.tar.gz

Download URL football_api_mcp-0.1.0.tar.gz
Size 7.5 kB
Tags Source
SHA-256 checksum
How to use checksums
859088dc319deb904fe1da60a0dc46b70228e3b5f01bb6e79be1eeeabecf143f
BLAKE2b-256 checksum
How to use checksums
1a5d31a81b70a9c8e063421bbf116bbbcb6533f2ef2eaaee7273c65930249bfc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / football_api_mcp-0.1.0-py3-none-any.whl

Download URL football_api_mcp-0.1.0-py3-none-any.whl
Size 5.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2b60a5ff3d82679c8623be0db7c715e3a9334a97221a8a70c949df81c9729360
BLAKE2b-256 checksum
How to use checksums
c80a3942521de931db89daf1b3b56fe20d62bd28542e165179c2e4ca7ad49f0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page