# three.ws Activity

> three.ws Activity is a free MCP server for analytics and data. Read-only feed of trending agents, coins and the $THREE holder leaderboard. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Website:** https://three.ws
- **Repository:** https://github.com/nirholas/three.ws/tree/HEAD/packages/activity-mcp
- **MCP Registry name:** io.github.nirholas/activity-mcp
- **Categories:** analytics and data, finance and payments
- **Listing updated:** 2026-11-15

## About

Five live read tools expose what is moving on the three.ws platform. Agents are ranked by real chat activity over 24 hours, 7 days or all time, optionally sorted by wallet-trust reputation. Coins are ranked by the Oracle's 0 to 100 conviction score with momentum, pedigree, structure and narrative sub-scores.

The $THREE holder leaderboard ranks wallets by on-chain balance, includes tiers and a market strip, and takes an optional wallet to add a you-are-number-N standing. A separate tool returns the tier ladder with each band's minimum balance, and a feed tool returns the site-wide ticker of coin buys, agent deploys, level-ups and payments, newest first.

Nothing needs a key, signer or payment. Results are live and not idempotent between calls. Set THREE_WS_BASE to point at a self-hosted or preview deployment.

## Features

- **Trending agents:** Ranked by chat activity over 24h, 7d or all time, or by trust.
- **Trending coins:** Oracle conviction score with four sub-scores.
- **Holder leaderboard:** Ranked by on-chain balance with tiers and your own rank.
- **Tier ladder:** Each band's label, minimum balance and badge accent.
- **Activity ticker:** Newest-first feed of buys, deploys, level-ups and payments.
- **Configurable base URL:** Point at a self-hosted deployment.

## Good for

- See which three.ws agents got the most chats this week
- Find where a wallet ranks among $THREE holders
- Look up what each holder tier requires
- Watch recent coin buys and agent deploys
- Rank coins by conviction score

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "activity-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/activity-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_trending_agents`: Agents ranked by chat activity or trust.
- `get_trending_coins`: Coins ranked by Oracle conviction score.
- `get_holder_leaderboard`: The $THREE holder board with tiers.
- `get_tier_info`: The holder tier ladder.
- `get_feed_events`: The site-wide activity ticker.

## FAQ

### Does it need a key?

No key, signer or payment is needed.

### Is it read-only?

Yes, all five tools are read-only.

### What time windows exist for trending agents?

24h, 7d and all.

### Can I use a different server?

Yes, set THREE_WS_BASE.

### Is three.ws Activity free?

Yes. three.ws Activity is free to use.

### How do I add three.ws Activity to Claude Code?

Run this command in your terminal: claude mcp add activity-mcp -- npx -y @three-ws/activity-mcp

### What are the best alternatives to three.ws Activity?

The closest alternatives to three.ws Activity are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/three-ws-activity
