puntersedge

澳大利亚赛马与体育赔率 MCP 服务

适用于澳大利亚赛马、灵缇赛、驾车赛和体育赛事赔率的 Model Context Protocol 服务。 将 Claude Desktop、Claude Code、Cursor、Windsurf 或任何 MCP 客户端连接到实时澳大利亚赔率源，然后询问接下来有哪些比赛、每家博彩公司开出的赔率、哪些参赛者的赔率正在走低，以及谁赢了。

赛马数据 MCP · 体育赔率 MCP 服务 · 赛马 MCP 服务 · 面向 Claude 的澳大利亚赔率 · 面向 Cursor 的体育数据。

You: What's the next race at Randwick and who's favourite?

→ racing_next_to_go(num_races=3, country="AU")
← Wiesners Maiden Plate R1 — 11 runners, 8 bookmakers, data 38s old
  Favourite: <runner> at $2.40 (sportsbet) / $2.55 (tab) / $2.35 (neds)

15 家澳大利亚博彩公司提供赛马赔率（数据测于 2026 年 10 月 19 日；实时数量见 https://puntersedge.online/coverage-report.json）。涵盖澳大利亚纯种马、灵缇和驾车赛；新西兰纯种马和驾车赛；以及覆盖范围较小的英国、爱尔兰和南非赛马赛事。体育赛事涵盖 AFL、NRL、NBA、NFL、网球、板球等。免费套餐：每月 3,000 个额度，无需信用卡。

PuntersEdge 有两个 MCP 服务。你大概需要 Python 版。

开诚布公地说，因为两者差异很大。

如果你只想在助手中查看赔率，请使用 Python 服务。 它功能更全面，是文档介绍的服务，而且在你注册之前就能显示实时价格。

此 TypeScript 服务是一个较小、依赖精简的实现，包含五种核心赛马工具和四种体育工具。它是真实可用的——以下安装方法已经过验证——但功能只是其中一部分。

