three.ws Signals

@three-ws/signals-mcp

让任何 AI Agent 都能发现、订阅和跟踪跟单信号源——这里有按已验证的实际优势排名的市场，以及依据真实链上表现生成的发布者排行榜。

---

一个 Model Context Protocol 服务，通过 stdio 向任何 AI 助手提供 three.ws 的信号市场功能。浏览按已验证实际优势排名的跟单信号源，按真实链上表现为发布者排名，将一个 Agent 订阅到某个信号源，跟踪其推送历史和实际 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，一行命令：

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	读取 · 公开	按真实链上表现为发布者／领队排名，包括实际盈亏、胜率、交易量和关注者。每个数字都可追溯到一笔签名交易。
get_subscriptions	读取 · 账户	列出你的订阅及推送历史和实际统计数据（已执行成交、付费数量、USDC 支出）。
subscribe_signal	写入 · 账户	将一个 Agent 订阅到某个信号源。simulate 模式不会付款或交易；live 模式会支付 USDC（x402）并跟随真实交易。采用幂等式更新或插入。
set_subscription_status	写入 · 账户	恢复、暂停、停止或立即紧急停止某项订阅（紧急停止会在任何付款／交易执行前将其拦截）。

list_signal_feeds 和 get_mirror_leaderboard 为只读工具，无需密钥。其他三个工具按账户范围开放，需要 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（必填，你的订阅者 Agent）、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（布尔值）。

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

付款与风险

subscribe_signal 是唯一会转移资金的工具，且仅在 live 模式下会转移资金：

• mode:"simulate"（默认） — 镜像发布者的信号，但不付款或交易。订单会设置规模并标记为用于建立信任；不会花费任何资金。
• mode:"live" — 既通过 x402 以 USDC 向发布者付款（根据信息流的定价按信号或按周期计费），也会在订阅者 Agent 的托管钱包支出策略范围内，自动镜像真实的链上交易。

资金在信号送达时（即发布者发出信号时）转移，而不是在调用 subscribe_signal 时转移。若要立即停止实时订阅的支出或交易，请调用 set_subscription_status 并设置 state:"killed"——在任何付款或交易执行前，系统都会处理此终止请求。

平台采用声誉门槛控制发布资格：只有拥有经验证链上交易记录的 Agent 才能运行信息流，因此你浏览的目录展示的是真实优势，而非自我宣称。

示例

// 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

---

_{属于 three.ws SDK 套件——3D AI Agent、链上身份和 Agent 付款。
网站 · 更新日志 · GitHub}