跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 SportMonks Football，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
SportMonks Football API v3：联赛、赛季、比赛与结果、实时比分、积分榜、射手榜、球队、阵容、球员、球场、赛前赔率和预测，支持 SportMonks 的 include 和筛选语法。可用数据取决于你的 SportMonks 套餐。
试试这样问
SportMonks Football 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → SportMonks Football、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
SportMonks Football
SportMonks Football API v3：联赛、赛季、比赛与结果、实时比分、积分榜、射手榜、球队、阵容、球员、球场、赛前赔率和预测，支持 SportMonks 的 include 和筛选语法。可用数据取决于你的 SportMonks 套餐。
设置
设置大约需要 2 分钟。你需要一个带 API 令牌的 SportMonks 账号。SportMonks 有包含少量联赛的免费套餐；付费套餐会增加联赛，以及赔率、预测等附加功能。
- 登录 my.sportmonks.com，打开 API，再进入 Tokens。
- 创建一个令牌并复制。
- 把令牌单独粘贴到
SPORTMONKS_API_TOKEN，不要带空格或api_token=前缀。连接器会通过Authorization请求头发送它。 - 安装连接器并运行
sportmonks_list_my_leagues：它会列出你的套餐包含的联赛及其 ID。
数据取决于你的套餐：你能读取什么，取决于你的 SportMonks 套餐，尤其是其中包含的联赛。套餐外的数据不会报错，只会返回空结果，并附上当前订阅无权访问的提示。所以 AI 会先查看你的联赛，再在这些联赛中工作。赔率和预测还需要对应的附加功能。
可读取的内容：联赛和赛季；某一天或某个日期范围内的比赛与结果；实时比分和正在进行的比赛；积分榜（也有实时榜）；射手榜、助攻榜和红黄牌；球队、阵容和球员及其统计数据；交锋记录；球场；你的套餐内博彩公司的赛前赔率；以及 SportMonks 模型给出的概率和价值投注。
先找 ID：SportMonks 以 ID 为基础。部分联赛 ID：8 英超，9 英冠，82 德甲，384 意甲，564 西甲，301 法甲，2 欧冠。积分榜、射手榜和阵容需要赛季 ID，AI 会从联赛的当前赛季中获取。球队、球员和球场可以用搜索工具按名称查找。
include 和筛选：基础结果只包含 ID。AI 用 include 补充关联数据，例如用 participants;scores;state;events.type 获取一场比赛的球队、比分、状态和进球，并用 fixtureLeagues:9 这样的筛选条件缩小列表。include 会让结果变大很多，所以 AI 只取你问到的内容。列表按页返回，每页最多 50 条。
只读：所有工具都只读取数据。你的 SportMonks 账号不会发生任何变化，因此无需确认，安装时也没有被关闭的工具。
赔率和预测仅供参考：赔率为小数赔率。价值投注是 SportMonks 模型找到的结果，仅供参考，不构成投注建议。
时间和范围：除非 AI 指定时区，时间均为 UTC，AI 会把开球时间换算成你的时区。日期范围最多 100 天。
限制：SportMonks 允许每个实体（比赛、球队、球员等）每小时 3,000 次调用。每次返回都会显示剩余次数和重置时间；遇到 429 时，AI 会等到重置后再继续。它更倾向于用一次带筛选的列表查询，而不是多次单独调用。
常见错误：401 表示 SportMonks 拒绝了令牌，请在 API 下创建新令牌并重新粘贴。403 表示令牌有效，但该资源不在你的套餐内。返回空结果并提示 "No result(s) found"，通常说明联赛或附加功能不在你的套餐内。
该连接器只涵盖足球，不会下注，也不会更改你的 SportMonks 套餐或令牌。
前提条件: SPORTMONKS_API_TOKEN
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 SportMonks Football 并填入前提条件中列出的环境变量。
可用工具
| 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 ...) |
示例提示
- “给我看英超当前的积分榜，以及每支球队最近五场的状态。”
- “曼城接下来五场比赛是什么时候？最近五场的结果如何？”
- “我的联赛里现在有哪些比赛正在进行？比分是多少？”
- “本赛季意甲的射手榜和助攻榜前几名是谁？”
- “SportMonks 模型对周六阿森纳那场比赛怎么预测？bet365 的赛前赔率是多少？”
下一步
这份指南对你有帮助吗?
