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 サーバーは2種類あります。おそらく Python 版がおすすめです。

両者には大きな違いがあるため、率直にお伝えします。

アシスタントでオッズを利用したいだけなら、Python サーバーをお使いください。 こちらのほうが機能が充実しており、ドキュメントで説明されているサーバーです。また、何かに登録する前にライブ価格を確認できます。

この TypeScript サーバーは、競馬の主要ツール5つとスポーツツール4つを実装した、より小規模で依存関係の少ないサーバーです。実際に動作し、以下のインストール方法も検証済みですが、機能は一部に限られます。

{
  "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。

無料の API キーは https://puntersedge.online/api?utm_source=github&utm_medium=readme から取得できます。月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

プロジェクトディレクトリから、次のコマンドを1つ実行します。

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

このプロジェクトだけでなくすべてのプロジェクトで利用できるようにするには、-s user を追加してください。Claude Code はプロジェクトのサーバー設定をプロジェクトルートの .mcp.json に書き込みます。このファイルはコミットして手動で編集できます。その場合はキーをファイルに含めず、環境変数を使用してください。

Cursor

1つのプロジェクトでは .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 では mcpServers ではなく servers キーを使います。

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

その他

stdio サーバーに対応しているホストであれば、コマンド、その引数、PUNTERSEDGE_API_KEY を含む環境変数ブロックの3つを指定すれば利用できます。キーはプロンプトではなく環境変数に設定してください。サーバーは起動時に一度だけ読み込み、ツールの実行結果にキーを出力することはありません。

ツール

すべて読み取り専用の9つのツールです。料金はAPIクレジットで、基盤となるエンドポイントに対してAPIが請求するものであり、このサーバーが独自に設定したものではありません。以下の数値は、2026-09-15に https://api.puntersedge.online/openapi.json から取得しました。

レース

スポーツ

アカウント

すべてのレスポンスには、ライブのX-Credits-*ヘッダーもツールの結果に引き継がれるため、 アシスタントは残高を確認するためだけに呼び出しを消費せず、残りの残高を読み取れます。402は 月間の利用枠を使い切ったことを意味します。超過請求はなく、そこで処理が止まり、ツールの結果にその旨が示されます。 何も通知せずに失敗することはありません。

horse-racingというスポーツキーはありません。 レース関連機能はracing_*ツールで提供されます。スポーツ用のツールに sport_key="horse-racing"を渡すと、エラーになります。

アシスタントができること、できないこと

「賭けのオッズ」と「AIエージェント」が同じ文にあると誤解を招きやすいため、明確にしておきます。

できること：

• ライブオッズフィードを読み取ること — ブックメーカーごとの現在のオッズ、今後の開催予定、確定結果、 およびオッズが上昇または下降している出走馬を確認できます
• ページ単位ではなく、個々のオッズごとに情報の鮮度を伝えること
• 呼び出しを行う前に必要なクレジット数を伝え、その後に残高を報告すること

できないこと：

• 賭けを行うこと。 ここには、賭けの申込み、金額の設定、取消、精算を行うツールはありません。すべての ツールは読み取り専用エンドポイントに対するHTTP GETです。
• ブックメーカーの認証情報を保持または使用すること。 このサーバーにはブックメーカーのアカウントも、ログインも、 ブックメーカーとのセッションもありません。公開されているオッズを読み取るだけです。このサーバーが扱う唯一の秘密情報は、 環境変数から読み取られ、ツールの結果には決して書き込まれない、あなたのPuntersEdge APIキーです。
• あなたのPuntersEdgeアカウントを変更すること。 キーのローテーション、請求、Webhookの登録は意図的に対象外としているため、 チャットのやり取りによって認証情報がローテーションされたり、請求内容が変更されたり、あなたのデータを受け取るURLが登録されたりすることはありません。これらのエンドポイントは存在しますが、意図したうえでアプリケーションコードまたはダッシュボードから利用してください。
• 結果を予測すること。 オッズはブックメーカーが公開したものです。このツールは結果を予測したり、出走馬を評価したり、何に賭けるべきかを伝えたりしません。

市場の状況を誤って伝えることもあります。そのことはデータから分かります。 スクレイパーが停止してもエラーにはならず、最後に取得した値を配信し続けるため、ライブのオッズとまったく同じように見えます。 そのため、すべてのオッズには個別のage_secondsとstaleフラグが付いています。ブックメーカー1社しか提示していない市場で大きな価格差が見つかっても、それは機会ではなくデータ上のアーティファクトです。差を実在するものとして扱う前に、そのオッズを提示しているブックメーカーの数を確認してください。

返されるデータ

競馬のレスポンスには、各出走馬の全オッズが含まれます。

{
  "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日間にわたって収集したスナップショットのうち、発走まで30分以内のオーストラリアのレース3,339件すべてについて、14の情報源がそれぞれ全体の75～97％にオッズを提示していました。TABtouchが97％、PointsBetが96％で、Sportsbet、Neds、Palmerbet、Ladbrokes、BetRight、Betr、TABは80～82％に集中し、Unibetは79％、NextBetは75％でした。

ブックメーカーが市場を公開する時刻はそれぞれ異なるため、発走まで数時間あるレースではオッズが2、3社分しかないことが多く、発走が近づくにつれて増えていきます。すべてのレスポンスに実際にオッズを提示したブックメーカーが記載されるので、平均値を当てにするのではなく、レースごとの実際の厚みを確認できます。

スポーツ：さらに少ない状況です。 2026年10月19日時点で、オッズが提示された試合のブックメーカー数は、スポーツによって平均1～5社で、一部の競技では通常1社です。スポーツ別の最新情報は https://puntersedge.online/api/coverage にあります。これはコネクターの対応範囲によるもので、障害ではありません。このフィードが最も強いのは競馬であり、ツールは市場が一律に揃っているかのように見せるのではなく、その違いを示します。

競馬では country=AU を指定してください（英国とアイルランドは GB,IE、南アフリカは ZA です。コードは UK ではなく GB です）。英国、アイルランド、南アフリカのレースには、それぞれ規模の小さいブックメーカー群が含まれます（2026年10月19日時点で、1レースあたりのブックメーカー数の中央値は4社と5社でした）。先述の13日間の測定では、その他の海外レースおよび国が不明なレースの87％は、ブックメーカーがちょうど1社のみでした。そのため通常は比較対象がありません。ただし、「通常」というのが正確な表現です。10％には2社、少数（約3％）には11社のオッズがありました。いずれとも決めつけず、レースごとに bookmakers を確認してください。

オーストラリアのレースは発走が近づくにつれてブックメーカーが増えるため、対象の厚みは一定の数ではなく幅があります。2026年8月17日の測定では、発走30分以内でブックメーカー数の中央値は10社、30～60分では9社、1～2時間では5社、それより前では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