io.github.dadang11/cryptoiz
Solana DEX whale intelligence: alpha, divergence, phase scoring, BTC regime. USDC payments via x402.
Open source Open in the app JSON README (API)
About
Solana DEX whale intelligence: alpha, divergence, phase scoring, BTC regime. USDC payments via x402.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- dadang11
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 4.16.17
- Stars
- 1
- Last push
- 2026-04-29T21:24:35Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:39
- Updated
- 2026-08-29 03:02:39
- Origin id
io.github.dadang11/cryptoiz
README
# cryptoiz-mcp
[](https://www.npmjs.com/package/cryptoiz-mcp)
[](https://opensource.org/licenses/MIT)
[](https://x402scan.com/server/cbd8fff5-d636-4331-b22b-3291717a4e9e)
[](https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz)
**CryptoIZ MCP Server** — Solana DEX whale intelligence as a Model Context Protocol (MCP) server. 9 tools (7 paid + 2 free) for Claude Desktop, Cursor, Codex, and any agentcash-compatible client. Native Solana via x402 V2 + Dexter facilitator (gas-sponsored — no SOL needed, only USDC).
## ⚡ Recommended Install (1 line)
```bash
npx agentcash add https://mcp.cryptoiz.org
```
That's it. agentcash auto-generates a Solana wallet at `~/.agentcash/wallet.json` (no private key in your Claude config). Fund with $1-5 USDC via `npx agentcash fund` and you're ready.
**Why agentcash:**
- ✅ No private key in Claude Desktop config
- ✅ Wallet auto-generated and isolated
- ✅ Gas sponsored by Dexter (zero SOL needed)
- ✅ Update tools without reinstalling client
- ✅ One wallet across ALL x402 services (CryptoIZ, HYRE, etc.)
## 5 Specialized Sub-Agents
Pick what you need:
```bash
npx agentcash add https://mcp.cryptoiz.org/agents/alpha # Whale alpha signals only
npx agentcash add https://mcp.cryptoiz.org/agents/btc # BTC regime + futures
npx agentcash add https://mcp.cryptoiz.org/agents/phases # Accumulation/Neutral/Distribution
npx agentcash add https://mcp.cryptoiz.org/agents/divergence # Divergence patterns
npx agentcash add https://mcp.cryptoiz.org/agents/deep-research # Token deep-dive combo
```
## Tools & Pricing
| Tool | Cost | Description |
|---|---|---|
| `get_whale_alpha` | $0.10 USDC | Top 20 alpha signals — whale/dolphin accumulation, entry timing |
| `get_whale_divergence` | $0.04 USDC | Hidden/breakout/classic divergence signals (4h/1d) |
| `get_whale_accumulation` | $0.03 USDC | Tokens with smart money accumulating |
| `get_whale_neutral` | $0.03 USDC | Tokens in transition phase |
| `get_whale_distribution` | $0.04 USDC | Tokens with whales selling (exit signal) |
| `get_btc_regime` | $0.02 USDC | BTC macro regime + sentiment + technicals |
| `get_btc_futures_signal` | $0.06 USDC | BTC futures multi-timeframe signal (54% WR) |
| `get_token_ca` | FREE | Look up Solana contract address by name |
| `get_status` | FREE | Server status, available tools, pricing |
All payments settle on Solana mainnet via [Dexter facilitator](https://x402.dexter.cash). Recipient: `DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`.
## Legacy Setup (Advanced — not recommended)
For users who prefer self-custody with their own Solana wallet:
### 1. Install the package globally
```bash
npm install -g cryptoiz-mcp
```
### 2. Get a Solana wallet private key (base58)
You need a Solana wallet with at least **$1 USDC** on mainnet. **No SOL needed** — Dexter sponsors all gas. Recommended: dedicated wallet, NOT your main wallet. Phantom: Settings > Security > Export Private Key.
### 3. Edit Claude Desktop config
File: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS).
```json
{
"mcpServers": {
"cryptoiz": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\<YOU>\\AppData\\Roaming\\npm\\node_modules\\cryptoiz-mcp\\index.js"],
"env": {
"SVM_PRIVATE_KEY": "<your_base58_solana_private_key>"
}
}
}
}
```
### 4. Restart Claude Desktop
Then ask Claude: `get cryptoiz status` — you should see version `v4.16.17` and the tool list.
## Security
- **agentcash flow** (recommended): private key auto-generated and isolated, never in Claude config
- **Gas-sponsored**: Dexter facilitator pays all gas (you only pay USDC)
- **Server-side validation**: every payment verified via Dexter `/settle` before serving data
- **x402 V2 spec compliant**: open standard, no custom protocol
- **No tracking**: only on-chain transaction signature is recorded for replay protection
- **Dedicated wallet recommended** for legacy npm install (don't use your main wallet)
## Listed at
- [MCP Marketplace](https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz)
- [x402scan](https://x402scan.com/server/cbd8fff5-d636-4331-b22b-3291717a4e9e) — 94+ tx, $2.80+ volume
- [Official MCP Registry](https://github.com/modelcontextprotocol/registry)
- MPPscan (pending)
## Architecture
```
Claude Desktop / Cursor / Codex
│ (MCP)
▼
agentcash CLI (or cryptoiz-mcp legacy npm)
│ (HTTP)
▼
mcp.cryptoiz.org gateway (Cloudflare Worker + Supabase Edge Function)
│ (POST /settle)
▼
Dexter facilitator (x402.dexter.cash)
│ (signs + broadcasts)
▼
Solana mainnet
```
## Troubleshooting
### "Transaction simulation failed"
Update to latest: `npx agentcash add https://mcp.cryptoiz.org` (or `npm install -g cryptoiz-mcp@latest` for legacy).
### "Server disconnected" on Windows
Use absolute paths in Claude config (legacy npm only). agentcash flow doesn't have this issue.
### Update notifications keep showing
Run `npm install -g cryptoiz-mcp@latest`, force-kill all `node.exe` processes via Task Manager, then restart Claude Desktop. Or switch to agentcash for auto-updates.
## Links
- **Platform**: https://cryptoiz.org
- **Setup guide**: https://cryptoiz.org/McpLanding
- **Twitter**: [@cryptoiz_IDN](https://twitter.com/cryptoiz_IDN)
- **Telegram**: https://t.me/agus_artemiss
- **MCP Marketplace**: https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz
- **x402scan**: https://x402scan.com/server/mcp.cryptoiz.org
## License
MIT © CryptoIZ