npm - cryptoiz-mcp - Versions diffs - 3.0.2 → 3.2.0 - Mend

cryptoiz-mcp 3.0.2 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/package.json +1 -1
package/src/index.js +311 -228

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "cryptoiz-mcp",
-  "version": "3.0.2",
+  "version": "3.2.0",
   "description": "CryptoIZ MCP Server — Solana DEX signals with x402 micropayments. Pay $0.01 USDC per call.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js CHANGED Viewed

@@ -33,238 +33,287 @@ async function payAndFetch(url) {
   }
 }
-const N = (v, d=2) => v != null ? `${parseFloat(v).toFixed(d)}` : 'N/A';
-const sign = v => parseFloat(v) > 0 ? `+${v}` : `${v}`;
-const risk = v => parseFloat(v) > 0 ? `WARNING ${parseFloat(v).toFixed(1)}%` : 'CLEAR';
+const N = (v, d=2) => v != null && v !== 'N/A' ? parseFloat(v).toFixed(d) : 'N/A';
+const sign = v => { const n = parseFloat(v); return n > 0 ? `+${n}` : `${n}`; };
+const risk = (v, label) => parseFloat(v||0) > 0 ? `⚠ WARNING ${parseFloat(v).toFixed(1)}% — ${label}` : '✅ CLEAR';
+const mc = v => v || 'N/A';
+const pct = v => v != null ? `${parseFloat(v).toFixed(2)}%` : 'N/A';
-// ═══ FORMATTERS ═══
+const HEADER = (tool, subtitle, url) => [
+  `╔══════════════════════════════════════════════════════════════╗`,
+  `║  CRYPTOIZ — ${tool.padEnd(49)}║`,
+  `║  ${subtitle.padEnd(62)}║`,
+  `╠══════════════════════════════════════════════════════════════╣`,
+  `║  PLATFORM   : https://cryptoiz.org${' '.repeat(27)}║`,
+  `║  FULL DATA  : https://cryptoiz.org/${url.padEnd(26)}║`,
+  `║  SUBSCRIBE  : https://cryptoiz.org/Pricing (from $15/week)  ║`,
+  `║  TWITTER    : @cryptoiz_IDN                                  ║`,
+  `║  TELEGRAM   : https://t.me/agus_artemiss                     ║`,
+  `╚══════════════════════════════════════════════════════════════╝`,
+].join('\n');
+const FOOTER = `\n⚠ NOT FINANCIAL ADVICE. Always DYOR before trading.\nPowered by CryptoIZ AI — https://cryptoiz.org | @cryptoiz_IDN`;
+const CA_LINE = (addr) => `     ┌─ COPY TO TRADE (paste on Jupiter/Raydium — do NOT click) ─┐
+     │ ${addr} │
+     └───────────────────────────────────────────────────────────┘`;
+// ══════════════════════════════════════════════════════════════════
+// ALPHA SCANNER
+// ══════════════════════════════════════════════════════════════════
 function formatAlpha(data) {
-  if (data.error) return `ERROR: ${data.error}`;
+  if (data.error) return `ERROR: ${data.error}\nSetup: https://cryptoiz.org`;
   const s = data.signals || [];
   const lines = [
-    `╔═══════════════════════════════════════════════════════════╗`,
-    `║          CRYPTOIZ ALPHA ENTRY SCANNER — v3               ║`,
-    `║  AI-Powered Solana Smart Money Signal Detector           ║`,
-    `╠═══════════════════════════════════════════════════════════╣`,
-    `║ PLATFORM  : https://cryptoiz.org/Alpha-Scanner           ║`,
-    `║ SUBSCRIBE : https://cryptoiz.org/Pricing ($15/week)      ║`,
-    `║ TWITTER   : @cryptoiz_IDN  | TELEGRAM: t.me/agus_artemiss║`,
-    `╚═══════════════════════════════════════════════════════════╝`,
-    ``,
-    `DATE         : ${data.fetched_at?.split('T')[0]}`,
-    `TOTAL SIGNALS: ${data.total_signals}`,
-    ``,
-    `SIGNAL CLASSES:`,
-    `  ALPHA_EARLY    = Best entry — early accumulation, smart money just entering`,
-    `  ALPHA_BUILDING = Accumulation ongoing — still valid but less optimal timing`,
-    `  WATCHLIST_ONLY = Not ready — monitor until criteria met`,
-    ``,
-    `SUB-SCORES (0-100):`,
-    `  Accumulation = How actively smart money is entering`,
-    `  Timing       = How optimal the entry timing is right now`,
-    `  Safety       = Protection from manipulation & fake signals`,
-    ``,
-    `═══════════════════════════════════════════════════════════`,
-    ...s.map((t, i) => [
-      ``,
-      `[${String(i+1).padStart(2,'0')}] \${t.name}  |  CA: \${t.contract_address}`,
-      `     ALPHA_SCORE             : ${t.alpha_score} / 100`,
-      `     SIGNAL_CLASS            : ${t.signal_class}`,
-      `     CURRENT_PHASE           : ${t.phase}`,
-      `     REGIME                  : ${t.regime}`,
-      `     PHASE_CONFIDENCE        : ${t.phase_confidence_pct}%`,
-      `     PHASE_AGE               : ${t.phase_age_bars} bars`,
-      ``,
-      `     --- HOLDER SIGNALS ---`,
-      `     WHALE_DELTA             : ${sign(t.whale_delta)} (now holds ${t.whale_supply_pct}% of supply)`,
-      `     DOLPHIN_DELTA           : ${sign(t.dolphin_delta)} (now holds ${t.dolphin_supply_pct}% of supply)`,
-      `     SHRIMP_DELTA            : ${sign(t.shrimp_delta)} (negative = retail exiting = bullish)`,
-      ``,
-      `     --- SUB-SCORES ---`,
-      `     SCORE_ACCUMULATION      : ${t.score_accumulation}`,
-      `     SCORE_TIMING            : ${t.score_timing}`,
-      `     SCORE_SAFETY            : ${t.score_safety}`,
-      ``,
-      `     --- RISK FLAGS ---`,
-      `     RISK_LIQUIDITY          : ${risk(t.risk_liquidity_pct)}`,
-      `     RISK_TRAP               : ${risk(t.risk_trap_pct)}`,
-      ``,
-      `     --- MARKET DATA ---`,
-      `     MARKET_CAP_NOW          : ${t.market_cap_now || 'N/A'}`,
-      `     PRICE_NOW               : $${t.price_now_usd || 'N/A'}`,
-      `     PRICE_DROP_FROM_PEAK    : ${t.price_drop_from_peak_pct ? t.price_drop_from_peak_pct+'%' : 'N/A'}`,
-      `     MC_WHEN_SIGNAL_FORMED   : ${t.market_cap_when_signal_formed || 'N/A'}`,
-      `     PRICE_WHEN_SIGNAL_FORMED: $${t.price_when_signal_formed_usd || 'N/A'}`,
-      `─────────────────────────────────────────────────────────`,
-    ].join('\n')),
-    ``,
-    `NOTE: Not financial advice. Always DYOR.`,
-    `FULL DASHBOARD WITH CHARTS: https://cryptoiz.org`,
+    HEADER('ALPHA ENTRY SCANNER', 'AI Smart Money Signal Detector for Solana DEX', 'Alpha-Scanner'),
+    ``,
+    `DATE          : ${data.fetched_at?.split('T')[0]}`,
+    `TOTAL SIGNALS : ${data.total_signals}`,
+    ``,
+    `HOW TO READ:`,
+    `  ALPHA_SCORE    = Overall strength 0-100 (higher = stronger signal)`,
+    `  SIGNAL_CLASS   = ALPHA_EARLY (best) > ALPHA_BUILDING > WATCHLIST_ONLY`,
+    `  Score Accum    = How actively smart money is entering (0-100)`,
+    `  Score Timing   = How optimal the entry timing is right now (0-100)`,
+    `  Score Safety   = Protection from manipulation & fake signals (0-100)`,
+    `  Whale/Dolphin  = Smart money tiers: Whale > Dolphin > Shrimp (retail)`,
+    `  Delta (+/-)    = Net change in holder count this period`,
+    `  Drop/Peak      = Price drop from all-time-high in this period`,
+    ``,
+    `═══════════════════════════════════════════════════════════════`,
+    ``,
+    ...s.map((t, i) => {
+      const urgency = parseFloat(t.alpha_score) >= 85 ? '🔥 HIGH CONVICTION' :
+                      parseFloat(t.alpha_score) >= 75 ? '⚡ STRONG SIGNAL' :
+                      parseFloat(t.alpha_score) >= 65 ? '👁  WATCH' : '📋 MONITOR';
+      return [
+        `[${String(i+1).padStart(2,'0')}] ${t.name || 'Unknown'} — ${urgency}`,
+        CA_LINE(t.contract_address || 'N/A'),
+        ``,
+        `     SIGNAL_CLASS            : ${t.signal_class}`,
+        `     ALPHA_SCORE             : ${N(t.alpha_score)} / 100`,
+        `     CURRENT_PHASE           : ${t.phase || 'N/A'}`,
+        `     REGIME                  : ${t.regime || 'N/A'}`,
+        `     PHASE_CONFIDENCE        : ${pct(t.phase_confidence_pct)}`,
+        `     PHASE_AGE               : ${t.phase_age_bars} bars`,
+        ``,
+        `     ── HOLDER SIGNALS ──────────────────────────────────`,
+        `     WHALE_DELTA             : ${sign(t.whale_delta)} (holds ${pct(t.whale_supply_pct)} of supply)`,
+        `     DOLPHIN_DELTA           : ${sign(t.dolphin_delta)} (holds ${pct(t.dolphin_supply_pct)} of supply)`,
+        `     SHRIMP_DELTA            : ${sign(t.shrimp_delta)} (negative = retail exiting = bullish sign)`,
+        ``,
+        `     ── SUB-SCORES ──────────────────────────────────────`,
+        `     SCORE_ACCUMULATION      : ${N(t.score_accumulation)}`,
+        `     SCORE_TIMING            : ${N(t.score_timing)}`,
+        `     SCORE_SAFETY            : ${N(t.score_safety)}`,
+        ``,
+        `     ── RISK FLAGS ──────────────────────────────────────`,
+        `     RISK_LIQUIDITY          : ${risk(t.risk_liquidity_pct, 'exit may be difficult')}`,
+        `     RISK_TRAP               : ${risk(t.risk_trap_pct, 'possible smart money trap')}`,
+        ``,
+        `     ── MARKET DATA ─────────────────────────────────────`,
+        `     MARKET_CAP_NOW          : ${mc(t.market_cap_now)}`,
+        `     PRICE_NOW               : $${t.price_now_usd || 'N/A'}`,
+        `     PRICE_DROP_FROM_PEAK    : ${t.price_drop_from_peak_pct ? N(t.price_drop_from_peak_pct)+'%' : 'N/A'}`,
+        `     MC_WHEN_SIGNAL_FORMED   : ${mc(t.market_cap_when_signal_formed)}`,
+        `     PRICE_WHEN_SIGNAL_FORMED: $${t.price_when_signal_formed_usd || 'N/A'}`,
+        ``,
+        `═══════════════════════════════════════════════════════════`,
+      ].join('\n');
+    }),
+    FOOTER,
   ];
   return lines.join('\n');
 }
