cryptoiz-mcp

April 29, 2026 · View on GitHub

npm version License: MIT x402scan MCP Marketplace

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).

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:

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

ToolCostDescription
get_whale_alpha$0.10 USDCTop 20 alpha signals — whale/dolphin accumulation, entry timing
get_whale_divergence$0.04 USDCHidden/breakout/classic divergence signals (4h/1d)
get_whale_accumulation$0.03 USDCTokens with smart money accumulating
get_whale_neutral$0.03 USDCTokens in transition phase
get_whale_distribution$0.04 USDCTokens with whales selling (exit signal)
get_btc_regime$0.02 USDCBTC macro regime + sentiment + technicals
get_btc_futures_signal$0.06 USDCBTC futures multi-timeframe signal (54% WR)
get_token_caFREELook up Solana contract address by name
get_statusFREEServer status, available tools, pricing

All payments settle on Solana mainnet via Dexter facilitator. Recipient: DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX.

For users who prefer self-custody with their own Solana wallet:

1. Install the package globally

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).

{
  "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

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.

License

MIT © CryptoIZ