three.ws Activity

@three-ws/activity-mcp

three.ws 上此刻的热门内容——趋势 Agent 和代币、带有等级划分的 $THREE 持有者排行榜，以及全站活动动态，任何 AI Agent 均可获取。

---

一个通过标准输入/输出向任何 AI 助手提供 three.ws 实时发现功能的 Model Context Protocol 服务。查看哪些 Agent 根据真实聊天活动成为趋势、Oracle 最看好的代币、某个钱包在 $THREE 持有者排行榜中的位置、各持有者等级的含义，以及平台当前发生的动态——所有数据均为实时、只读，且无需密钥。

所有排名、等级和事件都直接来自 three.ws 公共 API。无需 API 密钥、签名者或付款——将 THREE_WS_BASE 指向一个部署实例即可开始使用。

安装

npm install @three-ws/activity-mcp

也可以使用 npx 运行（无需安装）：

npx @three-ws/activity-mcp

快速开始

Claude Code，一行命令：

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

Claude Desktop / Cursor（claude_desktop_config.json 或 mcp.json）：

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

使用 MCP Inspector 检查功能：

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

工具

工具	类型	功能
get_trending_agents	只读	按 24h / 7d / all 时间范围内的真实聊天活动为 Agent 排名——也可选择结合钱包信任度声誉。
get_trending_coins	只读	按 Oracle 的 0–100 看好度评分为代币排名，并提供动能/背景/结构/叙事子评分。
get_holder_leaderboard	只读	按链上余额排序的 $THREE 持有者排行榜，包含等级、实时市场动态，以及“你是第 #N 名”的查询结果。
get_tier_info	只读	$THREE 持有者等级阶梯——每个等级的标签、最低余额和徽章强调色。
get_feed_events	只读	全站活动动态——代币买入、Agent 部署、升级、付款等，按时间从新到旧排列。

这五个工具读取的都是实时数据：排名、持有者排行榜和动态源在每次调用之间都会变化，因此它们都不是幂等的。

输入参数

get_trending_agents — window（24h | 7d | all，默认 24h）、sort（activity | trust，默认 activity）、limit（1–20，默认 10）。

get_trending_coins — limit（1–20，默认 10）。

get_holder_leaderboard — limit（1–100，默认 50）、offset（默认 0）、wallet（可选的 base58 地址——添加该钱包自身的 you 排名）。

get_tier_info — 无参数。

get_feed_events — limit（1–100，默认 30）。

示例

// get_trending_agents
> { "window": "7d", "limit": 2 }
{
  "ok": true,
  "window": "7d",
  "sort": "activity",
  "generated_at": "2026-06-24T12:00:00.000Z",
  "count": 2,
  "agents": [
    {
      "rank": 1,
      "id": "…",
      "name": "Luna",
      "description": "A 3D companion agent",
      "avatar_thumbnail_url": "https://…",
      "chat_count": 18420,
      "window_chats": 2310,
      "is_onchain": true,
      "agent_url": "https://three.ws/agent/…",
      "reputation": { "score": 82, "tier": "trusted", "tierLabel": "Trusted", "isNew": false }
    }
  ]
}

// get_holder_leaderboard
> { "limit": 1, "wallet": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump" }
{
  "ok": true,
  "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
  "total": 4821,
  "supply": 1000000000,
  "decimals": 6,
  "holders": [
    { "rank": 1, "wallet": "…", "wallet_short": "AbCd…wXyZ", "amount": 42000000, "pct_of_supply": 0.042, "tier": "genesis" }
  ],
  "tiers": [ { "id": "genesis", "label": "Genesis", "min": 10000000, "accent": "#f5d0a9" } ],
  "market": { "price_usd": 0.0031, "market_cap": 3100000, "holders": 4821 },
  "you": { "rank": 137, "amount": 25400, "pct_of_supply": 0.0000254, "tier": "gold" }
}

$THREE 持有者排行榜针对的是 $THREE——这是 three.ws 唯一为其持有者排名的代币（CA FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump）。趋势代币列表是平台运行时的发行目录发现数据：它展示 Oracle 评分的排名，绝不构成对任何代币的推荐。

要求

• Node.js >= 20。
• 可访问 https://three.ws 的网络（或使用你自己的 THREE_WS_BASE）。

环境变量

变量	必需	默认值
THREE_WS_BASE	否	https://three.ws
THREE_WS_TIMEOUT_MS	否	20000

链接

• 主页：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}