FighterAPI

FighterAPI MCP 服务

格斗数据 API。 几乎所有 2000 年以来 UFC 比赛的结果、裁判记分卡和完整数据表，逐回合呈现；还提供 PFL（2012 年起）和 Bellator（2009 至 2024 年）的比赛结果、选手和评级，并使用同一密钥。选手资料、职业生涯数据率、自有评级和体育博彩胜负赔率（UFC 自 2020 年 6 月起，PFL 自 2023 年 4 月起，Bellator 自 2022 年 1 月至 2024 年）。提供 REST API 和 MCP 服务。每月免费 500 点额度，无需银行卡。

网站：https://fighterapi.com · 文档：https://fighterapi.com/docs · 获取密钥：https://fighterapi.com/signup

You:    "What is Islam Makhachev's significant strike accuracy by round across his UFC fights?"
Claude: [calls get_fighter_fights]

You:    "Show the opening and closing moneyline for every main event this year."
Claude: [calls get_odds]

在本地运行（stdio）

大多数客户端会直接连接到 https://mcp.fighterapi.com/mcp。如果客户端会启动本地进程：

git clone https://github.com/noahowsh/fighterapi-mcp.git && cd fighterapi-mcp && npm install
FIGHTERAPI_API_KEY=your_key node index.js

{ "mcpServers": { "fighterapi": { "command": "node", "args": ["/path/to/fighterapi-mcp/index.js"], "env": { "FIGHTERAPI_API_KEY": "your_key" } } } }

它会使用你的密钥转发到托管服务，因此所有工具和额度费用都相同。

Skills

16 个 Claude skills，可将 Claude 打造成连接这些工具的 MMA 分析师：查询比赛和赛事卡、考察选手、查看逐回合击打和摔跤数据率、按量级查看 Elo、比较赔率并去除水位、校准热门选手、检测优势并进行回测。它们是 skills/ 中的普通 SKILL.md 文件。

git clone https://github.com/noahowsh/fighterapi-mcp

也可以将它们安装为 Claude Code 插件：

/plugin marketplace add noahowsh/fighterapi-mcp
/plugin install fighterapi-skills@fighterapi

也可以通过 skills CLI 安装：npx skills add noahowsh/fighterapi-mcp。

让 Claude 使用 skills/ 文件夹（对于 Claude Code，可将 skill 文件夹复制或符号链接到 ~/.claude/skills/ 或项目的 .claude/skills/），连接下方的 MCP 服务，然后提出问题。如果不确定该使用哪个 skill，可从 skills/dispatch 开始。完整目录：skills/README.md。

实用页面

• 文档和所有工具：https://fighterapi.com/docs
• 指南：https://fighterapi.com/guides
• UFC 赔率：https://fighterapi.com/odds
• 数据覆盖范围：https://fighterapi.com/data
• 定价：https://fighterapi.com/pricing
• 比较：ESPN MMA API、Kaggle UFC 数据集、Sportradar 和 SportsDataIO、UFC Stats 抓取工具

Python

官方 Python 客户端已发布在 PyPI：fighterapi。

pip install fighterapi
export FIGHTERAPI_API_KEY=sk_live_...

from fighterapi import Client

client = Client()

events = client.list_events(status="final", limit=3)["events"]
for e in events:
    print(e["event_id"], e["event_date"], e["name"])

针对密钥无效、额度耗尽、未找到和速率限制提供类型化错误，支持自动重试，并提供用于 pandas 的 to_dataframe。

快速开始

这是通过 Streamable HTTP 提供的托管（远程）MCP 服务。无需安装任何内容。

Claude Code

claude mcp add --transport http fighterapi "https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop、Cursor 和其他客户端

