@three-ws/intel-mcp

Read the market the way the smart money does — smart-money scoring, wallet intel, signal feeds, KOL trades, and the copy-trade directory, from any AI agent.

---

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

Tool	Type	What it does
smart_money_coin	read-only	Score a coin by WHO is net-buying it — 0–100 smart-money score, reputable buyers, funder clusters, sybil flag.
wallet_intel	read-only	One wallet's realized reputation: score, win rate, behavioral labels, and its funder cluster.
signal_feed	read-only	A signal feed's proven accuracy (hit-rate, realized/follower ROI) and recent emissions with on-chain proof.
kol_leaderboard	read-only	Rank tracked KOL traders by realized P&L over a 7d / 30d window.
kol_trades	read-only	Recent KOL trades on a specific mint, across the tracked KOL set.
copy_smart_wallets	read-only	Browse 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

Variable	Required	Default
THREE_WS_BASE	no	https://three.ws
THREE_WS_TIMEOUT_MS	no	20000

Links

• Homepage: https://three.ws
• Changelog: https://three.ws/changelog
• Issues: https://github.com/nirholas/three.ws/issues
• License: Apache-2.0, see LICENSE

---

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

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

• All repositories by nirholas: the full catalog, grouped by topic
• three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
• Questions or ideas: open an issue or start a discussion

Contributors

Star history

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.

• Documentation site: https://nirholas.github.io/intel-mcp/
• npm: https://www.npmjs.com/package/@three-ws/intel-mcp
• Canonical source: https://github.com/nirholas/three.ws (this repository is a generated mirror of packages/intel-mcp)
• Agent-readable summary: llms.txt and AGENTS.md
• Issues and ideas: https://github.com/nirholas/intel-mcp/issues