aria-mcp-football
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FOLLOW_TEAMS | No | Comma-separated TheSportsDB team IDs to follow (default: '133906,133899,133610' — Denmark, AGF, Chelsea). | |
| THESPORTSDB_KEY | No | TheSportsDB API key. Defaults to '123' (public free dev key). Set your own or a premium key if needed. | |
| BROADCAST_MAP_JSON | No | JSON object overriding the Danish broadcast hint map (keys: competition name pattern, values: broadcaster string). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_my_fixturesA | Get upcoming fixtures (matches) for all followed football teams within the next N days. Default followed teams: Denmark (national), AGF (Danish Superliga), Chelsea (Premier League). Override via FOLLOW_TEAMS env (comma-separated TheSportsDB team IDs). Each fixture includes team, opponent, home/away, competition, kick-off time (UTC and Europe/Copenhagen local), venue, status, and a best-effort Danish broadcaster hint. Sorted by kick-off time ascending. This is the primary tool for ARIA's daily check — call this once to see if any followed team plays soon. Note: danishBroadcast is a best-effort hint; rights change — verify at tvsporten.dk / tvbolden.dk. |
| get_team_fixturesA | Get upcoming fixtures or recent results for any football team, by name or TheSportsDB team ID. When 'last' is provided, returns the last N finished matches instead of a date range. Returns fixture entries (kickoff, competition, venue, status, broadcast hint) or result entries (score, outcome) if last is set. Note: danishBroadcast is a best-effort hint; rights change — verify at tvsporten.dk / tvbolden.dk. |
| get_resultsA | Get recent finished match results (with scores) for a followed team or all followed teams. Returns results sorted newest-first with score and win/draw/loss outcome. Useful for checking how a team did in their last few matches. |
| live_nowA | Check if any followed football team is currently playing. Live scores require a premium TheSportsDB key — on the free key this returns a structured unavailable notice. Returns live match entries with current score on premium tier, or { status: 'unavailable', message: '...' } on free tier. Note: danishBroadcast is a best-effort hint; rights change — verify at tvsporten.dk / tvbolden.dk. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Tools are mostly distinct: get_my_fixtures for upcoming followed teams, get_results for past followed teams, get_team_fixtures for any team (upcoming or past), live_now for current matches. However, get_team_fixtures with 'last' can overlap with get_results for followed teams, causing potential confusion.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_my_fixtures, live_now). No mix of styles or abbreviations, ensuring predictability.
4 tools are well-suited for the football match info domain. Each tool serves a distinct purpose (upcoming, past, live, generic team query), without being too few or excessive.
The tool set covers the core match lifecycle (upcoming, results, live) for both followed and general teams. Missing are tools for managing followed teams (env variable only) and broader football data like standings or player info, but these are beyond the stated scope.