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

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.