Stratz

@pipeworx/stratz

STRATZ GraphQL MCP — Dota 2 の統計情報（ヒーロー、マッチ、リーグ、プロプレイヤー）。無料のトークンは stratz.com/api で取得できます。

Pipeworx の一部です — AI エージェントを 1683 以上のライブデータソースに接続する MCP ゲートウェイです。

認証

• プラットフォーム：PLATFORM_STRATZ_KEY。BYO：?_apiKey=…（Bearer トークン）。

ツール

• graphql(query, variables?) — GraphQL に直接クエリを渡します（最も柔軟な手段です）
• hero(id) — ヒーローの詳細（id は Dota 2 のヒーロー ID）
• heroes() — すべてのヒーロー
• hero_stats(hero_id, rank?) — ランク階級別の勝率／ピック率
• match(id) — 単一のマッチ
• player(steam_account_id) — プレイヤーのプロフィール
• player_matches(steam_account_id, take?, skip?) — プレイヤーの最近のマッチ。1 件につきフラットな 1 行（このプレイヤーのヒーロー、K/D/A、GPM/XPM をマッチに統合）
• player_heroes(steam_account_id, take?) — プレイヤーの上位ヒーロー
• live_matches() — 現在進行中のマッチ
• tournament(id) — トーナメントの詳細
• tournaments(only_premium?) — トーナメントの一覧
• meta() — 現在の Dota 2 パッチと定数

注意事項

GraphQL スキーマは大規模です。graphql(...) を使えば、スキーマに対して任意のクエリを記述できます。名前付きツールは、よく使われる形式の便利なラッパーです。

フィールド名は STRATZ スキーマと完全に一致させる必要があります。一致しない場合、最初に見つかった不明なフィールドに対して Cannot query field が返されます。よくある落とし穴：プレイヤーごとの統計（heroId、kills、numLastHits、goldPerMinute）はマッチではなく match.players にあります。ゲームモードは constants { gameModes } です。トーナメントの並べ替えには FilterOrderBy（START_DATE_THEN_TIER、LAST_MATCH_TIME、…）を使います。不明な場合は、まず型をイントロスペクションしてください：{ __type(name: "MatchPlayerType") { fields { name } } }。

各名前付きツールのクエリは、イントロスペクションした STRATZ スキーマに対して検証されます（手順は src/index.ts のヘッダーを参照してください）。

データソース

https://api.stratz.com/graphql

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "stratz": {
      "url": "https://gateway.pipeworx.io/stratz/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/stratz/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツール）も返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共通ツールが約 30 個表示されます。接続時の initialize レスポンスには、正確なスコープが示されます。その日の状況を確認する際は、これが確かな情報源です。

これは意図的な動作であり、偶然の多重化ではありません。メタツールを使うと、このパックで扱っていない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できます。2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1683 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックでは独自の API キー（_apiKey）が必要です。当方ではキーを提供していないため、キーなしで実行できる curl の例はありません。ツールの詳細を見るには GET https://gateway.pipeworx.io/v1/tools/graphql を実行してください。ツールを検索するには {"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です：

{
  "mcpServers": {
    "stratz": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-stratz"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-stratz

stdin/stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。データソースとツールは同じですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx での使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。 これは、上記のパックエンドポイントでも、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Stratz data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT