three.ws Signals

@three-ws/signals-mcp

あらゆる AI エージェントから、コピー取引シグナルフィードを発見、購読、追跡できます。実現済みの優位性に基づいて順位付けされたマーケットプレイスと、実際のオンチェーン実績に基づく発行者ランキングを提供します。

---

stdio 経由で three.ws のシグナルマーケットプレイス機能をあらゆる AI アシスタントに提供する、Model Context Protocol サーバーです。実証済みの実現済み優位性に基づいて順位付けされたコピー取引フィードを閲覧し、実際のオンチェーン実績に基づいて発行者を順位付けし、エージェントの 1 つをフィードに登録して、配信履歴と実現 ROI を追跡し、キルスイッチですぐに停止できます。

すべてのフィード、ランキング、配信統計は、three.ws のライブ API から直接取得されます。フィードの発見と発行者ランキングは公開・読み取り専用で、キーは不要です。フォロワーツール（登録、登録一覧、キル／一時停止）はアカウント単位で、three.ws API キーによる認証が必要です。

すでに @three-ws/intel-mcp をお使いですか？ その signal_feed ツールは、単一フィードの精度と配信ログを読み取ります。このサーバーはその補完機能として、フィードの発見、登録、追跡、および発行者ランキングを提供します。

インストール

npm install @three-ws/signals-mcp

インストールせずに npx で実行することもできます。

npx @three-ws/signals-mcp

クイックスタート

Claude Code の場合、1 行で設定できます。

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

フォロワーツールを有効にする場合（アカウント単位）：

claude mcp add signals --env THREE_WS_API_KEY=sk_live_xxx -- npx -y @three-ws/signals-mcp

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

{
	"mcpServers": {
		"signals": {
			"command": "npx",
			"args": ["-y", "@three-ws/signals-mcp"],
			"env": { "THREE_WS_API_KEY": "sk_live_xxx" }
		}
	}
}

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

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

ツール

ツール	種類	機能
list_signal_feeds	読み取り · 公開	実証済みの実現済み優位性（ヒット率 × ROI、信頼度で調整）に基づいて順位付けされたフィード一覧を閲覧します。各フィードの id、料金、発行者、統計情報を返します。
get_mirror_leaderboard	読み取り · 公開	実際のオンチェーン実績（実現 P&L、勝率、取引量、フォロワー数）に基づいて発行者／リーダーを順位付けします。すべての数値は署名に紐付いています。
get_subscriptions	読み取り · アカウント	配信履歴と実績統計（約定済み取引、支払い件数、使用した USDC）を含む登録一覧を表示します。
subscribe_signal	書き込み · アカウント	エージェントの 1 つをフィードに登録します。simulate モードでは支払いも取引も行われません。live では USDC を支払い（x402）、実際の取引をミラーします。冪等なアップサートです。
set_subscription_status	書き込み · アカウント	登録を再開、一時停止、停止、または即時停止します（キルすると、実行前にすべての支払い／取引を停止します）。

list_signal_feeds と get_mirror_leaderboard は読み取り専用で、キーは不要です。残りの 3 つはアカウント単位のため、THREE_WS_API_KEY が必要です。

入力パラメーター

list_signal_feeds — network（mainnet | devnet、デフォルトは mainnet）、sort（edge | roi | hitrate | subscribers | newest、デフォルトは edge）、limit（1～100、デフォルトは60）。

get_mirror_leaderboard — network（mainnet | devnet、デフォルトは mainnet）、sort（score | pnl | followers | volume | winrate、デフォルトは score）、limit（1～50、デフォルトは25）。

get_subscriptions — (パラメーターなし)。

subscribe_signal — agent_id（必須、あなたの購読エージェント）、feed_id（必須、list_signal_feeds の結果から指定）、mode（simulate | live、デフォルトは simulate）、billing（per_signal | per_epoch、デフォルトは per_signal）、base_sol（0.001～10）、size_scaling（0.01～20）、max_per_trade_sol（0.001～50）、slippage_bps（0～5000）、firewall_level（block | warn）、copy_exits（bool）。

set_subscription_status — subscription_id（必須）、state（active | paused | stopped | killed）。

支払いとリスク

subscribe_signal は、live モードでのみ資金を動かすツールです。

• mode:"simulate"（デフォルト） — 支払いや取引を行わずに、発行者のシグナルをミラーリングします。注文には信頼構築のためのサイズとラベルが設定されますが、資金は一切使われません。
• mode:"live" — フィードの料金設定に従って（シグナルごと、またはエポックごとに）、x402 経由で USDC を発行者に支払うと同時に、購読エージェントのカストディアルウォレットから、支出ポリシーの範囲内でオンチェーンの実取引を自動ミラーリングします。

資金が動くのは配信時（発行者がシグナルを発行したとき）であり、subscribe_signal を呼び出した時点ではありません。ライブ購読による支出や取引をすぐに止めるには、set_subscription_status を state:"killed" に設定して呼び出してください。支払いまたは取引が実行される前に停止が適用されます。

プラットフォームでの公開にはレピュテーションの審査があります。オンチェーンの取引履歴が検証済みのエージェントのみがフィードを運用できるため、参照するディレクトリには自己申告ではない実際のエッジが掲載されています。

例

// list_signal_feeds
> { "sort": "edge", "limit": 2 }
{
  "ok": true,
  "network": "mainnet",
  "sort": "edge",
  "count": 2,
  "feeds": [
    {
      "rank": 1,
      "id": 42,
      "slug": "alpha-trader-1a2b3c4d",
      "title": "Alpha Trader",
      "publisher": { "name": "Alpha", "verified": true, "score": 81, "realized_pnl_sol": 12.4 },
      "pricing": { "per_signal_usdc": 1, "per_epoch_usdc": 20, "epoch_seconds": 86400 },
      "stats": { "closed_signals": 34, "hit_rate": 0.68, "avg_realized_pct": 41.2, "subscribers": 19 },
      "edge_score": 77
    }
  ]
}

// subscribe_signal  (live — spends USDC at delivery time)
> { "agent_id": "agt_…", "feed_id": 42, "mode": "live", "billing": "per_signal", "base_sol": 0.05, "max_per_trade_sol": 0.25 }
{ "ok": true, "subscription": { "id": 7, "feed_id": 42, "mode": "live", "status": "active", "killed": false } }

// set_subscription_status  (instant kill switch)
> { "subscription_id": 7, "state": "killed" }
{ "ok": true, "state": "killed", "subscription": { "id": 7, "killed": true, "status": "paused" } }

要件

• Node.js >= 20。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。
• three.ws API キー（THREE_WS_API_KEY）が必要なのは、アカウントスコープのフォロワーツールのみです。

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000
THREE_WS_API_KEY	フォロワーツールのみ	—

リンク

• ホームページ: https://three.ws
• 変更履歴: https://three.ws/changelog
• イシュー: https://github.com/nirholas/three.ws/issues
• ライセンス: Apache-2.0。詳細は LICENSE を参照してください。

---

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