three.ws Alerts

@three-ws/alerts-mcp

あらゆる AI エージェントから pump.fun の監視を実行できます。アラートルールを定義し、アプリ内／署名付き Webhook／Telegram で通知を受け取り、発火したアラートの履歴を確認できます。

---

Model Context Protocol サーバーです。three.ws の pump.fun アラート機能を、stdio 経由でエージェントが操作できるコントロールプレーンに変換します。pump.fun のイベント（卒業、時価総額のしきい値到達、クジラの買い、新規ローンチ）に対するルールを定義すると、three.ws の cron がライブイベントストリームを監視してルールを評価し、アプリ内、Webhook、Telegram で通知します。実際に発火したアラートを、チャネルごとの配信状態とともに確認できます。

ルールはアカウント単位です。すべての呼び出しで three.ws セッションが渡されるため、サーバーが読み書きするのはあなた自身のルールとあなた自身のアラート履歴だけです。pumpfun-monitor cron がサーバー側で監視するため、ダッシュボードを開いていなくても、どのデバイスでもルールが発火します。

インストール

npm install @three-ws/alerts-mcp

または、npx で実行します（インストール不要）：

npx @three-ws/alerts-mcp

クイックスタート

Claude Code の場合、1 行で実行できます：

claude mcp add alerts -e THREE_WS_SESSION=your-__Host-sid-cookie -- npx -y @three-ws/alerts-mcp

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

{
	"mcpServers": {
		"alerts": {
			"command": "npx",
			"args": ["-y", "@three-ws/alerts-mcp"],
			"env": {
				"THREE_WS_SESSION": "your-__Host-sid-cookie"
			}
		}
	}
}

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

THREE_WS_SESSION=… npx -y @modelcontextprotocol/inspector npx @three-ws/alerts-mcp

認証

すべてのツールはアカウント単位です。サインイン済みの three.ws ブラウザーセッションから取得した __Host-sid Cookie の値を、THREE_WS_SESSION に設定してください（DevTools → Application → Cookies → __Host-sid）。サーバーはブラウザーと同じ方法でセッションを送信します。書き込み時にはまず /api/csrf-token からワンタイム CSRF トークンを取得し、サイトと同様にその値を返送します。セッション値はパスワードと同様に扱ってください。Solana のキーや署名者は必要ありません。

ツール

ツール	種別	説明
list_alert_rules	読み取り専用	配信状態（last_fired_at、最近の失敗、チャネルごとの最近の結果）とともに、アラートルールを一覧表示します。
create_alert_rule	書き込み（追加）	pump.fun イベントに対する新しいルールを定義します。冪等ではありません。呼び出すたびにルールが追加されます（最大 50 件）。
update_alert_rule	書き込み（冪等）	しきい値の調整、一時停止／再開（enabled）、配信チャネルの切り替え、または kind の変更を行います。渡されたフィールドのみ変更されます。
delete_alert_rule	書き込み（破壊的）	ルールとその発火／配信履歴を完全に削除します。一時停止するには、enabled:false を指定して update_alert_rule を使うことをおすすめします。
get_alert_history	読み取り専用	実際に発火したアラートを新しい順に確認します。それぞれに概要、発生元の rule_id、完全なペイロードが含まれます。

ルールの種類と対象

kind	対象	threshold
graduation	グローバル、または target_mint / target_agent	—
price_above	target_mint（必須）	USD建て時価総額
price_below	target_mint（必須）	USD建て時価総額
whale_buy	target_mint（必須）	SOL建ての最小購入額
new_mint	target_agent（必須）	—
market_anomaly	なし（市場全体）；省略可能な filters：processors（price、tvl、stablecoin_supply、stablecoin_peg、funding、open_interest）、min_severity（medium、デフォルトは high、critical）、subject	,

少なくとも1つの配信チャンネルを有効にする必要があります。deliver_in_app（デフォルトは true）、webhook_url（HTTPS — webhook-signature ヘッダーの検証に使用するルールごとの webhook_secret が生成されます）、および／または telegram_chat（数値のチャット ID または @username）を指定できます。cooldown_seconds（5～86400、デフォルトは 300）で、通知の連続発生を制限します。

ルールで参照するコインは、実行時に指定する入力値です。three.ws がプロモーションするのは $THREE（FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump）のみです。

例

// create_alert_rule — alert when a tracked agent's coin graduates, via webhook + Telegram
> {
    "kind": "graduation",
    "target_agent": "8a1c…-uuid",
    "webhook_url": "https://hooks.example.com/pump",
    "telegram_chat": "123456789",
    "cooldown_seconds": 600
  }
{
  "ok": true,
  "rule": {
    "id": "…", "kind": "graduation", "label_display": "Graduations · tracked agent",
    "target_agent": "8a1c…-uuid", "deliver_in_app": true,
    "webhook_url": "https://hooks.example.com/pump",
    "webhook_secret": "whsec_…", "telegram_chat": "123456789",
    "cooldown_seconds": 600, "enabled": true,
    "last_fired_at": null, "recent_failures": 0, "recent_deliveries": []
  }
}

// get_alert_history — what fired, newest first
> { "limit": 2 }
{
  "ok": true, "count": 2, "unread_count": 1,
  "alerts": [
    { "id": 1841, "fired_at": "2026-06-24T…Z", "read": false,
      "summary": "Whale bought 12.50 SOL ($2,310) of $THREE",
      "rule_id": "…", "kind": "whale_buy", "mint": "FeMb…pump", "symbol": "THREE",
      "event": { "amount_sol": 12.5, "amount_usd": 2310, "buyer": "…", "tx": "…" } }
  ]
}

要件

• Node.js >= 20。
• three.ws にサインイン済みのセッション（THREE_WS_SESSION）。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト	備考
THREE_WS_SESSION	はい	—	__Host-sid Cookie の値です。アカウント認証情報のため、秘密にしてください。
THREE_WS_BASE	いいえ	https://three.ws	セルフホストまたはプレビュー環境の場合のみ上書きします。
THREE_WS_TIMEOUT_MS	いいえ	20000	リクエストごとのタイムアウト（ms）。

プログラムからの使用

パッケージのエントリーポイントでは、TOOLS（各ツール定義：name、title、 description、inputSchema、annotations、handler）と、トランスポートが未設定の 完全に登録済みの McpServer を返す buildServer() をエクスポートします。インポートしても副作用はなく、セッションも不要です。そのため、独自のホストにアラートツールを組み込んだり、オフラインで機能一覧を確認したりできます。セッションが必要になるのは、ハンドラーの実行時のみです。

// run with: THREE_WS_SESSION=<your __Host-sid value> node this-file.mjs
import { TOOLS, buildServer } from '@three-ws/alerts-mcp';

for (const tool of TOOLS) {
	const kind = tool.annotations.readOnlyHint ? 'read ' : 'write';
	console.log(`${kind} ${tool.name}`);
}

// A tool handler is a plain async function against the live API.
const list = TOOLS.find((t) => t.name === 'list_alert_rules');
console.log(await list.handler({}));

// Or hand the whole registered server to your own MCP transport.
buildServer();

リンク

• ホームページ：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}