Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the SportMonks Football in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
SportMonks Football API v3: leagues, seasons, fixtures and results, livescores, standings, top scorers, teams, squads, players, venues, pre-match odds and predictions, with SportMonks include and filter syntax. Coverage depends on your SportMonks plan.
Try asking
Example prompts for SportMonks Football
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → SportMonks Football, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
SportMonks Football
SportMonks Football API v3: leagues, seasons, fixtures and results, livescores, standings, top scorers, teams, squads, players, venues, pre-match odds and predictions, with SportMonks include and filter syntax. Coverage depends on your SportMonks plan.
Setup
Setting up takes about 2 minutes. You need a SportMonks account with an API token. A free plan exists with a few leagues; paid plans add leagues and add-ons such as odds and predictions.
- Sign in at my.sportmonks.com and open API, then Tokens.
- Create a token and copy it.
- Paste only the token into
SPORTMONKS_API_TOKEN, without spaces or anapi_token=prefix. The connector sends it in theAuthorizationheader. - Install the connector and run
sportmonks_list_my_leagues: it lists the leagues your plan covers, with their ids.
Your plan decides the data: what you can read depends on your SportMonks plan, above all on the leagues it includes. Data outside the plan does not raise an error: the answer is simply empty, with a note that your current subscription has no access to it. That is why the AI starts with your leagues and works with those. Odds and predictions also need the matching add-on.
What it reads: leagues and seasons; fixtures and results for one day or a date range; livescores and the matches in play right now; league tables, also live; top scorers, assists and cards; teams, squads and players with their statistics; head to head records; stadiums; pre-match odds from the bookmakers in your plan; and the probabilities and value bets of the SportMonks model.
Ids first: SportMonks works with ids. Some league ids: 8 Premier League, 9 Championship, 82 Bundesliga, 384 Serie A, 564 LaLiga, 301 Ligue 1, 2 Champions League. Tables, top scorers and squads need a season id, which the AI takes from the league's current season. Teams, players and stadiums are found by name with the search tools.
Includes and filters: a basic answer only carries ids. The AI adds related data with includes, for example participants;scores;state;events.type for a match with its teams, score, status and goals, and narrows lists with filters such as fixtureLeagues:9. It keeps includes to what you asked for, because they make answers much larger. Lists come in pages of up to 50.
Read-only: every tool only reads. Nothing changes in your SportMonks account, so there is nothing to confirm and no tool is switched off at install.
Odds and predictions are information: odds are decimal. Value bets are what the SportMonks model finds; they are information, not betting advice.
Times and ranges: times come in UTC unless the AI asks for a time zone, and it gives you kickoff times in yours. Date ranges cover at most 100 days.
Limits: SportMonks allows 3,000 calls per hour per entity (fixtures, teams, players and so on). Every answer shows how many calls are left and when the count resets; after a 429 the AI waits for the reset. It prefers one filtered list over many single calls.
Common errors: 401 means SportMonks refused the token: create a new one under API and paste it again. 403 means the token works but that resource is not in your plan. An empty answer with "No result(s) found" usually means the league or the add-on is outside your plan.
The connector covers football only; it does not place bets or change your SportMonks plan or tokens.
Prerequisites: SPORTMONKS_API_TOKEN
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick SportMonks Football and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
sportmonks_list_my_leagues | Leagues your SportMonks plan covers, with id, name, short code, country id, type and when they last played |
sportmonks_list_leagues | Football leagues and cups with id, name, short code, country id, type (league, cup ...) and whether they are active |
sportmonks_search_leagues | Find football leagues by name, e.g |
sportmonks_get_league | One league by id |
sportmonks_get_season | One season by id: name, start and end date, whether it is current or finished |
sportmonks_get_fixture | One match by id |
sportmonks_list_fixtures_by_date | All matches on one day in the leagues your plan covers |
sportmonks_list_fixtures_between | Matches between two dates (at most 100 days apart) in the leagues your plan covers |
sportmonks_list_team_fixtures_between | One team's matches between two dates (at most 100 days apart): past results and upcoming fixtures |
sportmonks_get_head_to_head | Past meetings between two teams, newest first with include participants;scores |
sportmonks_list_livescores | Matches of today that start within 15 minutes, are being played or ended in the last 15 minutes, in the leagues your plan covers |
sportmonks_list_inplay_livescores | Only the matches being played right now, in the leagues your plan covers |
sportmonks_get_standings | League table of a season: position, points, form and the details of each team |
sportmonks_get_live_standings | Live league table of a league, updated while matches are being played |
sportmonks_get_topscorers | Top scorers of a season |
sportmonks_search_teams | Find teams by name: id, name, short code, country and founding year |
sportmonks_get_team | One team by id: name, short code, founded, venue id and country id |
sportmonks_list_season_teams | All teams that play in a season, with id, name, short code and venue id |
sportmonks_get_team_squad | Current domestic squad of a team: player id, jersey number, position id, contract dates |
sportmonks_get_season_squad | Squad of a team in one season, including players who left during it |
sportmonks_search_players | Find players by name: id, display name, birth date, height, weight and position id |
sportmonks_get_player | One player by id: name, birth date, height, weight, position, nationality |
sportmonks_search_venues | Find stadiums by name: id, name, city, address, capacity and surface |
sportmonks_get_venue | One stadium by id: name, city, address, capacity, surface and coordinates |
sportmonks_get_prematch_odds | Pre-match odds of one fixture from the bookmakers in your plan |
sportmonks_list_odds_markets | Betting markets with id and name, e.g. 1 fulltime result, 2 double chance, 14 both teams to score, 80 goals over/under, for the markets… |
sportmonks_list_bookmakers | Bookmakers with id and name, for the bookmakers filter of the odds tool |
sportmonks_get_predictions | SportMonks model probabilities for one fixture: fulltime result, both teams to score, over/under goals, correct score and more |
sportmonks_get_value_bets | Value bets SportMonks' model finds for one fixture: bet, bookmaker, odds and fair odds |
sportmonks_list_types | Type ids and names used across the API (event types, statistic types, positions, standing details ...) |
Example prompts
- "Show me the current Premier League table with each team's form over the last five matches."
- "When are Bayern Munich's next five matches, and how did their last five end?"
- "Which matches are being played right now in my leagues, and what is the score?"
- "Who are the top scorers and the top assist providers in Serie A this season?"
- "What does the SportMonks model give for Saturday's Arsenal match, and what are the pre-match odds at bet365?"
Next steps
Was this guide helpful?
