Sportmonks MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sportmonks MCP Server show me the latest live scores"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 install2. Get your API token
Create a free token at MySportmonks.
3. Set environment variable
export SPORTMONKS_API_TOKEN=your_token_here4. Run the server
node src/index.jsRelated 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 |
| All fixtures currently being played |
| Fixtures 15 min before/after match |
| Livescores updated in last 10 seconds |
Fixtures
Tool | Description |
| All fixtures (paginated) |
| Single fixture by ID |
| Up to 50 fixtures by IDs |
| Fixtures on a date |
| Fixtures in a date range (max 100 days) |
| A team's fixtures in a date range |
| Head-to-head between two teams |
| Search by name |
| Upcoming fixtures for an odds market |
| Upcoming fixtures on a TV station |
| Past fixtures on a TV station |
| Fixtures updated in last 10 seconds |
Leagues
Tool | Description |
| All leagues (paginated) |
| Single league by ID |
| Leagues with live fixtures |
| Leagues with fixtures on a date |
| Leagues in a country |
| Search by name |
| All leagues for a team (historical) |
| 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 |
| Enrich response with related data |
|
| Return only specific fields |
|
| Filter included data |
|
| Sort results by field |
|
| Translate name fields |
|
| Pagination page number |
|
| Results per page (max 50) |
|
| Timezone for datetimes |
|
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;xGFixtureAuthentication
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 toolsget_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_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_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
Scored across 171 tools
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.
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.
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).
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
Unofficial Sportmonks Football MCP — wraps the Sportmonks Football v3 API…
API-Football MCP — comprehensive soccer/football data
MCP server for Financial Modeling Prep API with 250+ financial data tools
Football-Data.org MCP — soccer competitions, matches, standings
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.2387 PyPI80MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables agents to interact with soccer data including scores, matches, players, and teams using the sportsdata.io Soccer V3 Scores API.-
- AlicenseNot gradedqualityDmaintenanceProvides 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.4ISC
- AlicenseNot gradedqualityDmaintenanceMCP server for football-data.org API providing access to football data like standings, matches, teams, and scorers.17 PyPIMIT