{
  "markdown": "# cryptoiz-mcp\n\n[![npm version](https://img.shields.io/npm/v/cryptoiz-mcp.svg)](https://www.npmjs.com/package/cryptoiz-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![x402scan](https://img.shields.io/badge/x402scan-listed-blue)](https://x402scan.com/server/cbd8fff5-d636-4331-b22b-3291717a4e9e)\n[![MCP Marketplace](https://img.shields.io/badge/MCP_Marketplace-listed-green)](https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz)\n\n**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).\n\n## ⚡ Recommended Install (1 line)\n\n```bash\nnpx agentcash add https://mcp.cryptoiz.org\n```\n\nThat'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.\n\n**Why agentcash:**\n- ✅ No private key in Claude Desktop config\n- ✅ Wallet auto-generated and isolated\n- ✅ Gas sponsored by Dexter (zero SOL needed)\n- ✅ Update tools without reinstalling client\n- ✅ One wallet across ALL x402 services (CryptoIZ, HYRE, etc.)\n\n## 5 Specialized Sub-Agents\n\nPick what you need:\n\n```bash\nnpx agentcash add https://mcp.cryptoiz.org/agents/alpha          # Whale alpha signals only\nnpx agentcash add https://mcp.cryptoiz.org/agents/btc            # BTC regime + futures\nnpx agentcash add https://mcp.cryptoiz.org/agents/phases         # Accumulation/Neutral/Distribution\nnpx agentcash add https://mcp.cryptoiz.org/agents/divergence     # Divergence patterns\nnpx agentcash add https://mcp.cryptoiz.org/agents/deep-research  # Token deep-dive combo\n```\n\n## Tools & Pricing\n\n| Tool | Cost | Description |\n|---|---|---|\n| `get_whale_alpha` | $0.10 USDC | Top 20 alpha signals — whale/dolphin accumulation, entry timing |\n| `get_whale_divergence` | $0.04 USDC | Hidden/breakout/classic divergence signals (4h/1d) |\n| `get_whale_accumulation` | $0.03 USDC | Tokens with smart money accumulating |\n| `get_whale_neutral` | $0.03 USDC | Tokens in transition phase |\n| `get_whale_distribution` | $0.04 USDC | Tokens with whales selling (exit signal) |\n| `get_btc_regime` | $0.02 USDC | BTC macro regime + sentiment + technicals |\n| `get_btc_futures_signal` | $0.06 USDC | BTC futures multi-timeframe signal (54% WR) |\n| `get_token_ca` | FREE | Look up Solana contract address by name |\n| `get_status` | FREE | Server status, available tools, pricing |\n\nAll payments settle on Solana mainnet via [Dexter facilitator](https://x402.dexter.cash). Recipient: `DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`.\n\n## Legacy Setup (Advanced — not recommended)\n\nFor users who prefer self-custody with their own Solana wallet:\n\n### 1. Install the package globally\n\n```bash\nnpm install -g cryptoiz-mcp\n```\n\n### 2. Get a Solana wallet private key (base58)\n\nYou 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.\n\n### 3. Edit Claude Desktop config\n\nFile: `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS).\n\n```json\n{\n  \"mcpServers\": {\n    \"cryptoiz\": {\n      \"command\": \"C:\\\\Program Files\\\\nodejs\\\\node.exe\",\n      \"args\": [\"C:\\\\Users\\\\<YOU>\\\\AppData\\\\Roaming\\\\npm\\\\node_modules\\\\cryptoiz-mcp\\\\index.js\"],\n      \"env\": {\n        \"SVM_PRIVATE_KEY\": \"<your_base58_solana_private_key>\"\n      }\n    }\n  }\n}\n```\n\n### 4. Restart Claude Desktop\n\nThen ask Claude: `get cryptoiz status` — you should see version `v4.16.17` and the tool list.\n\n## Security\n\n- **agentcash flow** (recommended): private key auto-generated and isolated, never in Claude config\n- **Gas-sponsored**: Dexter facilitator pays all gas (you only pay USDC)\n- **Server-side validation**: every payment verified via Dexter `/settle` before serving data\n- **x402 V2 spec compliant**: open standard, no custom protocol\n- **No tracking**: only on-chain transaction signature is recorded for replay protection\n- **Dedicated wallet recommended** for legacy npm install (don't use your main wallet)\n\n## Listed at\n\n- [MCP Marketplace](https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz)\n- [x402scan](https://x402scan.com/server/cbd8fff5-d636-4331-b22b-3291717a4e9e) — 94+ tx, $2.80+ volume\n- [Official MCP Registry](https://github.com/modelcontextprotocol/registry)\n- MPPscan (pending)\n\n## Architecture\n\n```\nClaude Desktop / Cursor / Codex\n     │ (MCP)\n     ▼\nagentcash CLI (or cryptoiz-mcp legacy npm)\n     │ (HTTP)\n     ▼\nmcp.cryptoiz.org gateway (Cloudflare Worker + Supabase Edge Function)\n     │ (POST /settle)\n     ▼\nDexter facilitator (x402.dexter.cash)\n     │ (signs + broadcasts)\n     ▼\nSolana mainnet\n```\n\n## Troubleshooting\n\n### \"Transaction simulation failed\"\nUpdate to latest: `npx agentcash add https://mcp.cryptoiz.org` (or `npm install -g cryptoiz-mcp@latest` for legacy).\n\n### \"Server disconnected\" on Windows\nUse absolute paths in Claude config (legacy npm only). agentcash flow doesn't have this issue.\n\n### Update notifications keep showing\nRun `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.\n\n## Links\n\n- **Platform**: https://cryptoiz.org\n- **Setup guide**: https://cryptoiz.org/McpLanding\n- **Twitter**: [@cryptoiz_IDN](https://twitter.com/cryptoiz_IDN)\n- **Telegram**: https://t.me/agus_artemiss\n- **MCP Marketplace**: https://mcp-marketplace.io/server/io-github-dadang11-cryptoiz\n- **x402scan**: https://x402scan.com/server/mcp.cryptoiz.org\n\n## License\n\nMIT © CryptoIZ\n",
  "bytes": 5883,
  "sha": "aafd31aee553e023da747f53ab60b315df7266e93c34668858ae3b0b33bf3f6c",
  "repo_slug": "dadang11/cryptoiz-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dadang11_cryptoiz_dff36ee6/readme"
}