Skip to main content
Glama
Sportmonks MCP Server

Sportmonks MCP Server

by ferasbbm

Sportmonks MCP Server

A Model Context Protocol (MCP) server for the Sportmonks Football API v3. Exposes 150+ tools covering every endpoint — fixtures, leagues, teams, players, odds, predictions, standings, transfers, and more.

Setup

1. Install dependencies

npm install

2. Get your API token

Create a free token at MySportmonks.

3. Set environment variable

export SPORTMONKS_API_TOKEN=your_token_here

4. Run the server

node src/index.js

Related MCP server: Soccer V3 Scores MCP Server

Connect to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sportmonks": {
      "command": "node",
      "args": ["/absolute/path/to/sportmonks-mcp/src/index.js"],
      "env": {
        "SPORTMONKS_API_TOKEN": "your_token_here"
      }
    }
  }
}

Connect to Cursor

Edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "sportmonks": {
      "command": "node",
      "args": ["/absolute/path/to/sportmonks-mcp/src/index.js"],
      "env": {
        "SPORTMONKS_API_TOKEN": "your_token_here"
      }
    }
  }
}

Available Tools (150+)

Livescores

Tool

Description

get_inplay_livescores

All fixtures currently being played

get_all_livescores

Fixtures 15 min before/after match

get_latest_livescores

Livescores updated in last 10 seconds

Fixtures

Tool

Description

get_all_fixtures

All fixtures (paginated)

get_fixture_by_id

Single fixture by ID

get_fixtures_by_multiple_ids

Up to 50 fixtures by IDs

get_fixtures_by_date

Fixtures on a date

get_fixtures_by_date_range

Fixtures in a date range (max 100 days)

get_fixtures_by_date_range_for_team

A team's fixtures in a date range

get_fixtures_head_to_head

Head-to-head between two teams

search_fixtures_by_name

Search by name

get_upcoming_fixtures_by_market_id

Upcoming fixtures for an odds market

get_upcoming_fixtures_by_tv_station_id

Upcoming fixtures on a TV station

get_past_fixtures_by_tv_station_id

Past fixtures on a TV station

get_latest_updated_fixtures

Fixtures updated in last 10 seconds

Leagues

Tool

Description

get_all_leagues

All leagues (paginated)

get_league_by_id

Single league by ID

get_leagues_live

Leagues with live fixtures

get_leagues_by_fixture_date

Leagues with fixtures on a date

get_leagues_by_country_id

Leagues in a country

search_leagues_by_name

Search by name

get_leagues_by_team_id

All leagues for a team (historical)

get_current_leagues_by_team_id

Current leagues for a team

Seasons

get_all_seasons · get_season_by_id · get_seasons_by_team_id · search_seasons_by_name · get_brackets_by_season_id

Stages

get_all_stages · get_stage_by_id · get_stages_by_season_id · search_stages_by_name

Rounds

get_all_rounds · get_round_by_id · get_rounds_by_season_id · search_rounds_by_name

Standings

get_all_standings · get_standings_by_season_id · get_standings_by_round_id · get_standing_corrections_by_season_id · get_live_standings_by_league_id · get_grouped_standings_by_round_id

Topscorers

get_topscorers_by_season_id · get_topscorers_by_stage_id

Statistics

get_season_statistics_by_participant · get_stage_statistics_by_id · get_round_statistics_by_id

Schedules

get_schedules_by_season_id · get_schedules_by_team_id · get_schedules_by_season_and_team

Teams

get_all_teams · get_team_by_id · get_teams_by_country_id · get_teams_by_season_id · search_teams_by_name

Players

get_all_players · get_player_by_id · get_players_by_country_id · search_players_by_name · get_last_updated_players

Team Squads

get_team_squad · get_extended_team_squad · get_team_squad_by_season

Coaches

get_all_coaches · get_coach_by_id · get_coaches_by_country_id · search_coaches_by_name · get_last_updated_coaches

Referees

get_all_referees · get_referee_by_id · get_referees_by_country_id · get_referees_by_season_id · search_referees_by_name

Transfers

get_all_transfers · get_transfer_by_id · get_latest_transfers · get_transfers_by_date_range · get_transfers_by_team_id · get_transfers_by_player_id

