@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](https://modelcontextprotocol.io) 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
```bash
npm install @three-ws/intel-mcp
```
Or run with `npx` (no install):
```bash
npx @three-ws/intel-mcp
```
## Quick start
**Claude Code**, one line:
```bash
claude mcp add intel -- npx -y @three-ws/intel-mcp
```
**Claude Desktop / Cursor** (`claude_desktop_config.json` or `mcp.json`):
```json
{
"mcpServers": {
"intel": {
"command": "npx",
"args": ["-y", "@three-ws/intel-mcp"]
}
}
}
```
Inspect the surface with the MCP Inspector:
```bash
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
```jsonc
// 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 }
]
}
```
```jsonc
// 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](./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](https://github.com/nirholas/intel-mcp)**. 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](https://twitter.com/intent/tweet?text=intel-mcp%3A%20three.ws%20market%20intelligence%20from%20any%20AI%20agent%3A%20smart-money%20scoring%2C%20wallet%20intel%2C%20signal%20feeds&url=https%3A%2F%2Fgithub.com%2Fnirholas%2Fintel-mcp) · [Share on Bluesky](https://bsky.app/intent/compose?text=intel-mcp%3A%20three.ws%20market%20intelligence%20from%20any%20AI%20agent%3A%20smart-money%20scoring%2C%20wallet%20intel%2C%20signal%20feeds%20https%3A%2F%2Fgithub.com%2Fnirholas%2Fintel-mcp) · [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fgithub.com%2Fnirholas%2Fintel-mcp) · [Submit to Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fgithub.com%2Fnirholas%2Fintel-mcp&t=intel-mcp%3A%20three.ws%20market%20intelligence%20from%20any%20AI%20agent%3A%20smart-money%20scoring%2C%20wallet%20intel%2C%20signal%20feeds) · [Share on Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fgithub.com%2Fnirholas%2Fintel-mcp&title=intel-mcp%3A%20three.ws%20market%20intelligence%20from%20any%20AI%20agent%3A%20smart-money%20scoring%2C%20wallet%20intel%2C%20signal%20feeds)
## Built for AI agents too
Coding agents and LLM tooling can read this repo directly: [AGENTS.md](./AGENTS.md), [llms.txt](./llms.txt), [llms-full.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](https://github.com/nirholas/nirholas#readme): the full catalog, grouped by topic
- [three.ws](https://three.ws): the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
- Questions or ideas: [open an issue](https://github.com/nirholas/intel-mcp/issues) or [start a discussion](https://github.com/nirholas/intel-mcp/discussions)
## Contributors
[](https://github.com/nirholas/intel-mcp/graphs/contributors)
## Star history
[](https://www.star-history.com/#nirholas/intel-mcp&Date)
## Part of three.ws
[three.ws](https://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](./llms.txt) and [AGENTS.md](./AGENTS.md)
- Issues and ideas: https://github.com/nirholas/intel-mcp/issues