Footballcharts Mcp

io.github.ddevetak由 GitHub 账号 ddevetak 发布v0.5.0更新于 Nov 2, 2026

Tables, results, fixtures, goal timing, season projections: 93 football leagues incl. lower tiers

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

只读足球数据服务器:提供 93 个以上联赛(含低级别联赛)的积分榜、赛果、赛程、进球时段与模型概率。

可以做什么
  • 查询联赛列表与赛季格式,读取含预期积分和运气分类的积分榜
  • 获取已结束比赛的赛果和即将进行的赛程及模型校准概率
  • 按 slug 查看单场比赛,含球队评分与进球时段直方图
  • 获取基于每日蒙特卡洛模拟的赛季预测(夺冠、前四、后三名概率)
  • 查看单支球队的赛季比赛记录、每 15 分钟进球分布与首球分布
  • 核对模型的公开校准记录(命中率、Brier 分数、可靠性分桶)
适用场景
适合让助手回答各国足球联赛(含低级别和女子联赛)的问题:积分榜、状态、进球规律、赛程概率与赛季走势,并提供公开的预测准确率记录,而非投注建议。
运行要求
可作为远程托管端点使用,也可通过 npx 作为本地 npm 包运行(需 Node.js)。无需密钥:无密钥档每 IP 每天 100 次请求。可选免费密钥可通过 FC_API_KEY 环境变量、连接器 URL 或 Authorization 请求头提供,限额提升至每天 200 次。需要能访问 football-charts.com 的 API。
安装前请注意
可选的 FC_API_KEY 是仅显示一次的密钥;在基于 URL 的连接器配置中密钥会出现在 URL 内,应将该 URL 视为敏感信息。工具请求(联赛键、球队名、赛季)会经 HTTPS 发送至 football-charts.com,并按 IP 限流。数据可免费用于个人与研究用途但需署名;不得转售,付费档的商业使用需联系提供方。概率来自公开基线模型,不构成投注建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Footballcharts Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.ddevetak%2Ffootballcharts-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "footballcharts": {
      "type": "http",
      "url": "https://mcp.football-charts.com/mcp"
    }
  }
}

README

Football data MCP server — 98 leagues, lower divisions included (Football Charts)

[npm] [license] [MCP registry]

English · 简体中文 (Simplified Chinese)

Give your AI assistant football data for 98 leagues (across 44 countries) — including the lower divisions other sources skip: tables, results, fixtures, goal timing, a public baseline model and Monte Carlo season projections from football-charts.com.

FC publishes probabilities and a public calibration record — not betting tips. Every model probability is published before kickoff and scored after; the get_track_record tool returns that record (hit rate, Brier score, reliability buckets).

No key needed

Every tool works without an API key at 100 requests/day per IP (20/min). A free key, for personal use, lifts that to 200/day, 60/min (all keys on one email address count together) — get one in seconds:

bash
curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \  -H 'Content-Type: application/json' \  -d '{"email":"[email protected]"}'

