Skip to main content
Glama
leandersen

mcp-football

by leandersen
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FOOTBALL_DATA_TOKENYesYour football-data.org API token.

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
todays_matchesA
This tool, todays_matches, sends a httpx get request to https://api.football-data.org/v4/matches, 
and pulls various data on todays soccer matches (games). This is good to use in case a user wants to know 
what the schedule and score of soccer games is today.

Available competitions: | WC | FIFA World Cup
                        | CL | UEFA Champions League
                        | BL1 | Bundesliga
                        | DED | Eredivisie
                        | BSA | Campeonato Brasileiro Série A
                        | PD | Primera Division
                        | FL1 | Ligue 1
                        | ELC | Championship
                        | PPL | Primeira Liga
                        | EC | European Championship
                        | SA | Serie A
                        | PL | Premier League

input: None
output: a list containing entries with info on home/away 
        team, score, date, status (game in play, timed, 
        finished), winner (None if not finished), the event 
        (like world cup), and current match day of the season/event.
competition_top_scorersA
This function, competition_top_scorers sends a httpx request to:
    https://api.football-data.org/v4/competitions/{competition_code}/scorers 
    to find the total scorers in the specified competition.

Please note that only the following competitions are included, and using any 
other competition code will result in an error. Use the following competition 
codes only:
    | WC | FIFA World Cup
    | CL | UEFA Champions League
    | BL1 | Bundesliga
    | DED | Eredivisie
    | BSA | Campeonato Brasileiro Série A
    | PD | Primera Division
    | FL1 | Ligue 1
    | ELC | Championship
    | PPL | Primeira Liga
    | EC | European Championship
    | SA | Serie A
    | PL | Premier League

Input: 
    competition_code - the league/tournament that we want to pull scorers from.

Output: a list containing entries about scorers 
        of the day including the following features:
            'event', 'player_name', 'player_num',
            'player_position', 'player_team', 'player_goals'
            'player_assists', 'player_penalties'

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one retrieves top scorers for a competition, the other fetches today's matches. There is no overlap or ambiguity.

Naming Consistency4/5

Both tool names use a descriptive, snake_case format similar to 'noun_verb' or 'adjective_noun'. The apostrophe in 'todays_matches' is a minor inconsistency, but overall naming is consistent.

Tool Count2/5

Only two tools for a football data server is too few. Typical football APIs cover many more endpoints such as team info, standings, player stats, match details, etc. The tool count is insufficient for the domain's scope.

Completeness2/5

The server provides only two operations: top scorers and today's matches. Lacks essential features like team lookup, league tables, player season stats, match details by ID, and historical data. Significant gaps in coverage.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources