io.github.dadang11/cryptoiz

Official

by dadang11 · JavaScript

Solana DEX whale intelligence: alpha, divergence, phase scoring, BTC regime. USDC payments via x402.

Analyze Solana DEX whale activity with alpha signals and market regime scoring.

Topics

claudeclaude-desktopcryptodefidexdextermcpmcp-servermodel-context-protocolsmart-moneysolanatradingusdcwhale-trackingx402

README.md6 KBView on GitHub

cryptoiz-mcp

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. 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
x402scan — 94+ tx, $2.80+ volume
Official MCP Registry
MPPscan (pending)

Architecture

code

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.

License

MIT © CryptoIZ

Install

Configuration

Environment variables

SVM_PRIVATE_KEY

Your Solana wallet private key (base58) for x402 USDC payments. Optional if using agentcash (recommended).

claude_desktop_config.json

{
  "mcpServers": {
    "cryptoiz": {
      "command": "npx",
      "args": [
        "-y",
        "cryptoiz-mcp@4.16.17"
      ],
      "env": {
        "SVM_PRIVATE_KEY": "<YOUR_SVM_PRIVATE_KEY>"
      }
    }
  }
}

Topics

cryptoiz-mcp

⚡ Recommended Install (1 line)

5 Specialized Sub-Agents

Tools & Pricing

Legacy Setup (Advanced — not recommended)

1. Install the package globally

2. Get a Solana wallet private key (base58)

3. Edit Claude Desktop config

4. Restart Claude Desktop

Security

Listed at

Architecture

Troubleshooting

"Transaction simulation failed"

"Server disconnected" on Windows

Update notifications keep showing

Links

License

Install

Configuration