Skip to content
Conduit

mcp server

intel-mcp

three.ws market intelligence from any AI agent — smart-money scoring, wallet intel, signal feeds, KOL leaderboards/trades, and the copy-trade Smart Money directory. Read-only over the live public API.

nirholas/intel-mcpcommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "nirholas-intel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/intel-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 25, 2026

A Model Context Protocol server that gives any AI assistant the three.ws market-intelligence surface over stdio. Judge a coin by who is buying it, pull a wallet's realized reputation, read a signal feed's proven accuracy, rank KOL traders, and browse the copy-trade Smart Money directory — all live, read-only, no key required.

Every score, signal, and ranking 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

npm install @three-ws/intel-mcp

Or run with npx (no install):

npx @three-ws/intel-mcp

Quick start

Claude Code, one line:

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

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

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

Inspect the surface with the MCP Inspector:

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

Tools

ToolTypeWhat it does
smart_money_coinread-onlyScore a coin by WHO is net-buying it — 0–100 smart-money score, reputable buyers, funder clusters, sybil flag.
wallet_intelread-onlyOne wallet's realized reputation: score, win rate, behavioral labels, and its funder cluster.
signal_feedread-onlyA signal feed's proven accuracy (hit-rate, realized/follower ROI) and recent emissions with on-chain proof.
kol_leaderboardread-onlyRank tracked KOL traders by realized P&L over a 7d / 30d window.
kol_tradesread-onlyRecent KOL trades on a specific mint, across the tracked KOL set.
copy_smart_walletsread-onlyBrowse the ranked copy-trade Smart Money directory — filter by chain, category, and sort.

All six tools read live data: scores, feeds, and rankings move between calls, so none are idempotent.

Input parameters

smart_money_coin — mint (required), network (mainnet | devnet, default mainnet).

wallet_intel — wallet (required), network (mainnet | devnet, default mainnet).

signal_feed — slug (required), network (mainnet | devnet, default mainnet).

kol_leaderboard — window (7d | 30d, default 7d), limit (1–100, default 25).

kol_trades — mint (required), limit (1–100, default 20).

copy_smart_wallets — chain (sol | bsc), category (smart_money | launchpad | kol | sniper), sort (profit | pnl | winrate | followers | score, default score), q (text), limit (1–100, default 30), offset (default 0).

Example

// copy_smart_wallets
> { "chain": "sol", "sort": "winrate", "limit": 3 }
{
  "ok": true,
  "count": 3,
  "total": 412,
  "offset": 0,
  "limit": 3,
  "has_more": true,
  "facets": { "byChain": { "sol": 300, "bsc": 112 }, "byCategory": { "smart_money": 180, "kol": 90 } },
  "wallets": [
    { "address": "…", "chain": "sol", "categories": ["smart_money"], "score": 94, "win_rate_30d": 0.71, "realized_profit_30d_usd": 182000, "follow_count": 1240 }
  ]
}

// smart_money_coin
> { "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump" }
{
  "ok": true,
  "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
  "network": "mainnet",
  "computed": true,
  "smart_money_score": 78,
  "reputable_buyers": 12,
  "sybil_flag": false,
  "sybil_share": 0.18,
  "wallets": [ /* reputable buyers with realized_score, win_rate, labels */ ],
  "clusters": [ /* funder clusters in the book */ ]
}

computed: false on a coin or wallet means the smart-money graph has no on-chain history for it yet — that's an honest "not enough data", not a failure.

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

Support the project

If intel-mcp saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.

Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit

Built for AI agents too

Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/intel-mcp and it has the context it needs.

More from the same author

Contributors

Contributors

Star history

Star History Chart

Part of three.ws

three.ws is a platform for 3D AI agents with Solana wallets: avatars, a skill marketplace, x402 payments and more than seventy MCP servers. @three-ws/intel-mcp is one package from it.

↑↓ navigate openesc close