Football Live MCP

Remote MCP server that exposes live football data from API-Football over HTTP, implementing JSON-RPC 2.0 directly without any MCP SDK.

Companion to the local Football Intelligence MCP server: this one serves the current season, while the local one serves the historical database (2010-2025) stored in PostgreSQL.

Protocol

Transport: HTTP. Single endpoint, one JSON-RPC message per request.

Implemented methods: initialize, notifications/initialized, ping, tools/list, tools/call.

Protocol version: 2025-06-18.

Tools

League ids: 39 Premier League, 140 La Liga, 135 Serie A, 78 Bundesliga, 61 Ligue 1, 94 Primeira Liga, 2 UEFA Champions League.

Running locally

pip install -r requirements.txt
export API_FOOTBALL_KEY=your_key_here
python server.py                    # listens on :8080

Verify:

curl http://localhost:8080/

curl -X POST http://localhost:8080/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Deploying to Render

1. Push this directory to a GitHub repository.

2. In Render, create a New Web Service and connect that repository.

3. Render reads render.yaml; confirm runtime Python and the free plan.

4. Add the environment variable API_FOOTBALL_KEY with your API-Football key.

5. Deploy. The public endpoint will be https://<service>.onrender.com/mcp.

The free plan sleeps the service after inactivity, so the first request after a pause takes around 50 seconds. Hit GET / once before a live demo to wake it.

Using it from an MCP host

Add an entry with a url field to the host configuration:

{
  "mcpServers": {
    "football_live": { "url": "https://<service>.onrender.com/mcp" }
  }
}