The key (fc_...) is shown once — store it. Both tiers: all 98 leagues (top and lower divisions, women's leagues), current + previous season, model probabilities and daily 10,000-run Monte Carlo projections, no betting odds (the historical odds archive is a paid dataset at football-charts.com/data).

Use it on claude.ai (web or mobile) — nothing to install

Settings → Connectors → Add custom connector, then paste:

https://mcp.football-charts.com/mcp

That is the keyless tier. With a key, paste https://mcp.football-charts.com/fc_your_key_here/mcp instead (a connector field accepts only a URL, so the key travels in it; keys are read-only, free and replaceable). Clients that can send headers use POST https://mcp.football-charts.com/mcp with Authorization: Bearer fc_….

Use with Claude Desktop — one-click extension

Download footballcharts-mcp-<version>.mcpb from the latest release and open it; Claude Desktop installs it. The API key field can stay empty.

Use with Claude Desktop — manual config

claude_desktop_config.json (FC_API_KEY is optional since 0.4.0):

json
{  "mcpServers": {    "football-charts": {      "command": "npx",      "args": ["-y", "footballcharts-mcp"],      "env": { "FC_API_KEY": "fc_your_key_here" }    }  }}

Use with Claude Code

bash
claude mcp add football-charts -e FC_API_KEY=fc_your_key_here -- npx -y footballcharts-mcp

Tools

Ten read-only tools. Each description says what the tool returns.

tooluse it for
about_football_chartsSummary of the source: leagues covered, what it does not hold, league-key and season formats, how to read the probabilities.
list_leaguesEvery league covered (98 across 44 countries) with its key, country and seasons available.
get_league_tableStandings for one league season with form, expected points and a luck category; view=luck or goals for alternative rankings.
get_resultsFinished matches of one league season with full-time and half-time scores and first-goal minute; filter by team, keep the latest N with last.
get_fixturesUpcoming matches of one league with the model's calibrated probabilities.
get_matchOne match in full, by slug: model probabilities, team ratings and goal-timing histograms.
get_season_projectionTitle, top-four and bottom-three probabilities and points ranges from 10,000 simulations, refreshed daily.
get_teamOne team's season: table row, match log, goals per 15-minute period and first-goal distribution.
get_goal_timingGoals per 15-minute period for every team in a league season, with peak periods and league totals; pass team for one team.
get_track_recordThe model's public calibration record: hit rate, Brier score and reliability buckets.

The model is a public baseline (Dixon-Coles). It is calibrated, and get_track_record shows how well; it does not beat the bookmaker market. Per-bookmaker opening and closing odds for 91 leagues, 2020 onward, are a paid dataset at football-charts.com/data.

Changelog

  • 0.6.0 — every answer links the football-charts.com page with the same data (source_url); get_track_record returns a calibration record (hit rate, Brier score, reliability buckets); descriptions say what each tool returns, with no instructions to the model, and each tool's title is also in annotations.title; outputs drop the site-only fields roi_*, profit_* and gates; get_season_projection explains a missing projection instead of failing output validation. Same ten tools and arguments.
  • 0.5.0 — every tool has an outputSchema and returns structuredContent; descriptions rewritten from the consumer side (purpose → when to use a sibling instead → one example); get_match drops storage internals. The tool list is ~6k tokens (was ~3k) — the schemas are the cost. Two deliberate choices: list_leagues keeps its list_ prefix because it enumerates everything rather than fetching one thing, and league stays a free string rather than an enum of the 93 keys (an enum would add ~700 tokens to every tool; list_leagues resolves a name in one call). Schema leaves are untyped so that an unexpected null never fails a call; the field types are what the API returns (numbers for counts and probabilities, ISO dates, 'home:away' score strings).
  • 0.4.1 — registry entry declares the hosted endpoint (remotes) so connector directories list it; get_results ordering wording clarified (chronological, last=N keeps the latest N).
  • 0.4.0 — a key is optional: the API serves keyless callers at 300/day per IP (20/min) and its 429 says how to get a free key; about and list_leagues guidance updated; MCPB desktop-extension bundle (manifest.json, icon); registry isRequired: false for FC_API_KEY.
  • 0.3.0 — descriptions rewritten for the model (when / returns / example); new about_football_charts orientation tool (keyless); get_rankings folded into get_league_table via view; get_goal_timing gains a team filter and peak_bins guidance; one structured log line per tool call on stderr (tool, ok, ms, key prefix — never arguments).
  • 0.2.0 — hosted Streamable HTTP transport, read-only annotations, key accepted from header, path or query for registry gateways.

Things to ask

  • "How does the Allsvenskan title race look after this weekend?"
  • "When does Flamengo usually score — early or late?"
  • "Show me the K League table, and who's overperforming what the market expected."
  • "Which team in Serie B hasn't conceded in the first 15 minutes?"
  • "What is Football Charts' actual prediction track record this season?"

Configuration

Env varDefaultPurpose
FC_API_KEY— (required)Your API key
FC_API_BASEFC production APIOverride for self-hosted/testing

Privacy Policy

This extension sends your tool requests (league keys, team names, seasons — never your conversation) to football-charts.com's API over HTTPS. Requests are rate-limited per IP; if you configure an API key, the key identifies your account and its usage is counted per key. No conversation content is stored. Football Charts' privacy policy: https://www.football-charts.com/privacy. Questions: [email protected].

Terms

Free for personal and research use with attribution ("Data by football-charts.com"). No resale of the data. Commercial use of the paid tier: [email protected].

License

MIT (server code only). The data served by the football-charts.com API remains © football-charts.com, provided under the terms at https://www.football-charts.com/developers.

Claude Code plugin

This repository is also a Claude Code plugin (plugins/football-charts/). It adds the hosted MCP server above (no key needed) and the football-data skill:

/plugin install football-charts --marketplace ddevetak/footballcharts-mcp

Cursor plugin

This repository is also a Cursor plugin (.cursor-plugin/plugin.json). It adds the hosted MCP server above (no key needed) and a football-data skill that explains the tools and the REST API. To try it locally, copy the repository to ~/.cursor/plugins/local/football-charts, reload Cursor, and check Customize for the Football Charts MCP server and skill.

来源:README.md,提交 bef9108

工具

10

about_football_charts

About this source

Returns a summary of the football-charts.com source: the leagues and data it covers (93 leagues, including lower divisions), what it does not hold (live scores, player data, bookmaker odds), the league-key and season-string formats, how the model probabilities are produced, and the free-tier limits. No parameters.

无需输入参数。

list_leagues

List leagues

Returns every league covered (93 across 42 countries) with its league key, display name, country and the seasons available, newest first. Other tools take these league keys and season strings. Season format depends on the competition: '2026-2027' for winter-calendar leagues, '2026' for summer-calendar leagues. No parameters.

无需输入参数。

get_league_table

League table

Returns the standings of one league season: one row per team with position, played, wins, draws, losses, goals, points and last-five form, plus expected points and a luck category (how far results run ahead of or behind the underlying performance). view='luck' orders the same rows by over- or under-performance and view='goals' by goals scored; the default orders by points. Without a season, returns the current season.

输入参数viewleague必填season

get_results

Match results

Returns the finished matches of one league season in chronological order: date, teams, full-time and half-time score, first-goal minute and a goalless flag. team keeps the matches where either side's name contains the given text (case-insensitive); last=N keeps only the N most recent matches. Contains no odds.

输入参数lastteamleague必填season

get_fixtures

Upcoming fixtures

Returns the upcoming matches of one league, earliest first: kick-off date and time, teams, a match slug, and the model's calibrated probabilities (home and away win, over/under goal lines, both teams to score, half-time lines; the draw probability is 1 - home - away) with team attack and defence ratings. The probabilities come from a baseline statistical model of past results (no injuries, motivation or weather) and are not bookmaker prices.

输入参数league必填

get_match

Match detail

Returns one match in full, identified by its slug ('country/league-slug/YYYY-MM-DD-home-vs-away', as listed in the slug field of upcoming fixtures): the complete model probability block (calibrated and raw), team ratings, first-goal-time histograms for both sides, recent form and, once played, the score, half-time score and status.

输入参数slug必填

get_season_projection

Season projection

Returns how one league's current season is projected to finish, from 10,000 Monte Carlo simulations refreshed daily: for each team the probabilities of winning the title, finishing in the top four and finishing in the bottom three, current points, mean final points, a 10th-90th percentile points range, a finishing-position matrix, and the change since the previous run. Covers the current season only; returns a note when no projection exists for the league yet.

输入参数league必填

get_team

Team page

Returns one team's season in one league: its table row (with expected points and luck category), the full match log (date, opponent, home or away, score, half-time score, first-goal minute, outcome), goals per 15-minute period, the first-goal distribution, and season averages of match statistics (shots, shots on target, possession, corners, xG) where the league has them. team is a lower-case slug with hyphens, e.g. 'arsenal' or 'manchester-city'.

输入参数team必填league必填season

get_goal_timing

Goal timing

Returns goals per 15-minute period (0-15 to 90+) for every team in one league season, with each team's peak period or periods (ties are listed together), share of late goals and share of first-half goals, plus league totals and the league's most active period. team limits the result to teams whose name contains the given text.

输入参数teamleague必填season

get_track_record

Model calibration record

Returns the public calibration record of the model: every probability published before kick-off and scored after the result, with count, hit rate, Brier score and reliability buckets (predicted probability against observed frequency), overall and by question type (match result, total goals over 2.5 and 3.5, half-time goals over 1.5, both teams to score), plus the 50 most recent scored predictions. Misses are included. days sets the lookback window (default 90).

输入参数days

版本历史

1
  1. v0.5.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分