+// ══════════════════════════════════════════════════════════════════
+// DIVERGENCE SCANNER
+// ══════════════════════════════════════════════════════════════════
 function formatDivergence(data) {
   if (data.error) return `ERROR: ${data.error}`;
+  const byType = data.signals_by_type || {};
+  const total = data.total_signals || 0;
   const lines = [
-    `╔═══════════════════════════════════════════════════════════╗`,
-    `║       CRYPTOIZ DIVERGENCE SCANNER — v3                   ║`,
-    `║  Smart Money vs Price Divergence Detector                ║`,
-    `╠═══════════════════════════════════════════════════════════╣`,
-    `║ PLATFORM  : https://cryptoiz.org/Divergence              ║`,
-    `║ SUBSCRIBE : https://cryptoiz.org/Pricing ($15/week)      ║`,
-    `║ TWITTER   : @cryptoiz_IDN  | TELEGRAM: t.me/agus_artemiss║`,
-    `╚═══════════════════════════════════════════════════════════╝`,
-    ``,
-    `DATE         : ${data.fetched_at?.split('T')[0]}`,
-    `TIMEFRAME    : ${data.timeframe?.toUpperCase()}`,
-    `TOTAL SIGNALS: ${data.total_signals}`,
-    ``,
-    `DIVERGENCE TYPES EXPLAINED:`,
-    `  HIDDEN_ACCUMULATION  = Price flat/weak but whales quietly buying. Stealth entry before the move.`,
-    `  BREAKOUT_ACCUMULATION= Whales buying aggressively on price breakout. Strong momentum entry.`,
-    `  CLASSIC_DIVERGENCE   = Price & smart money moving in opposite directions. High reversal potential.`,
-    ``,
-    `═══════════════════════════════════════════════════════════`,
+    HEADER('DIVERGENCE SCANNER', 'Smart Money vs Price Divergence Detector', 'Divergence'),
+    ``,
+    `DATE          : ${data.fetched_at?.split('T')[0]}`,
+    `TIMEFRAME     : ${(data.timeframe||'4h').toUpperCase()}`,
+    `TOTAL SIGNALS : ${total}`,
+    ``,
+    `DIVERGENCE TYPES:`,
+    `  HIDDEN_ACCUMULATION   = Price flat/weak but smart money quietly buying.`,
+    `                          Stealth entry BEFORE the upward move.`,
+    `  BREAKOUT_ACCUMULATION = Whales buying aggressively on price breakout.`,
+    `                          Momentum-driven entry with strong conviction.`,
+    `  CLASSIC_DIVERGENCE    = Price and smart money moving in OPPOSITE directions.`,
+    `                          High reversal potential — watch closely.`,
+    ``,
+    `HOW TO READ:`,
+    `  Divergence Score  = Strength of the divergence (higher = stronger)`,
+    `  Confidence %      = AI confidence in the signal`,
+    `  Whale Now/Prev    = Absolute whale holder count change`,
+    `  Price Change %    = Price movement this period`,
+    ``,
+    `═══════════════════════════════════════════════════════════════`,
   ];
-  const byType = data.signals_by_type || {};
-  const typeOrder = ['HIDDEN_ACCUMULATION', 'BREAKOUT_ACCUMULATION', 'CLASSIC_DIVERGENCE'];
+  if (!total) {
+    lines.push(`\nNo divergence signals detected at this time.`);
+    lines.push(`This is normal during low-volatility/sideways markets.`);
+    lines.push(`Try again in a few hours or switch to 1d timeframe.`);
+    lines.push(FOOTER);
+    return lines.join('\n');
+  }
+  const typeOrder = ['HIDDEN_ACCUMULATION','BREAKOUT_ACCUMULATION','CLASSIC_DIVERGENCE'];
+  const typeDesc = {
+    HIDDEN_ACCUMULATION: 'Price appears weak but smart money is secretly buying — stealth setup',
+    BREAKOUT_ACCUMULATION: 'Whales chasing breakouts — momentum-driven, high conviction entry',
+    CLASSIC_DIVERGENCE: 'Price vs smart money in opposite directions — strong reversal signal',
+  };
   typeOrder.forEach(type => {
     const sigs = byType[type] || [];
     if (!sigs.length) return;
-    lines.push(``, `▶ ${type} (${sigs.length} signals)`, `─────────────────────────────────────────────────────────`);
+    lines.push(`\n▶▶ ${type} — ${sigs.length} signal(s)`);
+    lines.push(`   ${typeDesc[type]}`);
+    lines.push(`───────────────────────────────────────────────────────────`);
     sigs.forEach((s, i) => {
+      const urgency = parseFloat(s.divergence_score) > 300 ? '🔥 VERY HIGH' :
+                      parseFloat(s.divergence_score) > 100 ? '⚡ HIGH' :
+                      parseFloat(s.divergence_score) > 50  ? '👁  MODERATE' : '📋 LOW';
       lines.push([
         ``,
-        `  [${String(i+1).padStart(2,'0')}] ${s.name}  |  CA: ${s.contract_address}`,
-        `       DIVERGENCE_TYPE    : ${s.divergence_type}`,
-        `       DIVERGENCE_SCORE   : ${s.divergence_score}`,
-        `       CONFIDENCE         : ${s.confidence_pct}%`,
-        `       CURRENT_PHASE      : ${s.current_phase}`,
+        `  [${String(i+1).padStart(2,'0')}] ${s.name || 'Unknown'} — Signal Strength: ${urgency}`,
+        CA_LINE(s.contract_address || 'N/A'),
+        ``,
+        `       DIVERGENCE_TYPE          : ${s.divergence_type}`,
+        `       DIVERGENCE_SCORE         : ${N(s.divergence_score)}`,
+        `       CONFIDENCE               : ${pct(s.confidence_pct)}`,
+        `       CURRENT_PHASE            : ${s.current_phase || 'N/A'}`,
         ``,
-        `       --- HOLDER MOVEMENT ---`,
-        `       WHALE_HOLDERS_NOW  : ${s.whale_holders_now} (was: ${s.whale_holders_prev}, delta: ${sign(s.whale_delta)})`,
-        `       DOLPHIN_DELTA      : ${sign(s.dolphin_delta)}`,
+        `       ── HOLDER MOVEMENT ──────────────────────────────`,
+        `       WHALE_HOLDERS_NOW        : ${s.whale_holders_now || 'N/A'} wallets`,
+        `       WHALE_HOLDERS_PREV       : ${s.whale_holders_prev || 'N/A'} wallets`,
+        `       WHALE_DELTA              : ${sign(s.whale_delta)} (new whales entering)`,
+        `       DOLPHIN_DELTA            : ${sign(s.dolphin_delta)}`,
         ``,
-        `       --- PRICE DATA ---`,
-        `       PRICE_NOW          : $${s.price_now_usd}`,
-        `       PRICE_PREV_PERIOD  : $${s.price_prev_usd}`,
-        `       PRICE_CHANGE       : ${s.price_change_pct}%`,
-        `       MARKET_CAP         : ${s.market_cap_usd || 'N/A'}`,
-        `       DETECTED           : ${s.detected}`,
+        `       ── PRICE & MARKET ───────────────────────────────`,
+        `       PRICE_NOW                : $${s.price_now_usd || 'N/A'}`,
+        `       PRICE_PREV_PERIOD        : $${s.price_prev_usd || 'N/A'}`,
+        `       PRICE_CHANGE             : ${pct(s.price_change_pct)}`,
+        `       MARKET_CAP               : ${s.market_cap_usd || 'N/A'}`,
+        `       SIGNAL_AGE               : ${s.detected || 'N/A'}`,
+        ``,
+        `───────────────────────────────────────────────────────────`,
       ].join('\n'));
     });
-    lines.push(`─────────────────────────────────────────────────────────`);
   });
-  if (!data.total_signals) {
-    lines.push(``, `No divergence signals detected at this time.`, `This is normal during sideways/low-volatility markets.`, `Check again in a few hours or try the 1d timeframe.`);
-  }
-  lines.push(``, `NOTE: Not financial advice. Always DYOR.`, `FULL DIVERGENCE DASHBOARD: https://cryptoiz.org/Divergence`);
+  lines.push(FOOTER);
   return lines.join('\n');
 }
