aria-mcp-football

A Model Context Protocol (MCP) server that tells you when your favourite football teams play and where to watch in Denmark. Built for ARIA and shareable with the community.

Data from TheSportsDB.com. No API key required for basic use — the free public dev key (123) is built in.

Data Source

Danish broadcast information is a best-effort hint built into this server. TheSportsDB does not provide broadcaster data — the hints are researched defaults for the 2025/26 season. Rights change. Always verify at tvsporten.dk or tvbolden.dk.

Related MCP server: OPTA API Documentation MCP Server

Install & Run

npx aria-mcp-football

Or install globally:

npm install -g aria-mcp-football
aria-mcp-football

No API key required. Optionally set THESPORTSDB_KEY for a premium key.

Requires Node.js 20 or later.

Environment Variables

Default Followed Teams

Override via FOLLOW_TEAMS=133906,133899,133610 (or any other TheSportsDB team IDs).

Tools

get_my_fixtures

Get upcoming fixtures for all followed teams within the next N days. This is the primary tool for ARIA's daily check.

Parameters:

Returns:

{
  "followedTeams": ["Denmark (id:133906)", "AGF (id:133899)", "Chelsea (id:133610)"],
  "daysAhead": 14,
  "count": 2,
  "fixtures": [
    {
      "team": "AGF Aarhus",
      "opponent": "Viborg",
      "homeAway": "home",
      "competition": "Danish Superliga",
      "kickoffUtc": "2026-06-27T19:00:00.000Z",
      "kickoffLocal": "2026-06-27T21:00:00",
      "venue": "Ceres Park",
      "status": "Not Started",
      "danishBroadcast": "TV 2 Play / Viaplay"
    }
  ],
  "broadcastNote": "danishBroadcast is a best-effort hint. Rights change — verify at tvsporten.dk / tvbolden.dk."
}

get_team_fixtures

Get upcoming fixtures or recent results for any football team by name or TheSportsDB team ID.

Parameters:

get_results

Get recent finished match results with scores for a followed team or all followed teams.

Parameters:

Returns:

{
  "count": 1,
  "results": [
    {
      "team": "Chelsea",
      "opponent": "Arsenal",
      "homeAway": "home",
      "competition": "Premier League",
      "kickoffUtc": "2025-08-10T14:00:00.000Z",
      "score": "2 - 1",
      "outcome": "W"
    }
  ]
}

live_now

Check if any followed team is currently playing. Live scores require a premium TheSportsDB key. On the free key (123) this returns a structured unavailable notice:

{
  "status": "unavailable",
  "message": "Live-resultater kræver en premium TheSportsDB-nøgle."
}

Parameters: None

Danish Broadcast Hints (2025/26 defaults)

Override the entire map via BROADCAST_MAP_JSON='{"premier league":"MyTV"}'.

These are best-effort hints. Rights change. Always verify at tvsporten.dk or tvbolden.dk.

ARIA MCP Config

Add to your ARIA credentials / MCP config to use with ARIA:

{
  "Name": "Football",
  "Command": "npx",
  "Args": ["-y", "aria-mcp-football"],
  "Env": {}
}

No key is required. If you have a premium TheSportsDB key you can optionally add:

{
  "Name": "Football",
  "Command": "npx",
  "Args": ["-y", "aria-mcp-football"],
  "Env": {
    "THESPORTSDB_KEY": "your_premium_key_here"
  }
}

Note: THESPORTSDB_KEY is not a secret — the default (123) is a public free key. Only use secret: prefix in ARIA if you want to protect a personal premium key.

Development

git clone https://github.com/kimhjort/aria-mcp-football
cd aria-mcp-football
npm install
npm run build
npm test

Run the server:

node dist/index.js

License

MIT — see LICENSE.

Data from TheSportsDB.com.