three.ws KOL

@three-ws/kol-mcp

1人の賢いトレーダーを追跡：追跡対象のKOLウォレットの保有資産、実際のオンチェーン損益、指定したミントでの取引を、あらゆるAIエージェントから確認できます。

---

ウォレットごとのKOL詳細分析に対応するModel Context Protocolサーバーです。@three-ws/intel-mcpが追跡対象のKOL全体をランキングし（kol_leaderboard）、指定したミントで全員の取引を表示する（kol_trades）のに対し、このサーバーは1人の賢いトレーダーに焦点を当てます。保有資産と実際のオンチェーン損益を含む最新のポートフォリオカードを取得し、特定のトークンに対する本人の買い・売りを確認できます。エージェントがそのトレーダーをコピーするか分析するかを判断するために必要な情報をすべて提供します。

保有資産データはthree.wsのBirdeyeプロキシから取得します（Birdeyeキーはサーバー側に保持されます）。損益はウォレット自身のオンチェーン取引からFIFO方式で計算し、取引履歴はthree.wsのHeliusを基盤とするKOLフィードから取得します。すべてリアルタイムの読み取り専用データで、クライアントにAPIキー、署名者、支払いは不要です。THREE_WS_BASEをデプロイ先に設定すれば利用できます。

インストール

npm install @three-ws/kol-mcp

または、インストールせずにnpxで実行します。

npx @three-ws/kol-mcp

クイックスタート

Claude Codeでは、1行で設定できます。

claude mcp add kol -- npx -y @three-ws/kol-mcp

Claude Desktop / Cursorの場合（claude_desktop_config.jsonまたはmcp.json）：

{
	"mcpServers": {
		"kol": {
			"command": "npx",
			"args": ["-y", "@three-ws/kol-mcp"]
		}
	}
}

MCP Inspectorで機能を確認します。

npx -y @modelcontextprotocol/inspector npx @three-ws/kol-mcp

ツール

ツール	種類	機能
get_wallet_portfolio	読み取り専用	1つのKOLウォレットの最新ポートフォリオカードを取得します。保有資産の価値、ポジション数、上位の保有資産に加え、ウォレット自身のオンチェーン取引に基づく過去30日間の実現損益、勝率、取引数、取引高を表示します。
get_wallet_trades	読み取り専用	指定したミントにおけるウォレットの最近の買い・売りを、新しい順に表示します。売買区分、SOL建ての規模、トークン数量、価格、米ドル換算額、取引時刻を確認できます。

どちらのツールもリアルタイムデータを読み取ります。保有資産、損益、取引フィードは呼び出しのたびに変化するため、いずれも冪等ではありません。

入力パラメーター

get_wallet_portfolio — wallet（必須）。

get_wallet_trades — wallet（必須）、mint（必須）、limit（1～100、デフォルトは20）。

three.wsの取引フィードはミントをキーにしています（指定した1つのミントでの活動について、追跡対象のすべてのKOLウォレットをスキャンします）。そのため、ウォレットごとに見るには、このフィードを指定したウォレットに絞り込みます。get_wallet_tradesにはwalletとmintの両方が必要です。指定したミントでの追跡対象ウォレット全員の取引を確認するには、@three-ws/intel-mcpのkol_tradesを使用してください。

例

// get_wallet_portfolio
> { "wallet": "5xY…KoL" }
{
  "ok": true,
  "wallet": "5xY…KoL",
  "has_activity": true,
  "portfolio_value_usd": 38120,
  "holdings": 14,
  "top_token": { "symbol": "THREE", "valueUsd": 21500 },
  "realized_pnl_usd": 124300,
  "win_rate": 0.64,
  "total_trades": 412,
  "volume_usd": 2840000,
  "pnl_source": "onchain-fifo",
  "pnl_window": "30d"
}

// get_wallet_trades
> { "wallet": "5xY…KoL", "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump", "limit": 3 }
{
  "ok": true,
  "wallet": "5xY…KoL",
  "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
  "count": 2,
  "trades": [
    { "side": "buy", "amountSol": 4.2, "amountToken": 1830000, "price": 0.0000022, "usd": 612.4, "time": "2026-06-24T09:12:03.000Z", "source": "kol", "label": "Top Trader" }
  ]
}

ポートフォリオ（保有資産も取引もないもの）のhas_activity: falseは、そのアドレスの記録済み履歴がまだプロキシにないことを意味します。これは失敗ではなく、正直な「データなし」です。pnl_source: nullを伴うnullの損益フィールドも、フィールド単位で同じように正直な状態を示しています。three.wsは対象期間中、そのウォレットの取引履歴を持たないため、損益がないことを報告し、損益が横ばいだったと受け取られるゼロは返しません。

サービス停止を、このどちらかに見せかけることはありません。保有資産プロバイダーが停止している場合や、レート制限がかかっている場合、three.wsはウォレットの行を捏造せず省略し、get_wallet_portfolioは空のカードを返すのではなく**upstream_unavailable**で失敗します。動きのないウォレットと応答しないプロバイダーでは意味が異なるため、トレーダーの取引をコピーするエージェントがその違いを見分けられる必要があります。

例

実行可能な例はexamples/にあります。

node examples/list-tools.mjs     # both tools with their full input schemas
node examples/wallet-card.mjs    # a trader's portfolio card + trades, live

どちらもstdio経由でこのサーバーを起動し、公開中のKOL APIからデータを読み込みます。ここにあるすべてのツールは読み取り専用なので、署名、支出、公開はできません。期待される出力については、examples/README.mdをご覧ください。

要件

• Node.js >= 20。
• https://three.ws（または独自のTHREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000

クライアント側にキーは不要です。保有資産データ側を支えるBirdeyeキーと、取引フィード側のHeliusキーは、どちらもthree.wsのサーバー側にあります。

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0、LICENSEを参照

---

_{three.ws SDK スイートの一部 — 3D AI エージェント、オンチェーンID、エージェント決済。
ウェブサイト · 変更履歴 · GitHub}