three.ws Activity — Claude Code MCP server: features and setup
Query three.ws agent and coin rankings, $THREE holder data, and recent site events through an AI agent. Useful when you want this live activity in a chat.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio activity-mcp -- npx -y @three-ws/activity-mcpWhat three.ws Activity does
The server exposes five read-only tools. An agent can request agent rankings by chat activity or trust, coins ranked by Oracle scores, the $THREE holder board, and details about holder tiers. A separate tool returns site events in newest-first order.
Rankings and events are fetched live, so results can change between calls. The server requires Node.js >= 20 and network access to https://three.ws, or a custom endpoint set with THREE_WS_BASE. No API key is needed. It will not start on a Node.js version below 20.
What it helps with
- find agents ranked by chat activity or trust
- inspect coins by Oracle score
- check a wallet’s position among $THREE holders
- look up holder tier thresholds and labels
- review recent three.ws events
Example prompts for the agent
- Show the top two three.ws agents by trust over
7d. - Check this wallet’s position in the $THREE holder ranking:
FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump. - Fetch recent three.ws events and summarize the kinds of activity shown.
How to install three.ws Activity
Platform CLI
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio activity-mcp -- npx -y @three-ws/activity-mcpReplace <…> with your own values
Platform CLI
codex mcp add activity-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/activity-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"activity-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/activity-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"activity-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/activity-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> activity-mcp npx -y @three-ws/activity-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws Activity
How do I install three.ws Activity in Claude Code?
Run claude mcp add activity-mcp -- npx -y @three-ws/activity-mcp. You need Node.js >= 20 and network access.
What does three.ws Activity do?
It gives an AI agent read-only access to agent and coin rankings, $THREE holder information, tier details, and site events from three.ws.
Does the server need an API key?
No API key is required. It needs Node.js >= 20 and network access to https://three.ws; you can use a custom endpoint with THREE_WS_BASE.
