AcesAPI

AcesAPI MCP サーバー

テニスデータ API。 ATP および WTA のシングルスの試合について、すべてのセットとタイブレークのスコア、各ラウンドのトーナメントドロー、選手プロフィール、週間ランキング、直接対決、サーフェス別の成績、独自のサーフェス別 Elo、グランドスラムやマスターズ／WTA 1000 の試合のスポーツブックのマネーラインを提供します。REST API と MCP サーバーをご利用いただけます。毎月 500 クレジットが無料で、カードは不要です。

ウェブサイト：https://acesapi.com · ドキュメント：https://acesapi.com/docs · キーを取得：https://acesapi.com/signup

You:    "What is Carlos Alcaraz's record on clay against top-10 players?"
Claude: [calls get_surface_splits]

You:    "Who leads the Sinner and Alcaraz head to head, and how many of their meetings were finals?"
Claude: [calls get_head_to_head]

You:    "Which moneylines were posted for the 2025 US Open men's final?"
Claude: [calls get_matches, then get_match]

ローカルで実行（stdio）

ほとんどのクライアントは https://mcp.acesapi.com/mcp に直接接続します。代わりにローカルプロセスを起動するクライアントの場合：

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

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

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

スキル

このリポジトリには、skills/ に無料の Claude スキルが 16 個含まれています。これらのスキルは、以下のツールを使って Claude をテニスアナリストにします。試合や選手の検索、サーフェス別 Elo、直接対決、ランキング履歴、セットスコアのモデリング、オッズ計算、優位性の検出、バックテストに対応しています。AcesAPI のツールを呼び出し、データに含まれる情報のみを使用します（サーブ統計には対応せず、マネーラインの対象はグランドスラム、マスターズ、WTA 1000 のみです）。

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

または、Claude Code プラグインとしてインストールできます：

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

スキル CLI を使ってインストールすることもできます：npx skills add noahowsh/acesapi-mcp。

Claude に skills/ フォルダーを参照させ、MCP サーバーを追加して（クイックスタートを参照）、たとえば「明日の上海の試合では誰が有利で、その理由は？」と質問してください。全カタログはこちらです：skills/README.md。スキルは、キーなしでお手元の CSV または JSON にも使用できます。

便利なページ

• ドキュメント：すべてのエンドポイント、パラメーター、実行可能な例
• テニスのオッズ：近日開催される ATP および WTA の試合と、各スポーツブックのマネーライン
• データアトラス：利用できるデータと、カバレッジが一部に限られる分野
• ガイド：サーフェス別 Elo、直接対決、ランキング、セットスコア、サーフェス別の成績を扱う Python チュートリアル
• データ：試合結果、ランキング履歴、オッズ履歴
• 料金：呼び出しごとのクレジット数、毎月 500 クレジットが無料
• サーフェス別 Elo の解説
• 比較：API Tennis、ESPN のテニスフィード、Sportradar、SportsDataIO

Python

公式 Python クライアントは PyPI で公開されています：acesapi。

pip install acesapi
export ACESAPI_API_KEY=sk_live_...

from acesapi import Client

client = Client()

ranks = client.get_rankings(limit=5)
for row in ranks["rankings"]:
    print(row["rank"], row["name"], row["points"])

キーの誤り、クレジット不足、未検出、レート制限に対応した型付きエラー、自動再試行、pandas 用の to_dataframe を利用できます。

クイックスタート

これは Streamable HTTP 経由で利用するホスト型（リモート）MCP サーバーです。インストールは不要です。

Claude Code

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

Claude Desktop、Cursor、その他のクライアント

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

キーは x-api-key ヘッダーまたは Authorization: Bearer で送信することもできます。キーなしで接続してツールを一覧表示できますが、ツールの呼び出しにはキーが必要です。

REST

curl -X POST https://mcp.acesapi.com/v1/list_tournaments -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/tennis_head_to_head_surface_elo.py：2人の選手を並べて比較します。

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

詳細はexamples/README.mdをご覧ください。https://acesapi.com/signup で無料キーを取得できます（月500クレジット、カード不要）。

ツール（13）

ツール	返される内容
list_tournaments	日付、サーフェス、ステータス、優勝者を含むシーズンの大会一覧
search_players	名前または国で選手を検索します
get_tournament	各セットを含む、大会のドローとラウンドごとの結果
get_matches	日付、大会、またはシーズンごとの試合結果。セットとタイブレークのスコアを含みます
get_schedule	今後数日間の試合予定と進行中の試合
get_match	1試合の詳細：セット、タイブレークのポイント、シード、レーティング、スコアが示す内容
get_rankings	2007年以降の週間ランキング一覧、または特定選手のランキング履歴
get_ratings	全体またはサーフェス別の独自Eloレーティング
get_head_to_head	2人の選手の対戦履歴、サーフェス別および決勝での勝利数
get_surface_splits	サーフェス別の選手の成績：セット、ゲーム、タイブレーク、最終セット
get_player_stats	スコアを基にした選手のシーズン統計。ラウンド別および対戦相手のランキング別
get_player	プロフィール、ランキング、レーティング、通算成績、タイトル、最近の試合
get_player_matches	シーズン、サーフェス、対戦相手で絞り込める、スコアとレーティング付きの選手の試合

リーグ：tennis（デフォルト、ATP）、wta（任意のツールにleague: "wta"を渡します）。

データ

• 2007年以降のATPおよびWTAシングルス（予選は2022年以降）。セットとタイブレークのスコアを含みます
• 大会のドローとラウンドごとの結果、2007年以降の週間ランキング
• 対戦成績、サーフェス別成績、スコアから算出した選手のシーズン統計、全体およびサーフェス別の独自Eloレーティング
• スポーツブックの勝敗オッズは、get_matchのodds配列で返されます（オッズ専用のツールはありません）。グランドスラムの試合は2020年半ば以降、ATP MastersおよびWTA 1000の試合は2024年8月以降が対象です。試合前のオッズを1時間ごとに更新します。その他の大会では配列は空です
• サーブ統計はありません（エース、ダブルフォルト、ブレークポイント）

シーズンごとの対象範囲は、データベースからリアルタイムで取得できます：https://acesapi.com/docs

料金

毎月500クレジットまで無料、カード不要。プラン：Starter $19/mo（10,000クレジット）、Pro $49/mo（30,000）、Scale $149/mo（125,000）。ウォレットへのチャージは$5からで、有効期限はありません。https://acesapi.com/pricing

クレジット表記

サーフェスとレーティングは独自のものです。ATP、WTA、ITF、またはいずれの大会とも提携していません。

ライセンス

このリポジトリの内容はMITライセンスです。データの利用条件は上記のとおりです。

Codexでの使用

このリポジトリをCodexプラグインマーケットプレイスとして追加し、プラグインをインストールします。

codex plugin marketplace add noahowsh/acesapi-mcp

次に、Codexでプラグインディレクトリを開き、acesapiマーケットプレイスからacesapi-skillsをインストールします。プラグインにはskills/内のスキルとAcesAPI MCPサーバー（https://mcp.acesapi.com/mcp）が含まれています。先にキーを設定してください（https://acesapi.com/signup で無料取得できます）。

export ACESAPI_API_KEY=your_key

Codexはキーをベアラートークンとして送信します。

Gemini CLIでの使用

export ACESAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/acesapi-mcp

この拡張機能はAcesAPI MCPサーバー（https://mcp.acesapi.com/mcp）を追加し、`x-api-key`ヘッダーにキーを設定して送信します。https://acesapi.com/signup で無料キーを取得できます（月500クレジット）。