+// ══════════════════════════════════════════════════════════════════
+// ACCUMULATION DASHBOARD
+// ══════════════════════════════════════════════════════════════════
 function formatAccumulation(data) {
   if (data.error) return `ERROR: ${data.error}`;
   const tokens = data.tokens || [];
   const lines = [
-    `╔═══════════════════════════════════════════════════════════╗`,
-    `║      CRYPTOIZ ACCUMULATION DASHBOARD — v3                ║`,
-    `║  4-Dimension Smart Money Accumulation Detector           ║`,
-    `╠═══════════════════════════════════════════════════════════╣`,
-    `║ PLATFORM  : https://cryptoiz.org/Dashboard               ║`,
-    `║ SUBSCRIBE : https://cryptoiz.org/Pricing ($15/week)      ║`,
-    `║ TWITTER   : @cryptoiz_IDN  | TELEGRAM: t.me/agus_artemiss║`,
-    `╚═══════════════════════════════════════════════════════════╝`,
+    HEADER('ACCUMULATION DASHBOARD', '4-Dimension Smart Money Accumulation Detector', 'Dashboard'),
     ``,
     `DATE          : ${data.fetched_at?.split('T')[0]}`,
     `TOTAL TOKENS  : ${data.total_tokens}`,
     ``,
-    `COMPOSITE SCORE = Weighted average of 4 dimensions:`,
-    `  Structure Score = Price action & holder tier pattern quality`,
-    `  AccDist Score   = Accumulation vs distribution ratio`,
-    `  Holder Score    = Holder quality, loyalty & consistency`,
-    `  Market Score    = Market conditions, volume & momentum`,
+    `4-DIMENSION SCORING SYSTEM:`,
+    `  Structure Score = Price action quality & holder tier patterns (0-100)`,
+    `  AccDist Score   = Accumulation vs distribution balance (0-100)`,
+    `  Holder Score    = Holder loyalty, quality & consistency (0-100)`,
+    `  Market Score    = Market conditions, volume & momentum (0-100)`,
+    `  Composite Score = Weighted average of all 4 dimensions`,
     ``,
     `STRENGTH LABELS:`,
-    `  VERY_STRONG_SMART_MONEY   = Highest conviction — act now`,
+    `  VERY_STRONG_SMART_MONEY    = Highest conviction — priority entry`,
     `  STRONG_SMART_MONEY_FORMING = Strong signal — monitor closely`,
-    `  FORMING                   = Early stage — needs confirmation`,
-    `  WEAK_OR_NOISY             = Low confidence — skip for now`,
-    ``,
-    `═══════════════════════════════════════════════════════════`,
-    ...tokens.map((t, i) => [
-      ``,
-      `[${String(i+1).padStart(2,'0')}] \${t.name}  |  CA: \${t.contract_address}`,
-      `     ACCUMULATION      : ${t.accumulation_strength}`,
-      `     ACCDIST_STATUS    : ${t.accdist_status}`,
-      ``,
-      `     --- COMPOSITE SCORE: ${t.score_composite} / 100 ---`,
-      `     SCORE_STRUCTURE   : ${t.score_structure}`,
-      `     SCORE_ACCDIST     : ${t.score_accdist}`,
-      `     SCORE_HOLDER      : ${t.score_holder}`,
-      `     SCORE_MARKET      : ${t.score_market}`,
-      ``,
-      `     --- MARKET DATA ---`,
-      `     MARKET_CAP_NOW    : ${t.market_cap_now || 'N/A'}`,
-      `     PRICE_NOW         : $${t.price_now_usd || 'N/A'}`,
-      `     LAST_UPDATED      : ${t.last_updated || 'N/A'}`,
-      `─────────────────────────────────────────────────────────`,
-    ].join('\n')),
-    ``,
-    `NOTE: Not financial advice. Always DYOR.`,
-    `FULL ACCUMULATION DASHBOARD: https://cryptoiz.org`,
+    `  FORMING                    = Early stage — needs confirmation`,
+    `  WEAK_OR_NOISY              = Low confidence — skip`,
+    ``,
+    `═══════════════════════════════════════════════════════════════`,
+    ``,
+    ...tokens.map((t, i) => {
+      const urgency = t.accumulation_strength?.includes('VERY_STRONG') ? '🔥 VERY STRONG' :
+                      t.accumulation_strength?.includes('STRONG') ? '⚡ STRONG FORMING' :
+                      t.accumulation_strength?.includes('FORMING') ? '👁  FORMING' : '📋 WEAK/NOISY';
+      return [
+        `[${String(i+1).padStart(2,'0')}] ${t.name || 'Unknown'} — ${urgency}`,
+        CA_LINE(t.contract_address || 'N/A'),
+        ``,
+        `     ACCUMULATION_STRENGTH   : ${t.accumulation_strength || 'N/A'}`,
+        `     ACCDIST_STATUS          : ${t.accdist_status || 'N/A'}`,
+        ``,
+        `     ── COMPOSITE SCORE: ${N(t.score_composite)} / 100 ─────────────────`,
+        `     SCORE_STRUCTURE         : ${N(t.score_structure)}`,
+        `     SCORE_ACCDIST           : ${N(t.score_accdist)}`,
+        `     SCORE_HOLDER            : ${N(t.score_holder)}`,
+        `     SCORE_MARKET            : ${N(t.score_market)}`,
+        ``,
+        `     ── MARKET DATA ─────────────────────────────────────`,
+        `     MARKET_CAP_NOW          : ${mc(t.market_cap_now)}`,
+        `     PRICE_NOW               : $${t.price_now_usd || 'N/A'}`,
+        `     LAST_UPDATED            : ${t.last_updated || 'N/A'}`,
+        ``,
+        `═══════════════════════════════════════════════════════════`,
+      ].join('\n');
+    }),
+    FOOTER,
   ];
   return lines.join('\n');
 }