Transfer Rumours

get_all_transfer_rumours · get_transfer_rumour_by_id · get_transfer_rumours_by_date_range · get_transfer_rumours_by_team_id · get_transfer_rumours_by_player_id

Venues

get_all_venues · get_venue_by_id · get_venues_by_season_id · search_venues_by_name

Odds (Standard Pre-match)

get_all_prematch_odds · get_prematch_odds_by_fixture_id · get_prematch_odds_by_fixture_and_bookmaker · get_prematch_odds_by_fixture_and_market · get_last_updated_prematch_odds

Odds (Inplay)

get_all_inplay_odds · get_inplay_odds_by_fixture_id · get_inplay_odds_by_fixture_and_bookmaker · get_inplay_odds_by_fixture_and_market · get_last_updated_inplay_odds

Odds (Premium)

get_all_premium_odds · get_premium_odds_by_fixture_id · get_premium_odds_by_fixture_and_bookmaker · get_premium_odds_by_fixture_and_market · get_all_historical_odds

Markets

get_all_markets · get_all_premium_markets · get_market_by_id · search_markets_by_name

Bookmakers

get_all_bookmakers · get_all_premium_bookmakers · get_bookmaker_by_id · search_bookmakers_by_name · get_bookmakers_by_fixture_id · get_bookmaker_match_id_mappings_by_fixture_id

Predictions

get_probabilities · get_predictability_by_league_id · get_probabilities_by_fixture_id · get_value_bets · get_value_bets_by_fixture_id · get_live_probabilities · get_live_probabilities_by_fixture_id

News

get_prematch_news · get_prematch_news_by_season_id · get_prematch_news_for_upcoming · get_postmatch_news · get_postmatch_news_by_season_id

Rivals

get_all_rivals · get_rivals_by_team_id

Commentaries

get_all_commentaries · get_commentaries_by_fixture_id

Expected Goals (xG)

get_expected_goals_by_team · get_expected_goals_by_player · get_expected_lineups_by_team · get_expected_lineups_by_player

Match Facts (beta)

get_all_match_facts · get_match_facts_by_fixture_id · get_match_facts_by_date_range · get_match_facts_by_league_id

Team Rankings (beta)

get_all_team_rankings · get_team_rankings_by_team_id · get_team_rankings_by_date

Team of the Week (TOTW)

get_all_totws · get_totw_by_round_id · get_latest_totw

TV Stations

get_all_tv_stations · get_tv_station_by_id · get_tv_stations_by_fixture_id

States & Types

get_all_states · get_state_by_id · get_all_types · get_type_by_id · get_types_by_entity

Core API — Countries & Geography

get_all_continents · get_continent_by_id · get_all_countries · get_country_by_id · search_countries_by_name · get_all_regions · get_region_by_id · search_regions_by_name · get_all_cities · get_city_by_id · search_cities_by_name

Core API — Utilities

get_all_timezones · get_all_entity_filters · get_all_core_types · get_core_type_by_id · get_core_types_by_entity

My Sportmonks

get_my_enrichments · get_my_resources · get_my_leagues · get_my_api_usage


Common Parameters

All tools accept these optional parameters where applicable:

Parameter

Description

Example

include

Enrich response with related data

participants;events;scores

select

Return only specific fields

id,name,starting_at

filters

Filter included data

fixtureLeagues:501,271

sortBy

Sort results by field

starting_at

locale

Translate name fields

en, de, fr, ar

page

Pagination page number

2

per_page

Results per page (max 50)

25

timezone

Timezone for datetimes

Europe/London

Include examples for fixtures

participants;events;scores;state;periods;statistics;lineups;
venue;league;season;round;stage;odds;predictions;referees;
formations;coaches;tvStations;weatherReport;ballCoordinates;
premiumOdds;inplayOdds;prematchNews;postmatchNews;xGFixture

Authentication

The server reads your token from SPORTMONKS_API_TOKEN. Tokens never expire — manage them at MySportmonks.

Note: Do not expose your token in frontend code. This MCP server is designed to run server-side.

Available Tools

171 tools
get_all_bookmakersB

Get all available bookmakers within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_citiesC