{
  "mcpServers": {
    "fighterapi": {
      "url": "https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

也可以通过 x-api-key 请求头或 Authorization: Bearer 传递密钥。连接并列出工具无需密钥；调用工具则需要密钥。

REST

curl -X POST https://mcp.fighterapi.com/v1/list_events -H "x-api-key: YOUR_API_KEY"

每个工具都使用带 JSON 请求体的 POST /v1/{tool}。

示例

可运行的 Python（仅使用标准库）和 Node 18+（无依赖项）示例位于 examples/：

• examples/python/quickstart.py 和 examples/node/quickstart.mjs：赛事日程加上一项头条查询。
• examples/python/mma_fighter_record_and_odds.py：选手资料（按比赛方式划分的 UFC 战绩、Elo、职业生涯击打和摔倒率）、其近期比赛及收盘赔率中位数，以及其最近一场比赛中所有体育博彩公司的开盘和收盘胜负赔率。

export FIGHTERAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

详情请见 examples/README.md。前往 https://fighterapi.com/signup 获取免费密钥（每月 500 点额度，无需银行卡）。

工具（11 个）

工具	返回内容
list_events	按年份和状态列出赛事卡，并附上主要赛事
search_fighters	按姓名或绰号查找格斗选手
get_event	赛事卡中的对决及其结果、获胜方式、回合、时间和裁判评分
get_schedule	即将举行的对决及当前赔率（有博彩公司开盘时）
get_ratings	我们的选手评分（基于 2000 年以来的每场 UFC 赛果计算的 Elo 评分）
get_fight	单场对决：结果、完整统计表、逐回合数据、评分和赔率
get_fighter	选手资料、按获胜方式划分的 UFC 战绩、职业生涯比率、评分和近期对决
get_fighter_fights	选手完整的 UFC 历史记录，包括统计数据、评分和收盘赔率
get_leaders	根据每场对决的统计表生成的职业生涯排行榜
get_odds	按博彩公司列出某场对决（5 家）或某张赛事卡（10 家）的初盘、收盘和当前赔率
get_line_movement	对决开始前各个已发布赔率的快照

联赛：mma（默认，UFC）、pfl、bellator（将 league 传递给任意工具）。

数据

• 包含 2000 年以来的每张 UFC 赛事卡及赛果、获胜方式、回合、时间和裁判评分；几乎所有赛事卡都提供完整的逐回合统计表
• PFL（2012 年起）和 Bellator（2009 至 2024 年）的赛果、选手和评分；这些赛事组织近年来没有统计表
• 选手资料包含臂展、站姿和训练馆、按获胜方式划分的职业生涯比率，以及基于 2000 年以来每场 UFC 赛果计算的 Elo 评分
• 赔率和总回合数，不包括特殊投注项：UFC 初盘和收盘赔率始于 2020 年 6 月（每场对决平均有 5 到 7 家博彩公司，2024 年年中以来通常只有 1 家）；PFL 始于 2023 年 4 月；Bellator 始于 2022 年 1 月至 2024 年，博彩公司较少；赛前快照：自 2026 年 10 月起每日一次，并在对决开始前两天内每小时一次

覆盖范围按赛季划分，实时从数据库读取：https://fighterapi.com/docs

定价

每月免费获得 500 个点数，无需信用卡。套餐：Starter 每月 19 美元（10,000 个点数）、Pro 每月 49 美元（30,000 个点数）、Scale 每月 149 美元（125,000 个点数）。钱包充值最低 5 美元，点数永不过期。https://fighterapi.com/pricing

署名

评分由我们提供。与 UFC、PFL、Bellator 或任何赛事组织均无关联。

许可证

本仓库内容采用 MIT 许可证。数据条款如上。

与 Codex 搭配使用

将此仓库添加为 Codex 插件市场，然后安装插件：

codex plugin marketplace add noahowsh/fighterapi-mcp

接着在 Codex 中打开插件目录，并从 fighterapi 市场安装 fighterapi-skills。该插件包含 skills/ 中的技能和 FighterAPI MCP 服务（https://mcp.fighterapi.com/mcp）。请先设置密钥（可在 https://fighterapi.com/signup 免费获取）：

export FIGHTERAPI_API_KEY=your_key

Codex 会将其作为 bearer token 发送。

与 Gemini CLI 搭配使用

export FIGHTERAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/fighterapi-mcp

该扩展会添加 FighterAPI MCP 服务（https://mcp.fighterapi.com/mcp），并在 x-api-key 标头中发送密钥。可在 https://fighterapi.com/signup 免费获取密钥（每月 500 个点数）。