three.ws Alerts

@three-ws/alerts-mcp

通过任意 AI Agent 运行自己的 pump.fun 监控——定义提醒规则，通过应用内通知／签名 webhook／Telegram 发送提醒，并查看已触发提醒的历史记录。

---

一个 Model Context Protocol 服务，可将 three.ws pump.fun 提醒功能转化为可由 Agent 通过 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，一行命令：

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

身份验证

所有工具都按账户隔离。将你的 __Host-sid Cookie 值（从已登录的 three.ws 浏览器会话中获取：DevTools → Application → Cookies → __Host-sid）设置为 THREE_WS_SESSION。服务会像浏览器一样发送该值；对于写入操作，它会先从 /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	写入（破坏性操作）	永久删除规则及其触发／送达历史记录。建议使用 update_alert_rule 并设置 enabled:false 来暂停规则。
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，默认值为 high、critical）、subject	,

至少启用一个发送渠道：deliver_in_app（默认值为 true）、webhook_url（HTTPS——系统会为每条规则生成一个 webhook_secret，用于验证 webhook-signature 标头），和/或 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	每次请求的超时时间（毫秒）。

编程方式使用

此软件包的入口点导出 TOOLS（每个工具的定义：name、title、 description、inputSchema、annotations、handler）和 buildServer()，后者会返回一个 已完整注册但未附加传输的 McpServer。导入不会产生副作用，也不需要 会话，因此你可以将告警工具挂载到自己的宿主中，或离线检查工具面；只有在实际运行处理程序时才需要会话。

// 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 Agent、链上身份和 Agent 支付。
网站 · 更新日志 · GitHub}