+// ══════════════════════════════════════════════════════════════════
+// BTC REGIME MONITOR
+// ══════════════════════════════════════════════════════════════════
 function formatBTC(data) {
   if (data.error) return `ERROR: ${data.error}`;
-  const regime = data.btc_regime || 'UNKNOWN';
-  const icon = regime === 'BULL' ? 'BULLISH' : regime === 'BEAR' ? 'BEARISH' : 'NEUTRAL';
-  const advice = regime === 'BULL'
-    ? 'BTC BULLISH -> Favorable for altcoin entries. Focus on high Alpha Score tokens.'
+  const regime = (data.btc_regime || 'UNKNOWN').toUpperCase();
+  const regimeIcon = regime === 'BULL' ? '🟢 BULLISH' : regime === 'BEAR' ? '🔴 BEARISH' : '🟡 NEUTRAL';
+  const fgi = parseFloat(data.fear_and_greed_index || 0);
+  const fgiContext = fgi <= 25 ? 'Extreme Fear — Historically strong contrarian buy zone for patient investors.' :
+                    fgi >= 75 ? 'Extreme Greed — Market overheated, elevated reversal risk.' :
+                    'Neutral zone — Follow technical signals for direction.';
+  const altAdvice = regime === 'BULL'
+    ? '✅ BTC BULLISH → Favorable for altcoin entries.\n     Focus on high Alpha Score tokens on CryptoIZ Alpha Scanner.'
     : regime === 'BEAR'
-    ? 'BTC BEARISH -> Be cautious. Prioritize high Safety Score, low Liquidity Risk tokens. Size down.'
-    : 'BTC NEUTRAL -> Be selective. Wait for signal confirmation before large positions.';
+    ? '⚠  BTC BEARISH → Be CAUTIOUS.\n     Size down. Prioritize Safety Score ≥80 and CLEAR risk flags only.'
+    : '🟡 BTC NEUTRAL → Be SELECTIVE.\n     Wait for signal confirmation before large positions.';
+  const rsiVal = parseFloat(data.rsi_1h || 50);
+  const rsiNote = rsiVal < 30 ? '(Oversold — potential bounce)' : rsiVal > 70 ? '(Overbought — caution)' : '(Normal range)';
   return [
-    `╔═══════════════════════════════════════════════════════════╗`,
-    `║        CRYPTOIZ BTC REGIME MONITOR — v3                  ║`,
-    `║  Bitcoin Macro Condition for Solana Altcoin Traders      ║`,
-    `╠═══════════════════════════════════════════════════════════╣`,
-    `║ PLATFORM  : https://cryptoiz.org/BTC                     ║`,
-    `║ SUBSCRIBE : https://cryptoiz.org/Pricing ($15/week)      ║`,
-    `║ TWITTER   : @cryptoiz_IDN  | TELEGRAM: t.me/agus_artemiss║`,
-    `╚═══════════════════════════════════════════════════════════╝`,
+    HEADER('BTC REGIME MONITOR', 'Bitcoin Macro Condition for Solana Altcoin Traders', 'BTC'),
     ``,
-    `DATE              : ${data.fetched_at?.split('T')[0]}`,
+    `DATE                  : ${data.fetched_at?.split('T')[0]}`,
     ``,
-    `═══ BTC REGIME: ${icon} ═══`,
+    `══════════════ BTC REGIME: ${regimeIcon} ════════════════`,
     ``,
     `BTC_PRICE_USD         : $${data.btc_price_usd || 'N/A'}`,
-    `BTC_SCORE             : ${data.btc_score} / 10 (0=extreme bear, 10=extreme bull)`,
+    `BTC_SCORE             : ${data.btc_score} / 10  (0=extreme bear, 10=extreme bull)`,
     `BTC_TREND             : ${data.btc_trend || 'N/A'}`,
     `OPEN_INTEREST         : ${data.open_interest || 'N/A'}`,
     `FUNDING_RATE          : ${data.funding_rate || 'N/A'}`,
     ``,
-    `═══ MARKET SENTIMENT ═══`,
+    `══════════════ MARKET SENTIMENT ════════════════════════`,
     ``,
     `FEAR_GREED_INDEX      : ${data.fear_and_greed_index} / 100`,
-    `FEAR_GREED_LABEL      : ${data.fear_and_greed_label}`,
-    `FEAR_GREED_CONTEXT    : ${
-      data.fear_and_greed_index <= 25
-        ? 'Extreme Fear zone — historically strong contrarian buy opportunity for patient investors.'
-        : data.fear_and_greed_index >= 75
-        ? 'Extreme Greed — market overheated, reversal risk elevated.'
-        : 'Neutral zone — follow technical signals.'
-    }`,
+    `FEAR_GREED_LABEL      : ${data.fear_and_greed_label || 'N/A'}`,
+    `FEAR_GREED_CONTEXT    : ${fgiContext}`,
     ``,
-    `═══ FUTURES MARKET ═══`,
+    `══════════════ FUTURES MARKET ══════════════════════════`,
     ``,
     `FUTURES_SIGNAL        : ${data.futures_signal || 'N/A'}`,
     `OI_REGIME             : ${data.oi_regime || 'N/A'}`,
@@ -272,100 +321,131 @@ function formatBTC(data) {
     `PERP_PRICE_USD        : $${data.perp_price_usd || 'N/A'}`,
     `FUTURES_CONTEXT       : ${data.futures_context || 'N/A'}`,
     ``,
-    `═══ TECHNICAL INDICATORS (1H) ═══`,
+    `══════════════ TECHNICAL INDICATORS (1H) ═══════════════`,
     ``,
-    `RSI_1H                : ${data.rsi_1h || 'N/A'}${data.rsi_1h ? (parseFloat(data.rsi_1h) < 30 ? ' (Oversold)' : parseFloat(data.rsi_1h) > 70 ? ' (Overbought)' : ' (Normal)') : ''}`,
+    `RSI_1H                : ${data.rsi_1h || 'N/A'} ${data.rsi_1h ? rsiNote : ''}`,
     `EMA20_1H              : $${data.ema20_1h || 'N/A'}`,
     `EMA50_1H              : $${data.ema50_1h || 'N/A'}`,
     `MACD_1H               : ${data.macd_1h || 'N/A'}`,
     `MACD_SIGNAL_1H        : ${data.macd_signal_1h || 'N/A'}`,
     ``,
-    `═══ ALTCOIN RECOMMENDATION ═══`,
+    `══════════════ ALTCOIN RECOMMENDATION ══════════════════`,
     ``,
-    `RECOMMENDATION: ${advice}`,
+    `RECOMMENDATION:`,
+    `     ${altAdvice}`,
     ``,
-    `For best Solana entry signals during this BTC regime:`,
+    `For best entry signals under this regime:`,
     `>>> https://cryptoiz.org/Alpha-Scanner <<<`,
     ``,
-    `NOTE: Not financial advice. Always DYOR.`,
-    `FULL BTC MONITOR: https://cryptoiz.org/BTC`,
+    `Plans from $15/week: https://cryptoiz.org/Pricing`,
+    FOOTER,
   ].join('\n');
 }
+// ══════════════════════════════════════════════════════════════════
+// STATUS
+// ══════════════════════════════════════════════════════════════════
 function formatStatus() {
   return [
-    `╔═══════════════════════════════════════════════════════════╗`,
-    `║     CryptoIZ MCP Server v3.0.0                           ║`,
-    `║     AI-Powered Solana DEX Trading Signal Platform        ║`,
-    `╠═══════════════════════════════════════════════════════════╣`,
-    `║ WEBSITE   : https://cryptoiz.org                         ║`,
-    `║ SUBSCRIBE : https://cryptoiz.org/Pricing ($15/week)      ║`,
-    `║ TWITTER   : @cryptoiz_IDN                                ║`,
-    `║ TELEGRAM  : https://t.me/agus_artemiss                   ║`,
-    `╚═══════════════════════════════════════════════════════════╝`,
-    ``,
-    `CONNECTION_STATUS : CONNECTED`,
-    `PAYMENT_STATUS    : ${SVM_PRIVATE_KEY ? 'READY — x402 Solana USDC autopay' : 'NOT SET — add SVM_PRIVATE_KEY'}`,
-    `PRICE_PER_CALL    : $0.01 USDC via Solana`,
+    HEADER('MCP SERVER v3.2.0', 'AI-Powered Solana DEX Trading Signal Platform', 'Pricing'),
+    ``,
+    `CONNECTION_STATUS : CONNECTED to CryptoIZ Data Engine`,
+    `PAYMENT_STATUS    : ${SVM_PRIVATE_KEY ? 'READY — x402 Solana USDC autopay ($0.01/call)' : 'NOT SET — add SVM_PRIVATE_KEY to Claude Desktop config'}`,
     `PAYMENT_WALLET    : DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`,
     ``,
-    `AVAILABLE_TOOLS:`,
+    `AVAILABLE TOOLS:`,
     ``,
     `  1. get_alpha_scanner`,
-    `     What: Strongest Solana tokens being accumulated by smart money`,
-    `     Data: Contract address, alpha score, class, phase, regime,`,
-    `           whale/dolphin/shrimp signals, 3 sub-scores, risk flags,`,
-    `           MC now, price now, MC & price when signal formed`,
-    `     URL : https://cryptoiz.org/Alpha-Scanner`,
-    ``,
-    `  2. get_divergence`,
-    `     What: Tokens where price & smart money activity diverge`,
-    `     Types: HIDDEN_ACCUMULATION, BREAKOUT_ACCUMULATION, CLASSIC_DIVERGENCE`,
-    `     Data: Contract address, divergence type+explanation, score,`,
-    `           confidence, whale movement (now vs prev), price, MC`,
-    `     URL : https://cryptoiz.org/Divergence`,
-    ``,
-    `  3. get_accumulation`,
-    `     What: Tokens in active accumulation phase (4-dimension score)`,
-    `     Data: Contract address, composite + 4 sub-scores (structure/`,
-    `           accdist/holder/market), strength label, MC, price`,
-    `     URL : https://cryptoiz.org/Dashboard`,
+    `     → Alpha Score, Signal Class, Phase, Regime`,
+    `     → Whale/Dolphin/Shrimp deltas & supply %`,
+    `     → Sub-scores: Accumulation / Timing / Safety`,
+    `     → Risk flags: Liquidity / Trap`,
+    `     → MC & Price NOW + MC & Price WHEN SIGNAL FORMED`,
+    `     → Contract address (copy to trade on DEX)`,
+    `     → Full: https://cryptoiz.org/Alpha-Scanner`,
+    ``,
+    `  2. get_divergence  [params: timeframe=4h|1d, limit=1-50]`,
+    `     → 3 types: HIDDEN_ACCUMULATION / BREAKOUT_ACCUMULATION / CLASSIC_DIVERGENCE`,
+    `     → Each type explained in plain English`,
+    `     → Whale holders NOW vs PREV (absolute count)`,
+    `     → Price now vs previous period`,
+    `     → Signal age (how long ago detected)`,
+    `     → Contract address (copy to trade on DEX)`,
+    `     → Full: https://cryptoiz.org/Divergence`,
+    ``,
+    `  3. get_accumulation  [params: min_composite=0-100]`,
+    `     → 4-dimension composite score`,
+    `     → Structure / AccDist / Holder / Market scores`,
+    `     → Strength label (Very Strong → Weak/Noisy)`,
+    `     → MC & Price now`,
+    `     → Contract address (copy to trade on DEX)`,
+    `     → Full: https://cryptoiz.org/Dashboard`,
     ``,
     `  4. get_btc_regime`,
-    `     What: Bitcoin macro regime — critical context for altcoin trading`,
-    `     Data: Price, score, trend, Fear&Greed, OI regime, funding rate,`,
-    `           futures signal, RSI/EMA20/EMA50/MACD (1H)`,
-    `     URL : https://cryptoiz.org/BTC`,
-    ``,
-    `  5. get_status — This info`,
-    ``,
-    `PLATFORM PLANS:`,
-    `  1 Week   : $15  | 1 Month : $50`,
-    `  3 Months : $120 | 1 Year  : $400`,
-    `  URL: https://cryptoiz.org/Pricing`,
+    `     → BTC regime (Bull/Bear/Neutral) + score/10`,
+    `     → Fear & Greed Index with interpretation`,
+    `     → Futures: OI regime, funding rate, signal`,
+    `     → Technical: RSI / EMA20 / EMA50 / MACD (1H)`,
+    `     → Altcoin recommendation based on regime`,
+    `     → Full: https://cryptoiz.org/BTC`,
+    ``,
+    `  5. get_status → This info`,
+    ``,
+    `SUBSCRIPTION PLANS:`,
+    `  1 Week: $15 | 1 Month: $50 | 3 Months: $120 | 1 Year: $400`,
+    `  https://cryptoiz.org/Pricing`,
+    FOOTER,
   ].join('\n');
 }
+// ══════════════════════════════════════════════════════════════════
+// TOOL DEFINITIONS
+// ══════════════════════════════════════════════════════════════════
 const TOOLS = [
-  { name: 'get_alpha_scanner', description: 'Get strongest Solana token signals from CryptoIZ Alpha Scanner. Returns contract address, alpha score, class, phase, regime, whale/dolphin/shrimp signals, 3 sub-scores (accumulation/timing/safety), risk flags, market cap now, price now, MC and price when signal first formed. $0.01 USDC per call. Platform: cryptoiz.org', inputSchema: { type: 'object', properties: { min_score: { type: 'number' }, entry_class: { type: 'string', enum: ['ALPHA_EARLY','ALPHA_BUILDING','WATCHLIST_ONLY'] } }, required: [] } },
-  { name: 'get_divergence', description: 'Get divergence signals from CryptoIZ — 3 types: HIDDEN_ACCUMULATION (stealth smart money entry), BREAKOUT_ACCUMULATION (momentum entry), CLASSIC_DIVERGENCE (reversal signal). Returns contract address, type with explanation, score, confidence, whale holders now vs prev, price, MC. $0.01 USDC per call. Platform: cryptoiz.org/Divergence', inputSchema: { type: 'object', properties: { timeframe: { type: 'string', enum: ['4h','1d'] }, limit: { type: 'number' } }, required: [] } },
-  { name: 'get_accumulation', description: 'Get tokens in accumulation phase from CryptoIZ — 4-dimension composite score (structure, accdist, holder, market). Returns contract address, composite score, 4 sub-scores, strength label, market cap, price. $0.01 USDC per call. Platform: cryptoiz.org', inputSchema: { type: 'object', properties: { min_composite: { type: 'number' } }, required: [] } },
-  { name: 'get_btc_regime', description: 'Get Bitcoin macro regime from CryptoIZ. Returns BTC price, regime score, Fear & Greed Index, OI regime, funding rate, futures signal, RSI/EMA20/EMA50/MACD (1H), altcoin recommendation. $0.01 USDC per call. Platform: cryptoiz.org/BTC', inputSchema: { type: 'object', properties: {}, required: [] } },
-  { name: 'get_status', description: 'Check CryptoIZ MCP server status, payment setup, and full list of available tools with data descriptions. Platform: cryptoiz.org', inputSchema: { type: 'object', properties: {}, required: [] } },
+  {
+    name: 'get_alpha_scanner',
+    description: 'CryptoIZ Alpha Entry Scanner — strongest Solana tokens being accumulated by smart money. Returns: contract address (for DEX trading), alpha score, signal class (ALPHA_EARLY/BUILDING/WATCHLIST), phase, regime, whale/dolphin/shrimp deltas and supply %, accumulation/timing/safety sub-scores, liquidity and trap risk flags, market cap now, price now, MC and price when signal first formed. $0.01 USDC/call. Platform: https://cryptoiz.org/Alpha-Scanner',
+    inputSchema: { type: 'object', properties: { min_score: { type: 'number', description: 'Minimum alpha score 0-100' }, entry_class: { type: 'string', enum: ['ALPHA_EARLY','ALPHA_BUILDING','WATCHLIST_ONLY'] } }, required: [] }
+  },
+  {
+    name: 'get_divergence',
+    description: 'CryptoIZ Divergence Scanner — detects 3 types: HIDDEN_ACCUMULATION (price weak but whales buying), BREAKOUT_ACCUMULATION (whales buying breakouts), CLASSIC_DIVERGENCE (price vs smart money opposite direction). Returns: contract address, divergence type with explanation, score, confidence %, whale holders now vs previous period, dolphin delta, price now vs previous, price change %, market cap, signal age. $0.01 USDC/call. Platform: https://cryptoiz.org/Divergence',
+    inputSchema: { type: 'object', properties: { timeframe: { type: 'string', enum: ['4h','1d'], description: 'Default: 4h' }, limit: { type: 'number', description: 'Max results 1-50, default 30' } }, required: [] }
+  },
+  {
+    name: 'get_accumulation',
+    description: 'CryptoIZ Accumulation Dashboard — tokens in active accumulation phase scored on 4 dimensions: Structure (price action patterns), AccDist (accumulation vs distribution ratio), Holder (quality and loyalty), Market (conditions and volume). Returns: contract address, composite score, all 4 sub-scores, strength label, market cap, price, last updated. $0.01 USDC/call. Platform: https://cryptoiz.org/Dashboard',
+    inputSchema: { type: 'object', properties: { min_composite: { type: 'number', description: 'Minimum composite score 0-100' } }, required: [] }
+  },
+  {
+    name: 'get_btc_regime',
+    description: 'CryptoIZ BTC Regime Monitor — Bitcoin macro condition critical for Solana altcoin trading. Returns: BTC price, regime score 0-10, trend, open interest, funding rate, Fear & Greed Index with interpretation, futures signal, OI regime, funding regime, perp price, RSI/EMA20/EMA50/MACD (1H timeframe), altcoin recommendation. $0.01 USDC/call. Platform: https://cryptoiz.org/BTC',
+    inputSchema: { type: 'object', properties: {}, required: [] }
+  },
+  {
+    name: 'get_status',
+    description: 'Check CryptoIZ MCP server v3.2.0 connection status, payment setup, and complete list of all tools with full data descriptions. Platform: https://cryptoiz.org',
+    inputSchema: { type: 'object', properties: {}, required: [] }
+  },
 ];
-const server = new Server({ name: 'cryptoiz-mcp', version: '3.0.2' }, { capabilities: { tools: {} } });
+// ══════════════════════════════════════════════════════════════════
+// SERVER
+// ══════════════════════════════════════════════════════════════════
+const server = new Server({ name: 'cryptoiz-mcp', version: '3.2.0' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
   try {
     if (name === 'get_status') return { content: [{ type: 'text', text: formatStatus() }] };
     if (name === 'get_alpha_scanner') {
       const data = await payAndFetch(`${GATEWAY_URL}?tool=get_alpha_scanner`);
       if (args?.min_score && data.signals) { data.signals = data.signals.filter(s => parseFloat(s.alpha_score) >= args.min_score); data.total_signals = data.signals.length; }
       if (args?.entry_class && data.signals) { data.signals = data.signals.filter(s => s.signal_class === args.entry_class); data.total_signals = data.signals.length; }
       return { content: [{ type: 'text', text: formatAlpha(data) }] };
     }
     if (name === 'get_divergence') {
       const p = new URLSearchParams({ tool: 'get_divergence' });
       if (args?.timeframe) p.set('tf', args.timeframe);
@@ -373,15 +453,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const data = await payAndFetch(`${GATEWAY_URL}?${p}`);
       return { content: [{ type: 'text', text: formatDivergence(data) }] };
     }
     if (name === 'get_accumulation') {
       const data = await payAndFetch(`${GATEWAY_URL}?tool=get_accumulation`);
       if (args?.min_composite && data.tokens) { data.tokens = data.tokens.filter(t => parseFloat(t.score_composite) >= args.min_composite); data.total_tokens = data.tokens.length; }
       return { content: [{ type: 'text', text: formatAccumulation(data) }] };
     }
     if (name === 'get_btc_regime') {
       const data = await payAndFetch(`${GATEWAY_URL}?tool=get_btc_regime`);
       return { content: [{ type: 'text', text: formatBTC(data) }] };
     }
     return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
   } catch (err) {
     return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };