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クレジットを無料で利用でき、カード登録は不要です。

Webサイト：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" } } } }

キーを使ってホストされたサーバーにリクエストを転送するため、すべてのツールとクレジットの消費量は同じです。

スキル

Claudeをこれらのツールと連携するMMAアナリストにする、16種類のClaudeスキルです。試合やカードの検索、選手のスカウティング、ラウンドごとの打撃・グラップリング成績率、階級別の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

または、スキルCLIを使います：npx skills add noahowsh/fighterapi-mcp。

Claudeから skills/ フォルダーを参照できるようにし（Claude Codeの場合、スキルのフォルダーを ~/.claude/skills/ またはプロジェクトの .claude/skills/ にコピーするか、シンボリックリンクを作成してください）、下記のMCP サーバーに接続して質問してください。どのスキルが適しているかわからない場合は、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 dataset、Sportradar and SportsDataIO、UFC Stats scraper

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	1試合の結果、全スタッツシート、ラウンドごとのデータ、レーティング、オッズ
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月以降のオープニングおよび締切時のオッズ（1試合あたり中央値で5～7社。2024年半ば以降は通常1社）、PFLは2023年4月以降、Bellatorは2022年1月から2024年まで（掲載社数は少なめ）。試合前のスナップショット：2026年10月以降は1日1回、試合前の2日間は1時間ごと

シーズン別の収録状況は、データベースからリアルタイムで確認できます：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 はキーをベアラートークンとして送信します。

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` ヘッダーでキーを送信します。無料キー（毎月500クレジット）は https://fighterapi.com/signup で取得できます。