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 分