Get all cities available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_coachesA

Get all coaches available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_commentariesC

Get all available commentaries (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_continentsA

Get all continents available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_core_typesC

Get all core types available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_countriesB

Get all countries available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_entity_filtersC

Get all available dynamic filters that can be applied to API requests.

Inputs: include, select, filters, locale, +2 more.

get_all_fixturesC

Get all fixtures accessible within your subscription (paginated).

Inputs: include, select, filters, sortBy, +4 more.

get_all_historical_oddsA

Get all historical premium pre-match odds (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_inplay_oddsC

Get all available inplay odds.

Inputs: include, select, filters, locale, +2 more.

get_all_leaguesB

Get all leagues available within your subscription (paginated).

Inputs: include, select, filters, sortBy, +3 more.

get_all_livescoresA

Get all livescores — fixtures 15 minutes before kick-off until 15 minutes after full-time.

Inputs: include, select, filters, locale, +1 more.

get_all_marketsC

Get all available odds markets within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_match_factsC

Get all available match facts (beta endpoint).

Inputs: include, select, filters, locale, +2 more.

get_all_playersB

Get all players available within your subscription (paginated).

Inputs: include, select, filters, sortBy, +3 more.

get_all_prematch_oddsB

Get all available pre-match odds (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_premium_bookmakersB

Get all bookmakers available in the Premium Odds Feed.

Inputs: include, select, filters, locale, +2 more.

get_all_premium_marketsB

Get all markets available in the Premium Odds Feed.

Inputs: include, select, filters, locale, +2 more.

get_all_premium_oddsB

Get all premium pre-match odds (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_refereesB

Get all referees available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_regionsC

Get all regions available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_rivalsC

Get all teams with their rivals information.

Inputs: include, select, filters, locale, +2 more.

get_all_roundsA

Get all rounds available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_seasonsB

Get all seasons available within your subscription (paginated).

Inputs: include, select, filters, sortBy, +3 more.

get_all_stagesC

Get all stages available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_standingsB

Get all standings (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_statesC

Get all fixture states (e.g. In Play, Finished, Postponed) within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_team_rankingsC

Get all team rankings (beta endpoint).

Inputs: include, select, filters, locale, +2 more.

get_all_teamsB

Get all teams available within your subscription (paginated).

Inputs: include, select, filters, sortBy, +3 more.

get_all_timezonesB

Get all supported timezones for use in API requests.

Inputs: no named parameters.

get_all_totwsC

Get all available Team of the Week entries.

Inputs: include, select, filters, locale, +2 more.

get_all_transfer_rumoursB

Get all transfer rumours available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_transfersB

Get all transfers available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_all_tv_stationsC

Get all TV stations available.

Inputs: include, select, filters, locale, +2 more.

get_all_typesC

Get all types (event types, statistic types, etc.) within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_all_venuesB

Get all venues available within your subscription (paginated).

Inputs: include, select, filters, locale, +2 more.

get_bookmaker_by_idB

Get a specific bookmaker by ID.

Inputs: id (required), include, select, filters, +3 more.

get_bookmaker_match_id_mappings_by_fixture_idB

Get bookmaker match ID mappings for a specific fixture (for cross-referencing with bookmaker APIs).

Inputs: fixture_id (required), include, select, filters, +3 more.

get_bookmakers_by_fixture_idA

Get all bookmakers offering odds for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_brackets_by_season_idB

Get tournament brackets for a specific season.

Inputs: season_id (required), include, select, filters, +4 more.

get_city_by_idC

Get a city by ID.

Inputs: id (required), include, select, filters, +3 more.

get_coach_by_idB

Get a single coach by ID.

Inputs: id (required), include, select, filters, +3 more.

get_coaches_by_country_idB

Get coaches from a specific country.

Inputs: country_id (required), include, select, filters, +3 more.

get_commentaries_by_fixture_idB

Get textual commentary for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_continent_by_idB

Get a continent by ID.

Inputs: id (required), include, select, filters, +3 more.

get_core_type_by_idC

Get a core type by ID.

Inputs: id (required), include, select, filters, +3 more.

get_core_types_by_entityC

Get core types for a specific entity.

Inputs: entity (required), include, select, filters, +3 more.

get_country_by_idC

Get a country by ID.

Inputs: id (required), include, select, filters, +3 more.

get_current_leagues_by_team_idA

Get only current active leagues for a team.

Inputs: team_id (required), include, select, filters, +4 more.

get_expected_goals_by_playerB

Get Expected Goals (xG) values for a player across all available lineups.

Inputs: player_id (required), include, select, filters, +3 more.

get_expected_goals_by_teamB

Get Expected Goals (xG) values for a team across all available fixtures.

Inputs: team_id (required), include, select, filters, +3 more.

get_expected_lineups_by_playerC

Get predicted/expected lineup entries for a player (premium feature).

Inputs: player_id (required), include, select, filters, +3 more.

get_expected_lineups_by_teamB

Get predicted/expected lineups for a team (premium feature).

Inputs: team_id (required), include, select, filters, +3 more.

get_extended_team_squadC

Get all squad entries for a team across current seasons.

Inputs: team_id (required), include, select, filters, +1 more.

get_fixture_by_idB

Get a single fixture by its ID.

Inputs: id (required), include, select, filters, +5 more.

get_fixtures_by_dateB

Get all fixtures on a specific date.

Inputs: date (required), include, select, filters, +5 more.

get_fixtures_by_date_rangeC

Get fixtures within a date range (max 100 days).

Inputs: start_date (required), end_date (required), include, select, +6 more.

get_fixtures_by_date_range_for_teamB

Get fixtures for a specific team within a date range.

Inputs: start_date (required), end_date (required), team_id (required), include, +7 more.

get_fixtures_by_multiple_idsA

Get multiple fixtures by a comma-separated list of IDs (max 50).

Inputs: ids (required), include, select, filters, +5 more.

get_fixtures_head_to_headB

Get head-to-head fixtures between two teams.

Inputs: team1_id (required), team2_id (required), include, select, +6 more.

get_grouped_standings_by_round_idB

Get grouped standings (e.g. group stage) by round ID.

Inputs: round_id (required), include, select, filters, +1 more.

get_inplay_livescoresB

Get all inplay livescores (fixtures currently being played).

Inputs: include, select, filters, locale, +1 more.

get_inplay_odds_by_fixture_and_bookmakerB

Get inplay odds for a fixture from a specific bookmaker.

Inputs: fixture_id (required), bookmaker_id (required), include, select, +4 more.

get_inplay_odds_by_fixture_and_marketB

Get inplay odds for a fixture in a specific market.

Inputs: fixture_id (required), market_id (required), include, select, +4 more.

get_inplay_odds_by_fixture_idB

Get inplay odds for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_last_updated_coachesB

Get coaches that received updates in the past two hours.

Inputs: include, select, filters, locale, +2 more.

get_last_updated_inplay_oddsC

Get inplay odds updated in the last 10 seconds.

Inputs: include, select, filters, locale, +2 more.

get_last_updated_playersB

Get all players that received updates in the past two hours.

Inputs: include, select, filters, sortBy, +3 more.

get_last_updated_prematch_oddsB

Get pre-match odds updated in the last 10 seconds.

Inputs: include, select, filters, locale, +2 more.

get_latest_livescoresA

Get all livescores that received updates within the last 10 seconds.

Inputs: include, select, filters, locale, +1 more.

get_latest_totwC

Get the latest Team of the Week.

Inputs: include, select, filters, locale, +2 more.

get_latest_transfersC

Get the latest transfers.

Inputs: include, select, filters, locale, +2 more.

get_latest_updated_fixturesB

Get fixtures that received updates within the last 10 seconds.

Inputs: include, select, filters, sortBy, +4 more.

get_league_by_idB

Get a single league by ID.

Inputs: id (required), include, select, filters, +4 more.

get_leagues_by_country_idB

Get all leagues in a specific country.

Inputs: country_id (required), include, select, filters, +4 more.

get_leagues_by_fixture_dateC

Get all leagues with fixtures on a specific date.

Inputs: date (required), include, select, filters, +4 more.

get_leagues_by_team_idB

Get all current and historical leagues for a team.

Inputs: team_id (required), include, select, filters, +4 more.

get_leagues_liveA

Get all leagues that currently have live fixtures being played.

Inputs: include, select, filters, sortBy, +3 more.

get_live_probabilitiesB

Get live in-match probabilities for all active fixtures.

Inputs: include, select, filters, locale, +2 more.

get_live_probabilities_by_fixture_idC

Get live in-match probabilities for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_live_standings_by_league_idC

Get the live standings table for a league.

Inputs: league_id (required), include, select, filters, +1 more.

get_market_by_idC

Get a specific market by ID.

Inputs: id (required), include, select, filters, +3 more.

get_match_facts_by_date_rangeC

Get match facts within a date range.

Inputs: start_date (required), end_date (required), include, select, +4 more.

get_match_facts_by_fixture_idC

Get match facts for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_match_facts_by_league_idB

Get match facts for a specific league.

Inputs: league_id (required), include, select, filters, +3 more.

get_my_api_usageA

Get your API usage statistics aggregated per 5 minutes.

Inputs: no named parameters.

get_my_enrichmentsB

Get all enrichments (data add-ons) available within your subscription.

Inputs: include.

get_my_leaguesB

Get all leagues available within your current subscription.

Inputs: include, locale.

get_my_resourcesB

Get all resources (endpoints) accessible within your subscription.

Inputs: include.

get_past_fixtures_by_tv_station_idB

Get past fixtures that aired on a specific TV station.

Inputs: tv_station_id (required), include, select, filters, +5 more.

get_player_by_idB

Get a single player by ID.

Inputs: id (required), include, select, filters, +4 more.

get_players_by_country_idC

Get players from a specific country.

Inputs: country_id (required), include, select, filters, +4 more.

get_postmatch_newsB

Get all post-match news articles (available immediately after full-time).

Inputs: include, select, filters, locale, +2 more.

get_postmatch_news_by_season_idC

Get post-match news for a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

get_predictability_by_league_idB

Get the performance/accuracy of the prediction model for a league.

Inputs: league_id (required), include, select, filters, +3 more.

get_prematch_newsB

Get all pre-match news articles (available 48h+ before kick-off).

Inputs: include, select, filters, locale, +2 more.

get_prematch_news_by_season_idC

Get pre-match news for a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

get_prematch_news_for_upcomingB

Get pre-match news for upcoming fixtures within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_prematch_odds_by_fixture_and_bookmakerB

Get pre-match odds for a fixture from a specific bookmaker.

Inputs: fixture_id (required), bookmaker_id (required), include, select, +4 more.

get_prematch_odds_by_fixture_and_marketB

Get pre-match odds for a fixture in a specific market.

Inputs: fixture_id (required), market_id (required), include, select, +4 more.

get_prematch_odds_by_fixture_idC

Get pre-match odds for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_premium_odds_by_fixture_and_bookmakerB

Get premium odds for a fixture from a specific bookmaker.

Inputs: fixture_id (required), bookmaker_id (required), include, select, +4 more.

get_premium_odds_by_fixture_and_marketC

Get premium odds for a fixture in a specific market.

Inputs: fixture_id (required), market_id (required), include, select, +4 more.

get_premium_odds_by_fixture_idC

Get premium odds for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_probabilitiesA

Get all win/draw/loss probabilities available in your subscription. Available 21 days before match.

Inputs: include, select, filters, locale, +2 more.

get_probabilities_by_fixture_idC

Get match outcome probabilities for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_referee_by_idB

Get a single referee by ID.

Inputs: id (required), include, select, filters, +3 more.

get_referees_by_country_idC

Get referees from a specific country.

Inputs: country_id (required), include, select, filters, +3 more.

get_referees_by_season_idB

Get referees who officiated in a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

get_region_by_idC

Get a region by ID.

Inputs: id (required), include, select, filters, +3 more.

get_rivals_by_team_idC

Get rivals for a specific team.

Inputs: team_id (required), include, select, filters, +3 more.

get_round_by_idC

Get a single round by ID.

Inputs: id (required), include, select, filters, +3 more.

get_rounds_by_season_idB

Get all rounds for a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

get_round_statistics_by_idC

Get all statistics for a specific round.

Inputs: round_id (required), include, select, filters, +1 more.

get_schedules_by_season_and_teamB

Get a team's schedule within a specific season.

Inputs: season_id (required), team_id (required), include, select, +2 more.

get_schedules_by_season_idB

Get the complete schedule (all fixtures) for a season.

Inputs: season_id (required), include, select, filters, +1 more.

get_schedules_by_team_idA

Get the complete schedule for all active seasons of a team.

Inputs: team_id (required), include, select, filters, +1 more.

get_season_by_idC

Get a single season by ID.

Inputs: id (required), include, select, filters, +4 more.

get_seasons_by_team_idB

Get all seasons a specific team has participated in.

Inputs: team_id (required), include, select, filters, +4 more.

get_season_statistics_by_participantC

Get all season statistics for a participant (team or player) in a season.

Inputs: season_id (required), include, select, filters, +1 more.

get_stage_by_idC

Get a single stage by ID.

Inputs: id (required), include, select, filters, +3 more.

get_stages_by_season_idC

Get all stages for a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

get_stage_statistics_by_idC

Get all statistics for a specific stage.

Inputs: stage_id (required), include, select, filters, +1 more.

get_standing_corrections_by_season_idB

Get point deductions/corrections applied to teams in a season.

Inputs: season_id (required), include, select, filters, +1 more.

get_standings_by_round_idB

Get the standings table at a specific round.

Inputs: round_id (required), include, select, filters, +1 more.

get_standings_by_season_idC

Get the full league standings table for a season.

Inputs: season_id (required), include, select, filters, +1 more.

get_state_by_idC

Get a specific fixture state by ID.

Inputs: id (required), include, select, filters, +3 more.

get_team_by_idB

Get a single team by ID.

Inputs: id (required), include, select, filters, +4 more.

get_team_rankings_by_dateC

Get team rankings on a specific date.

Inputs: date (required), include, select, filters, +3 more.

get_team_rankings_by_team_idC

Get rankings for a specific team.

Inputs: team_id (required), include, select, filters, +3 more.

get_teams_by_country_idC

Get all teams from a specific country.

Inputs: country_id (required), include, select, filters, +4 more.

get_teams_by_season_idB

Get all teams participating in a specific season.

Inputs: season_id (required), include, select, filters, +4 more.

get_team_squadA

Get the current domestic squad for a team.

Inputs: team_id (required), include, select, filters, +1 more.

get_team_squad_by_seasonB

Get a team's (historical) squad for a specific season.

Inputs: team_id (required), season_id (required), include, select, +2 more.

get_topscorers_by_season_idB

Get all topscorers per stage of a season.

Inputs: season_id (required), include, select, filters, +1 more.

get_topscorers_by_stage_idB

Get all topscorers for a specific stage.

Inputs: stage_id (required), include, select, filters, +1 more.

get_totw_by_round_idC

Get Team of the Week for a specific round.

Inputs: round_id (required), include, select, filters, +3 more.

get_transfer_by_idC

Get a single transfer by ID.

Inputs: id (required), include, select, filters, +3 more.

get_transfer_rumour_by_idB

Get a single transfer rumour by ID.

Inputs: id (required), include, select, filters, +3 more.

get_transfer_rumours_by_date_rangeB

Get transfer rumours within a date range.

Inputs: start_date (required), end_date (required), include, select, +4 more.

get_transfer_rumours_by_player_idC

Get transfer rumours for a specific player.

Inputs: player_id (required), include, select, filters, +3 more.

get_transfer_rumours_by_team_idC

Get transfer rumours for a specific team.

Inputs: team_id (required), include, select, filters, +3 more.

get_transfers_by_date_rangeC

Get transfers within a date range.

Inputs: start_date (required), end_date (required), include, select, +4 more.

get_transfers_by_player_idC

Get all transfers for a specific player.

Inputs: player_id (required), include, select, filters, +3 more.

get_transfers_by_team_idB

Get all transfers for a specific team.

Inputs: team_id (required), include, select, filters, +3 more.

get_tv_station_by_idC

Get a TV station by ID.

Inputs: id (required), include, select, filters, +3 more.

get_tv_stations_by_fixture_idA

Get all TV stations broadcasting a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_type_by_idC

Get a specific type by ID.

Inputs: id (required), include, select, filters, +3 more.

get_types_by_entityC

Get types available for a specific entity (e.g. 'fixture', 'player', 'team').

Inputs: entity (required), include, select, filters, +3 more.

get_upcoming_fixtures_by_market_idB

Get upcoming fixtures available for a specific odds market.

Inputs: market_id (required), include, select, filters, +5 more.

get_upcoming_fixtures_by_tv_station_idB

Get upcoming fixtures available on a specific TV station.

Inputs: tv_station_id (required), include, select, filters, +5 more.

get_value_betsB

Get all value bets available within your subscription.

Inputs: include, select, filters, locale, +2 more.

get_value_bets_by_fixture_idB

Get value bets for a specific fixture.

Inputs: fixture_id (required), include, select, filters, +3 more.

get_venue_by_idC

Get a single venue by ID.

Inputs: id (required), include, select, filters, +3 more.

get_venues_by_season_idB

Get all venues used in a specific season.

Inputs: season_id (required), include, select, filters, +3 more.

search_bookmakers_by_nameC

Search bookmakers by name.

Inputs: name (required), include, select, filters, +3 more.

search_cities_by_nameC

Search cities by name.

Inputs: name (required), include, select, filters, +3 more.

search_coaches_by_nameC

Search coaches by name.

Inputs: name (required), include, select, filters, +3 more.

search_countries_by_nameC

Search countries by name.

Inputs: name (required), include, select, filters, +3 more.

search_fixtures_by_nameB

Search fixtures by name (e.g. team name).

Inputs: name (required), include, select, filters, +5 more.

search_leagues_by_nameC

Search leagues by name.

Inputs: name (required), include, select, filters, +4 more.

search_markets_by_nameC

Search markets by name.

Inputs: name (required), include, select, filters, +3 more.

search_players_by_nameA

Search players by name (only returns players in your subscribed leagues).

Inputs: name (required), include, select, filters, +4 more.

search_referees_by_nameB

Search referees by name.

Inputs: name (required), include, select, filters, +3 more.

search_regions_by_nameC

Search regions by name.

Inputs: name (required), include, select, filters, +3 more.

search_rounds_by_nameC

Search rounds by name.

Inputs: name (required), include, select, filters, +3 more.

search_seasons_by_nameC

Search seasons by name.

Inputs: name (required), include, select, filters, +4 more.

search_stages_by_nameC

Search stages by name.

Inputs: name (required), include, select, filters, +3 more.

search_teams_by_nameC

Search teams by name.

Inputs: name (required), include, select, filters, +4 more.

search_venues_by_nameB

Search venues by name.

Inputs: name (required), include, select, filters, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 171 tools

    Disambiguation5/5

    Each tool name clearly indicates the entity and action (e.g., get_all_fixtures, get_fixture_by_id, search_players_by_name). There is no ambiguity between similar tools because they are distinguished by parameters like date range, team, or entity type.

    Naming Consistency5/5

    All tool names follow a consistent pattern: 'get_all_<plural>' for lists, 'get_<singular>_by_id' for single entities, 'get_<entity>_by_<filter>' for filtered queries, and 'search_<entity>_by_name' for searches. Lowercase snake_case is used uniformly.

    Tool Count1/5

    With 171 tools, the count is extremely high. Even for a broad sports data API, this number exceeds typical scopes and can overwhelm an LLM agent. Many tools could be consolidated (e.g., using filters instead of separate endpoints).

    Completeness4/5

    The toolset covers a wide range of sports data entities (fixtures, odds, teams, players, leagues, seasons, transfers, etc.) and includes search, odds, and statistics. Minor gaps exist (e.g., no player statistics per season, no write operations), but overall it is comprehensive for a read-only sports data API.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides access to Fantasy Premier League data, allowing users to compare players, find team information, view gameweek data, and get FPL-related advice through Claude for Desktop and other MCP-compatible clients.
      23
      87 PyPI
      80
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time access to football (soccer) data including fixtures, standings, teams, players, transfers, and injuries through the API-Football service via the Model Context Protocol.
      4
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for football-data.org API providing access to football data like standings, matches, teams, and scorers.
      17 PyPI
      MIT