three.ws Activity

io.github.nirholas由 GitHub 账号 nirholas 发布v0.1.3更新于 Oct 24, 2026

Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

一个本地 stdio MCP 服务器，让助手读取 three.ws 的实时发现数据：热门智能体与代币、$THREE 持有者排行榜、等级和全站动态。

可以做什么
按 24 小时、7 天或全部时间读取按聊天活跃度排名的热门智能体，可按钱包信任声誉排序，上限 20 条。读取按 Oracle 信心评分排名的热门代币及其子评分。读取按链上余额排序的 $THREE 持有者排行榜，含等级、行情条和可选的钱包排名查询。读取持有者等级阶梯，含标签与最低余额。读取全站动态，包括代币买入、智能体部署、升级和支付，按时间倒序。
适用场景
适合让助手汇报 three.ws 当前的热门内容、查询某个钱包在 $THREE 持有者榜上的位置，或总结近期平台动态。它只是只读的发现接口，不是交易或钱包工具。
运行要求
需要 Node.js 20 或更高版本，通过 npx 或 npm install 在本地运行。需要能访问 three.ws API 的网络。可选环境变量 THREE_WS_BASE（默认公共站点）和 THREE_WS_TIMEOUT_MS（默认 20000）。无需 API 密钥或账号。
安装前请注意
所有数据来自 three.ws 公共 API，因此查询内容以及传给排行榜查询的钱包地址都会发送给该第三方；修改 THREE_WS_BASE 会把请求改发到别处。结果是实时数据，每次调用可能不同。热门代币排名属于发现数据，不构成投资建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 three.ws Activity，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[three.ws]

@three-ws/activity-mcp

What's hot on three.ws right now — trending agents and coins, the $THREE holder leaderboard with tiers, and the site-wide activity ticker, from any AI agent.

[npm] [license] [node] [MCP Registry] [three.ws]

A Model Context Protocol server that gives any AI assistant the three.ws live discovery surface over stdio. See which agents are trending by real chat activity, which coins the Oracle has the highest conviction in, where a wallet sits on the $THREE holder leaderboard, what each holder tier means, and what's happening across the platform right now — all live, read-only, no key required.

Every ranking, tier, and event comes straight from the public three.ws API. No API key, no signer, no payment — point THREE_WS_BASE at a deployment and go.

Install

bash
npm install @three-ws/activity-mcp

Or run with npx (no install):

bash
npx @three-ws/activity-mcp

Quick start

Claude Code, one line:

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

Claude Desktop / Cursor (claude_desktop_config.json or mcp.json):

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

Inspect the surface with the MCP Inspector:

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

Tools

ToolTypeWhat it does
get_trending_agentsread-onlyAgents ranked by real chat activity over a 24h / 7d / all window — optionally blending wallet-trust reputation.
get_trending_coinsread-onlyCoins ranked by the Oracle's 0–100 conviction score, with momentum/pedigree/structure/narrative sub-scores.
get_holder_leaderboardread-onlyThe $THREE holder board ranked by on-chain balance, with tiers, the live market strip, and a "you are #N" lookup.
get_tier_inforead-onlyThe $THREE holder tier ladder — each band's label, minimum balance, and badge accent.
get_feed_eventsread-onlyThe site-wide activity ticker — coin buys, agent deploys, level-ups, payments, and more, newest-first.

All five tools read live data: rankings, the holder board, and the feed all move between calls, so none are idempotent.

Input parameters

get_trending_agents — window (24h | 7d | all, default 24h), sort (activity | trust, default activity), limit (1–20, default 10).

get_trending_coins — limit (1–20, default 10).

get_holder_leaderboard — limit (1–100, default 50), offset (default 0), wallet (optional base58 — adds the wallet's own you standing).

get_tier_info — no parameters.

get_feed_events — limit (1–100, default 30).

Example

jsonc
// 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 }    }  ]}
jsonc
// 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" }}

The $THREE holder leaderboard is for $THREE — the only coin three.ws ranks holders for (CA FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump). The trending-coins list is the platform's runtime launch-directory discovery data: a ranking of what the Oracle scored, never a recommendation of any coin.

Requirements

  • Node.js >= 20.
  • Network access to https://three.ws (or your own THREE_WS_BASE).

Environment variables

VariableRequiredDefault
THREE_WS_BASEnohttps://three.ws
THREE_WS_TIMEOUT_MSno20000

Links

Part of the three.ws SDK suite — 3D AI agents, on-chain identity, and agent payments.
Website · Changelog · GitHub

来源：packages/activity-mcp/README.md，提交 c8f2cde

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

2
  1. v0.1.3最新Oct 10, 2026
  2. v0.1.2Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分