はじめに
VALOTOWN MCP は、VALORANTプレイヤーの試合データやプロeスポーツ情報などをAIに提供する Model Context Protocol サーバーです。
接続情報
| 項目 | 値 |
|---|---|
| エンドポイント | https://mcp.valo.town/ |
| トランスポート | Streamable HTTP |
| 認証 | Bearer トークン(APIキー または OAuthアクセストークン) |
APIキーの取得
発行されたキーは vtmcp_ で始まります。
Claude.ai での接続(OAuth)
Claude.ai Pro の MCP 設定から以下の情報を入力します。
| 項目 | 値 |
|---|---|
| サーバー URL | https://mcp.valo.town/ |
| 認証方式 | OAuth 2.0 |
「接続」を押すとVALOTOWNの認証ページにリダイレクトされ、ログイン後に許可するとClaudeがMCPを利用できるようになります。
APIキーを直接使う場合
http
Authorization: Bearer vtmcp_xxxxxxxxxxxxxxxxxxxxxxxxまたは
http
X-Api-Key: vtmcp_xxxxxxxxxxxxxxxxxxxxxxxxツール一覧
| カテゴリ | ツール数 | 主な用途 |
|---|---|---|
| プレイヤー | 4 | 自分の情報・検索・スタッツ・試合履歴 |
| 試合 | 4 | 詳細データ・武器統計・リテイク率 |
| eスポーツ | 7 | VCT試合・チーム分析・マップBAN/PICK |
| プレイヤー分析 | 12 | 時間帯・エージェント・マップ・成長・メタ・比較・分布 |
| ボイスライン | 3 | ボイスライン検索・カテゴリ |
| ゲームコンテンツ | 5 | エージェント・マップ・武器・スキン |
| 統計 | 4 | プラットフォーム統計・武器HS率 |
合計 39ツール
よくある使い方
自分の得意エージェントを調べる
get_me() → 自分のprofile_uuidを取得
get_player_agent_breakdown(profile_uuid=...) → エージェント別勝率一覧ZETA DIVISION の最近の試合を分析する
search_esports_matches(team_a="ZETA", status="試合終了", limit=10)
→ 各試合の uuid を取得
analyze_esports_team_matchup(team_a="ZETA", team_b="相手チーム名")
→ マップ傾向・エージェント構成を比較リテイク率を計算する
get_player_matches(profile_uuid=..., queue="competitive", limit=20)
→ match_id のリストを取得
get_retake_stats(match_ids=[...])
→ マップ・サイト別リテイク率注意事項
- 試合履歴が「非公開」に設定されているプレイヤーのデータは、本人以外から取得できません
search_playerでvalopedia_searchableが無効なプレイヤーは検索結果に表示されません- メタ分析(
get_meta_agent_stats)は全試合データ(10万件超)の事前集計キャッシュを使用します - 全ての操作はログに記録されます