{
  "mcpServers": {
    "puntersedge": {
      "command": "uvx",
      "args": ["puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

安装此服务

此服务未发布到 npm。不存在名为 puntersedge-mcp 的 npm 包——直接从此仓库安装，安装时会自动构建：

npx -y github:Propertyscout001/puntersedge-mcp

首次运行会克隆仓库并使用 tsc 编译，因此需要等待一段时间，并且需要安装 git 和可用的 Node 工具链。Node 版本需 ≥18。

前往 https://puntersedge.online/api?utm_source=github&utm_medium=readme 获取免费 API 密钥——每月 3,000 个额度，无需信用卡。

Claude Desktop

编辑 claude_desktop_config.json，然后完全退出并重新打开 Claude Desktop：

{
  "mcpServers": {
    "puntersedge": {
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Claude Code

在项目目录中运行一条命令：

claude mcp add puntersedge \
  -e PUNTERSEDGE_API_KEY=your_key_here \
  -- npx -y github:Propertyscout001/puntersedge-mcp

添加 -s user，即可让它在所有项目中可用，而不仅限于当前项目。Claude Code 会将项目服务写入项目根目录中的 .mcp.json，你可以提交该文件并手动编辑——但不要把密钥放进去；如有需要，请使用环境变量。

Cursor

单个项目使用 .cursor/mcp.json，所有项目使用 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "puntersedge": {
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — 与 Cursor 使用相同的 mcpServers 结构。

VS Code / GitHub Copilot

在工作区中使用 .vscode/mcp.json。VS Code 使用 servers 键，而不是 mcpServers：

{
  "servers": {
    "puntersedge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

其他客户端

任何接受 stdio 服务的宿主都需要相同的三项信息：命令、参数，以及包含 PUNTERSEDGE_API_KEY 的环境变量区块。请将密钥放在环境变量中，而不是提示词里——服务只会在启动时读取一次密钥，并且绝不会在工具结果中回显。

工具

共 9 个工具，全部为只读工具。费用以 API 积分计，按底层端点的 API 计费——并非本服务自行设定。以下数据读取自 https://api.puntersedge.online/openapi.json，日期为 2026-09-15。

赛马

体育赛事

账户

每个响应还会将实时的 X-Credits-* 标头传递到工具结果中，因此助手无需额外消耗一次调用，就能查看剩余余额。402 表示月度额度已用完——会立即停止，不会产生超额费用；工具结果会明确说明这一点，不会悄无声息地失败。

没有 horse-racing 这个体育项目键。 赛马使用 racing_* 工具。将 sport_key="horse-racing" 传给体育赛事工具会报错。

助手能做和不能做的事

有必要明确说明这一点，因为「投注赔率」和「AI Agent」出现在同一句话里，很容易让人产生错误的假设。

可以：

• 读取实时赔率数据——各家博彩公司当前的赔率、即将举行的赛程、已结束赛事的结果，以及哪些参赛者的赔率正在走低或走高
• 告知每个赔率数据的新鲜程度，精确到单个赔率，而非整个页面
• 在调用前说明调用所需的积分，并在调用后报告余额

不能：

• 下注。 这里没有任何可下注、投注、取消或结算的工具。所有工具都通过 HTTP GET 请求访问只读端点。
• 持有或使用博彩公司凭据。 本服务没有博彩公司账户、登录信息，也不会与任何博彩公司建立会话。它只读取公开发布的赔率。它接触的唯一密钥是你的 PuntersEdge API 密钥，该密钥从环境变量中读取，绝不会写入工具结果。
• 更改你的 PuntersEdge 账户。 密钥轮换、账单管理和 Webhook 注册都被刻意排除在外，因此聊天轮次无法轮换你的凭据、改变你的账单，或注册一个会接收你数据的 URL。这些端点确实存在；请有意地通过应用程序代码或控制面板访问它们。
• 预测结果。 赔率是博彩公司公布的内容。这里不会预测赛果、评估参赛者，也不会告诉你该押谁。

它有时会误报市场情况，数据本身也会说明这一点。 爬虫停滞时不会报错——它会继续提供上一次获取的数值，看起来与实时赔率完全一样。因此，每条赔率数据都带有自己的 age_seconds 和 stale 标志。如果某个市场只有一家博彩公司提供赔率，那么看似巨大的优势只是数据伪影，并非机会；在将差价视为真实情况之前，请先确认有多少家博彩公司支持该赔率。

返回内容

赛马回复会返回每位参赛者的完整市场信息：

{
  "race_name": "Wiesners Maiden Plate", "race_number": 1, "venue": "...",
  "category": "horse", "country": "AU", "distance_m": 1200,
  "track_condition": "...", "weather": "...", "places_paid": 3,
  "data_age_seconds": 38, "stale": false, "stale_bookmakers": [],
  "scratchings": [],
  "runners": [{
    "name": "...", "number": 1, "barrier": 4,
    "jockey": "...", "trainer": "...", "weight": 58.0, "form": "11521",
    "bookmakers": [
      { "key": "tabtouch", "win_price": 126.0, "place_price": 12.0,
        "tote_win": {"PROV": 60.6}, "last_update": "2026-08-17T02:55:3...",
        "source_url": "https://www.tabtouch.com.au/racing/..." }
    ]
  }]
}

每条回复都会说明数据自身的时效。 data_age_seconds 的时效按赛事计算，每家博彩公司条目都带有自己的 last_update，而 stale_bookmakers 会列出具体哪些盘口数据已停止更新，而不是将整场赛事都判定为过时。当助手即将把某个赔率作为事实陈述时，这一点很重要——它可以说明这个数字有多新鲜，而不是暗示数据实时精确到秒。

诚实说明覆盖范围

赛马：15 家澳大利亚博彩公司（截至 2026 年 10 月 19 日测量）——BetRight、Sportsbet、Betr、TAB、Ladbrokes、Neds、Unibet、PointsBet、NextBet、TABtouch、Palmerbet、BetDeluxe、bet365、BetGold 和 BoostBet，它们提供 13 个独立赔率来源（BetGold/BoostBet 和 Ladbrokes/Neds 在 85% 以上的参赛者身上给出相同赔率）。实时数量 和各来源的时效数据公布于 https://puntersedge.online/coverage-report?utm_source=github&utm_medium=readme。

此数据流不包含 Betfair 和 Pinnacle。 Betfair Exchange 已接入，但在获得 Betfair 数据许可之前，不会向客户回复提供其赔率，因此不计入上述数量，你也无法通过此服务看到 Betfair 赔率。如果你需要交易所赔率，这不是你要找的数据流。

API 中的博彩公司键名不一定是品牌名称：NextBet 返回为 playup，这是其更名之前的名称。请按键名筛选，而不是按显示名称。

临近开赛时，覆盖面广且相对均衡。 在 bet365 加入面板之前的一次测量中，连续 13 天采集的快照涵盖了 3,339 场澳大利亚赛事，每场都在开赛前 30 分钟内——14 个来源各自为其中 75% 到 97% 的赛事提供了报价：TABtouch 为 97%，PointsBet 为 96%，接着 Sportsbet、Neds、Palmerbet、Ladbrokes、BetRight、Betr 和 TAB 都集中在 80%–82%，Unibet 为 79%，NextBet 为 75%。

博彩公司在不同时间发布市场，因此，距离开赛还有数小时的赛事往往只有两三家提供赔率，而临近开赛时会有更多赔率。每条回复都会列出实际提供报价的博彩公司，因此你可以查看每场赛事的真实覆盖深度，而不必依赖平均值。

体育赛事：覆盖更少。 截至 2026 年 10 月 19 日，一场有报价的赛事平均有 1 到 5 家博彩公司，具体取决于运动项目；在某些赛事中通常只有 1 家。各运动项目的实时数据见 https://puntersedge.online/api/coverage。这是连接器覆盖范围的限制，并非服务中断。赛马是此数据流覆盖最强的领域，工具会如实说明这一点，而不会暗示各类市场的覆盖面都一样。

赛马请传入 country=AU（英国和爱尔兰使用 GB,IE，南非使用 ZA——代码是 GB，不是 UK）。英国、爱尔兰和南非的赛事各自覆盖的博彩公司较少（截至 2026 年 10 月 19 日，每场赛事的博彩公司中位数分别为 4 家和 5 家）。在此前 13 天的测量中，87% 的其他外国赛事和未标明地区的赛事恰好只有一家博彩公司，因此通常没有可供比较的对象——但“通常”才是准确的说法：10% 有两家博彩公司，另有一小部分（约 3%）有 11 家。请查看每场赛事的 bookmakers，不要想当然。

澳大利亚赛事临近开赛时会有更多博彩公司加入，因此覆盖深度是一个区间，而不是固定数字。测量日期为 2026-08-17：开赛前 30 分钟内的博彩公司中位数为 10 家，开赛前 30–60 分钟为 9 家，开赛前 1 到 2 小时为 5 家，开赛前超过 2 小时为 2 家。racing_next_to_go 返回即将开赛的赛事，因此处于这一范围的高覆盖端——这也是为什么整个数据流的总体平均值会低估你实际能获得的数据。

外国赛事在赛程中的占比会随着时间变化，而不是固定在某个醒目的比例：澳大利亚下午时段接近于零，夜间则全部是外国赛事。请按 country 筛选，而不要假定赛事来源混合均匀。

备注

• **未提供：**套利和交易所端点。部分端点因 Betfair 许可证要求而暂不开放，并且会向客户密钥返回 410，因此提供这些工具只会产生错误。
• **这是数据，不是建议。**价格是博彩公司公布的内容；这里的任何信息都无法预测结果，也不会下注。
• **端点和参数均从实时 openapi.json 中枚举得出，**而非凭记忆整理。

链接

• MCP 服务文档
• API 文档
• 定价 — 免费套餐每月 3,000 个额度
• 实时覆盖率报告
• Python SDK
• Postman 集合 — 通过 Import → Link 导入 Postman

仅限 18 岁及以上人士。赌博可能使人上瘾，请理性赌博。 赌博帮助热线：1800 858 858，或访问在线赌博帮助。

MIT © PuntersEdge