cryptoiz-mcp 4.15.11 → 4.15.12

package/README.md

@@ -1,51 +1,97 @@
 # CryptoIZ MCP Server
 
-Solana DEX trading signals for Claude Desktop via x402 USDC micropayments.
+AI-powered Solana DEX smart money signals for Claude Desktop. Pay per call with USDC on Solana via x402 Dexter protocol.
 
-## v4.15.0 — x402 V2 (Dexter Facilitator)
+## Quick Install (2 commands)
 
-**NEW:** Dexter facilitator sponsors gas fees. Users only need USDC, no SOL required for transaction fees.
+```bash
+npm install -g cryptoiz-mcp
+npx cryptoiz-mcp-setup YOUR_SOLANA_PRIVATE_KEY
+```
 
-### Payment Protocol
+Auto-detects OS, finds Claude Desktop config (including Windows MSIX), writes correct config. Restart Claude Desktop and type `get_status`.
 
-- **V2 (default):** Client builds partially-signed tx → edge function forwards to Dexter `/settle` → Dexter adds feePayer signature, submits on-chain, sponsors gas
-- **V1 (fallback):** Client sends USDC on-chain → edge function verifies via Solana RPC
+## Prerequisites
 
-### Setup
+1. **Node.js** v18+ from nodejs.org
+2. **Claude Desktop** from claude.ai/download
+3. **Solana wallet** with $1-5 USDC (no SOL needed, Dexter sponsors gas)
 
-```bash
-npm install -g cryptoiz-mcp@4.15.0
+## Tools and Pricing
+
+| Tool | Price | Data |
+|------|-------|------|
+| get_alpha_scanner | $0.05 | 20 smart money whale/dolphin signals |
+| get_divergence | $0.02 | 20 divergence signals (3 types) |
+| get_accumulation | $0.02 | 20 tokens with 4D scoring |
+| get_btc_regime | $0.01 | BTC macro + Fear/Greed + technicals |
+| get_token_ca | FREE | Contract address lookup |
+| get_status | FREE | Server health check |
+
+## Manual Config (if auto-installer fails)
+
+### macOS
+Config: ~/Library/Application Support/Claude/claude_desktop_config.json
+
+```json
+{
+  "mcpServers": {
+    "cryptoiz": {
+      "command": "npx",
+      "args": ["-y", "cryptoiz-mcp"],
+      "env": {
+        "SVM_PRIVATE_KEY": "your-base58-private-key"
+      }
+    }
+  }
+}
 ```
 
-### Claude Desktop Config (Windows)
+### Windows
+IMPORTANT: npx does NOT work on Windows. Use absolute paths.
+
+Config location depends on install type:
+- MSIX (most common): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
+- Standard: %APPDATA%\Claude\claude_desktop_config.json
+
+Check: run `dir "$env:LOCALAPPDATA\Packages\Claude*"` in PowerShell. If folder exists = MSIX.
 
 ```json
 {
   "mcpServers": {
     "cryptoiz": {
       "command": "C:\\Program Files\\nodejs\\node.exe",
-      "args": ["C:\\Users\\CRYPT0_iz\\AppData\\Roaming\\npm\\node_modules\\cryptoiz-mcp\\index.js"],
+      "args": ["C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\node_modules\\cryptoiz-mcp\\index.js"],
       "env": {
-        "SVM_PRIVATE_KEY": "your-base58-solana-private-key"
+        "SVM_PRIVATE_KEY": "your-base58-private-key"
       }
     }
   }
 }
 ```
 
-### Tools & Pricing
+## Troubleshooting
 
-| Tool | Price | Data |
-|------|-------|------|
-| `get_alpha_scanner` | $0.05 USDC | 20 smart money signals |
-| `get_divergence` | $0.02 USDC | 20 divergence signals |
-| `get_accumulation` | $0.02 USDC | 20 accumulation tokens |
-| `get_btc_regime` | $0.01 USDC | BTC macro + technicals |
-| `get_token_ca` | FREE | Contract address lookup |
-| `get_status` | FREE | Server status |
+**"No servers added" after setup:**
+Config written to wrong path. Windows MSIX reads from LocalAppData, not AppData. Copy:
+```powershell
+copy "$env:APPDATA\Claude\claude_desktop_config.json" "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json"
+```
+
+**"spawn npx ENOENT" on Windows:**
+Use absolute paths, not npx. See Windows config above.
+
+**Server disconnected:**
+Check logs: Get-Content "$env:APPDATA\Claude\logs\mcp-server-cryptoiz.log" -Tail 30
+
+## Security
+
+Private key stored only in local config. Never sent to CryptoIZ. Gas sponsored by Dexter. Use a dedicated wallet.
 
-### Links
+## Links
 
+- Guide: https://cryptoiz.org/McpLanding
 - Platform: https://cryptoiz.org
-- Setup Guide: https://cryptoiz.org/McpLanding
+- Dexter: https://dexter.cash/sellers/DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX
 - Twitter: @cryptoiz_IDN
+- npm: https://www.npmjs.com/package/cryptoiz-mcp

package/index.js

@@ -9,7 +9,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import { Connection, Keypair, PublicKey, Transaction, SystemProgram, VersionedTransaction, TransactionMessage } from '@solana/web3.js';
 import bs58 from 'bs58';
 
-var VERSION = 'v4.15.11';
+var VERSION = 'v4.15.12';
 var GATEWAY = 'https://rehqwsypjnjirhuiapqh.supabase.co/functions/v1/mcp-x402-gateway';
 // Per-tool endpoints for Dexter settlement naming
 var TOOL_ENDPOINTS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cryptoiz-mcp",
-  "version": "4.15.11",
+  "version": "4.15.12",
   "description": "CryptoIZ MCP Server - Solana DEX trading signals via Claude Desktop with x402 USDC micropayments (V2 Dexter facilitator)",
   "main": "index.js",
   "type": "module",

package/setup.js

@@ -4,7 +4,7 @@ import path from 'path';
 import os from 'os';
 import { execSync } from 'child_process';
 
-var VERSION = 'v4.15.11';
+var VERSION = 'v4.15.12';
 function print(msg) { process.stdout.write(msg + '\n'); }
 
 function findConfigPath() {