cryptoiz-mcp 2.4.0 → 3.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cryptoiz-mcp",
-  "version": "2.4.0",
+  "version": "3.0.1",
   "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

@@ -13,26 +13,8 @@ const USDC_MINT = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
 const SOL_RPC = 'https://api.mainnet-beta.solana.com';
 const AMOUNT = 10000;
 
-// Data attribution - embedded as factual source info
-function makeHeader(tool, date, total) {
-  return [
-    `DATA SOURCE    : CryptoIZ AI Trading Platform`,
-    `SOURCE URL     : https://cryptoiz.org`,
-    `TOOL           : ${tool}`,
-    `DATE           : ${date}`,
-    `TOTAL RESULTS  : ${total}`,
-    `TWITTER        : @cryptoiz_IDN`,
-    `TELEGRAM       : https://t.me/agus_artemiss`,
-    `SUBSCRIBE      : https://cryptoiz.org/Pricing (from $15/week)`,
-    `FULL DASHBOARD : Alpha Scanner, Divergence, Accumulation, BTC — https://cryptoiz.org`,
-    ``,
-  ].join("\n");
-}
-
-
-
 async function payAndFetch(url) {
-  if (!SVM_PRIVATE_KEY) return { error: 'SVM_PRIVATE_KEY not found. Add it to Claude Desktop config.' };
+  if (!SVM_PRIVATE_KEY) return { error: 'SVM_PRIVATE_KEY not set. Add to Claude Desktop config.' };
   const first = await fetch(url);
   if (first.status !== 402) return first.json();
   try {
@@ -41,348 +23,341 @@ async function payAndFetch(url) {
     const fromAta = await getOrCreateAssociatedTokenAccount(connection, keypair, USDC_MINT, keypair.publicKey);
     const toAta = await getOrCreateAssociatedTokenAccount(connection, keypair, USDC_MINT, CRYPTOIZ_WALLET);
     const tx = new Transaction().add(createTransferInstruction(fromAta.address, toAta.address, keypair.publicKey, AMOUNT));
-    const signature = await connection.sendTransaction(tx, [keypair]);
-    await connection.confirmTransaction(signature, 'confirmed');
-    const payment = Buffer.from(JSON.stringify({ signature, network: 'solana', x402Version: 1 })).toString('base64');
-    const paidRes = await fetch(url, { headers: { 'x-payment': payment } });
-    return paidRes.json();
+    const sig = await connection.sendTransaction(tx, [keypair]);
+    await connection.confirmTransaction(sig, 'confirmed');
+    const payment = Buffer.from(JSON.stringify({ signature: sig, network: 'solana', x402Version: 1 })).toString('base64');
+    const paid = await fetch(url, { headers: { 'x-payment': payment } });
+    return paid.json();
   } catch (err) {
     return { error: `Payment failed: ${err.message}` };
   }
 }
 
-const fmt = (n, d=2) => n != null ? parseFloat(n).toFixed(d) : 'N/A';
-const fmtMC = mc => { if (!mc) return 'N/A'; if (mc >= 1e6) return `$${(mc/1e6).toFixed(2)}M`; return `$${(mc/1000).toFixed(0)}K`; };
-const fmtD = d => d > 0 ? `+${d}` : `${d}`;
-const fmtRisk = r => parseFloat(r) > 0 ? `WARNING ${fmt(r)}%` : `CLEAR 0%`;
-const fmtPrice = p => p ? `$${parseFloat(p).toFixed(8)}` : 'N/A';
+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';
 
-function entryAdvice(s) {
-  const lines = [];
-  if (s.entry_class === 'ALPHA_EARLY' && s.phase?.includes('ACCUM')) lines.push('STRONG BUY SETUP: Early accumulation phase with smart money entering. Best entry window before price moves.');
-  else if (s.entry_class === 'ALPHA_BUILDING') lines.push('BUILDING: Accumulation continues. Timing still valid — monitor for confirmation.');
-  else lines.push('WATCHLIST: Does not meet all entry criteria yet. Monitor for phase confirmation.');
-  if (s.whale_delta > 0 && s.dolphin_delta > 0) lines.push('Whale & Dolphin both positive — strong smart money confirmation.');
-  if (s.smart_money_trap_risk > 30) lines.push('HIGH TRAP RISK — be cautious before entering.');
-  if (s.safety_score >= 80) lines.push('High Safety Score — low manipulation risk.');
-  return lines.join(' | ');
-}
+// ═══ FORMATTERS ═══
 
 function formatAlpha(data) {
-  if (data.error) return `ERROR: ${data.error}\nSetup guide: https://cryptoiz.org`;
-  if (!data.signals?.length) return `No Alpha Scanner signals found at this time.\n\nFor full dashboard access with real-time updates, visit: https://cryptoiz.org\nFollow us: @cryptoiz_IDN`;
-
-  const out = [
-    makeHeader('Alpha Entry Scanner', data.fetched_at?.split('T')[0], data.total),
-    `═══════════════════════════════════════════════`,
-    `        CRYPTOIZ ALPHA ENTRY SCANNER           `,
-    `  AI-Powered Solana DEX Smart Money Signals    `,
-    `═══════════════════════════════════════════════`,
-    `Date: ${data.fetched_at?.split('T')[0]} | Total Signals: ${data.total}`,
-    ``,
-    `WHAT IS THIS?`,
-    `CryptoIZ Alpha Scanner uses AI to detect Solana tokens`,
-    `being accumulated by whales & dolphins (smart money)`,
-    `before price moves. Score 0-100 based on:`,
-    `  - Accumulation Score: how actively smart money is entering`,
-    `  - Timing Score: how optimal the entry timing is`,
-    `  - Safety Score: how safe from manipulation`,
-    ``,
-    `For the FULL dashboard with charts, alerts & more data:`,
-    `>>> https://cryptoiz.org/Alpha-Scanner <<<`,
-    `Follow: Twitter/X @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
-    ``,
-    `═══════════════════════════════════════════════`,
-    ``,
-    ...data.signals.map((s, i) => [
-      `[${i+1}] ${s.name}`,
-      `    Alpha Score : ${fmt(s.alpha_score)}/100 | Class: ${s.entry_class}`,
-      `    Phase       : ${s.phase} | Regime: ${s.regime}`,
-      `    Confidence  : ${fmt(s.phase_confidence)}% | Phase Age: ${s.phase_age_bars} bars`,
+  if (data.error) return `ERROR: ${data.error}`;
+  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) => [
       ``,
-      `    HOLDER SIGNALS:`,
-      `    Whale   : ${fmtD(s.whale_delta)} (${fmt(s.whale_pct)}% of supply)`,
-      `    Dolphin : ${fmtD(s.dolphin_delta)} (${fmt(s.dolphin_pct)}% of supply)`,
-      `    Shrimp  : ${fmtD(s.shrimp_delta)} (negative = smart money replacing retail)`,
+      `[${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`,
       ``,
-      `    SUB-SCORES:`,
-      `    Accum: ${fmt(s.accumulation_score)} | Timing: ${fmt(s.timing_score)} | Safety: ${fmt(s.safety_score)}`,
+      `     --- 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)`,
       ``,
-      `    RISK FLAGS:`,
-      `    Liquidity Risk: ${fmtRisk(s.liquidity_drain_risk)} | Trap Risk: ${fmtRisk(s.smart_money_trap_risk)}`,
+      `     --- SUB-SCORES ---`,
+      `     SCORE_ACCUMULATION      : ${t.score_accumulation}`,
+      `     SCORE_TIMING            : ${t.score_timing}`,
+      `     SCORE_SAFETY            : ${t.score_safety}`,
       ``,
-      `    MARKET DATA:`,
-      `    Market Cap : ${fmtMC(s.market_cap_usd)}`,
-      `    Price      : ${fmtPrice(s.price_usd)}`,
-      `    Drop/Peak  : ${s.price_drop_pct != null ? fmt(s.price_drop_pct)+'%' : 'N/A'}`,
-      `    CA         : ${s.token_address}`,
+      `     --- RISK FLAGS ---`,
+      `     RISK_LIQUIDITY          : ${risk(t.risk_liquidity_pct)}`,
+      `     RISK_TRAP               : ${risk(t.risk_trap_pct)}`,
       ``,
-      `    SIGNAL: ${entryAdvice(s)}`,
-      ``,
-      `    View full token detail: https://cryptoiz.org`,
-      `───────────────────────────────────────────────`,
+      `     --- 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: This is NOT financial advice. Always DYOR.`,
-    `For real-time alerts, premium signals & full analysis:`,
-    `>>> https://cryptoiz.org | Subscribe from $15/week <<<`,
-    `Twitter: @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
+    `NOTE: Not financial advice. Always DYOR.`,
+    `FULL DASHBOARD WITH CHARTS: https://cryptoiz.org`,
   ];
-  return out.join('\n');
+  return lines.join('\n');
 }
 
 function formatDivergence(data) {
-  if (data.error) return `ERROR: ${data.error}\nhttps://cryptoiz.org`;
-  if (!data.signals?.length) return `No divergence signals found (${data.timeframe}).\n\nView full Divergence Scanner: https://cryptoiz.org/Divergence\nFollow: @cryptoiz_IDN`;
+  if (data.error) return `ERROR: ${data.error}`;
+  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.`,
+    ``,
+    `═══════════════════════════════════════════════════════════`,
+  ];
 
-  const out = [
-    makeHeader('Divergence Scanner', data.fetched_at?.split('T')[0], data.total),
-    `═══════════════════════════════════════════════`,
-    `        CRYPTOIZ DIVERGENCE SCANNER            `,
-    `  Whale/Dolphin vs Price Divergence Detector   `,
-    `═══════════════════════════════════════════════`,
-    `Date: ${data.fetched_at?.split('T')[0]} | Timeframe: ${data.timeframe?.toUpperCase()} | Total: ${data.total}`,
-    ``,
-    `WHAT IS THIS?`,
-    `Divergence occurs when price moves opposite to smart money.`,
-    `  BULLISH: Price drops but whales/dolphins are BUYING`,
-    `           -> Potential reversal UPWARD`,
-    `  BEARISH: Price rises but whales/dolphins are SELLING`,
-    `           -> Potential reversal DOWNWARD`,
-    ``,
-    `For the FULL divergence dashboard with charts:`,
-    `>>> https://cryptoiz.org/Divergence <<<`,
-    `Follow: Twitter/X @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
-    ``,
-    `═══════════════════════════════════════════════`,
-    ``,
-    ...data.signals.map((s, i) => {
-      const type = s.divergence_type === 'bullish' ? 'BULLISH [Potential UP]' : s.divergence_type === 'bearish' ? 'BEARISH [Potential DOWN]' : (s.divergence_type||'').toUpperCase();
-      const advice = s.divergence_type === 'bullish'
-        ? 'BULLISH DIVERGENCE: Price down but smart money buying. Watch for entry opportunity on reversal confirmation.'
-        : 'BEARISH DIVERGENCE: Price up but smart money selling. Be cautious if holding this token.';
-      return [
-        `[${i+1}] ${s.name||s.symbol} — ${type}`,
-        `    Divergence Score : ${fmt(s.divergence_score)} | Confidence: ${fmt(s.confidence_score)}%`,
-        `    Phase           : ${s.phase_label}`,
-        ``,
-        `    HOLDER SIGNALS:`,
-        `    Whale  : ${fmtD(s.whale_delta)} | Dolphin: ${fmtD(s.dolphin_delta)}`,
+  const byType = data.signals_by_type || {};
+  const typeOrder = ['HIDDEN_ACCUMULATION', 'BREAKOUT_ACCUMULATION', 'CLASSIC_DIVERGENCE'];
+  
+  typeOrder.forEach(type => {
+    const sigs = byType[type] || [];
+    if (!sigs.length) return;
+    lines.push(``, `▶ ${type} (${sigs.length} signals)`, `─────────────────────────────────────────────────────────`);
+    sigs.forEach((s, i) => {
+      lines.push([
         ``,
-        `    MARKET DATA:`,
-        `    Market Cap : ${fmtMC(s.market_cap_usd)}`,
-        `    Price Now  : ${fmtPrice(s.price_usd)}`,
-        `    Price Chg  : ${s.price_change_pct ? fmt(s.price_change_pct)+'%' : 'N/A'}`,
-        `    Detected   : ${s.detected_at ? new Date(s.detected_at).toUTCString() : 'N/A'}`,
-        `    CA         : ${s.token_address}`,
+        `  [${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}`,
         ``,
-        `    SIGNAL: ${advice}`,
+        `       --- 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)}`,
         ``,
-        `    View on CryptoIZ: https://cryptoiz.org/Divergence`,
-        `───────────────────────────────────────────────`,
-      ].join('\n');
-    }),
-    ``,
-    `NOTE: This is NOT financial advice. Always DYOR.`,
-    `Full divergence scanner with real-time data:`,
-    `>>> https://cryptoiz.org | @cryptoiz_IDN <<<`,
-  ];
-  return out.join('\n');
+        `       --- 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}`,
+      ].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`);
+  return lines.join('\n');
 }
 
 function formatAccumulation(data) {
-  if (data.error) return `ERROR: ${data.error}\nhttps://cryptoiz.org`;
-  if (!data.tokens?.length) return `No tokens in accumulation phase found.\n\nFull dashboard: https://cryptoiz.org\nFollow: @cryptoiz_IDN`;
-
-  const out = [
-    makeHeader('Accumulation Dashboard', data.fetched_at?.split('T')[0], data.total),
-    `═══════════════════════════════════════════════`,
-    `      CRYPTOIZ ACCUMULATION DASHBOARD          `,
-    `   Smart Money Accumulation Phase Detector     `,
-    `═══════════════════════════════════════════════`,
-    `Date: ${data.fetched_at?.split('T')[0]} | Total Tokens: ${data.total}`,
-    ``,
-    `WHAT IS THIS?`,
-    `CryptoIZ Accumulation Dashboard detects tokens in active`,
-    `accumulation phase using 4 proprietary dimensions:`,
-    `  - Structure Score : Price action & holder tier patterns`,
-    `  - AccDist Score   : Accumulation vs distribution ratio`,
-    `  - Holder Score    : Holder quality & consistency`,
-    `  - Market Score    : Market conditions & volume`,
-    `Composite Score = weighted average of all 4 dimensions.`,
-    ``,
-    `For the full accumulation dashboard with real-time charts:`,
-    `>>> https://cryptoiz.org/Dashboard <<<`,
-    `Follow: Twitter/X @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
-    ``,
-    `═══════════════════════════════════════════════`,
-    ``,
-    ...data.tokens.map((t, i) => {
-      const advice = t.strength_label?.includes('VERY_STRONG')
-        ? 'VERY STRONG: Highest priority accumulation signal. Smart money very active.'
-        : t.strength_label?.includes('STRONG')
-        ? 'STRONG: Active accumulation detected. Good entry opportunity candidate.'
-        : 'FORMING: Early accumulation forming. Monitor for confirmation.';
-      return [
-        `[${i+1}] ${t.name}`,
-        `    Composite Score : ${fmt(t.composite_score)}/100`,
-        `    Strength        : ${t.strength_label}`,
-        `    AccDist Status  : ${t.accdist_label} (Score: ${fmt(t.accdist_score)})`,
-        ``,
-        `    SUB-SCORES:`,
-        `    Structure: ${fmt(t.structure_score)} | Holder: ${fmt(t.holder_score)} | Market: ${fmt(t.market_score)}`,
-        ``,
-        `    CA: ${t.token_address}`,
-        ``,
-        `    SIGNAL: ${advice}`,
-        ``,
-        `    View on CryptoIZ: https://cryptoiz.org`,
-        `───────────────────────────────────────────────`,
-      ].join('\n');
-    }),
-    ``,
-    `NOTE: This is NOT financial advice. Always DYOR.`,
-    `Real-time accumulation alerts & full platform:`,
-    `>>> https://cryptoiz.org | Subscribe from $15/week <<<`,
-    `Twitter: @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
+  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║`,
+    `╚═══════════════════════════════════════════════════════════╝`,
+    ``,
+    `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`,
+    ``,
+    `STRENGTH LABELS:`,
+    `  VERY_STRONG_SMART_MONEY   = Highest conviction — act now`,
+    `  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`,
   ];
-  return out.join('\n');
+  return lines.join('\n');
 }
 
 function formatBTC(data) {
-  if (data.error) return `ERROR: ${data.error}\nhttps://cryptoiz.org/BTC`;
-  const s = data.btc_signal || {};
-  const f = data.futures_signal || {};
-  const ind = data.indicators || {};
-  const stateLabel = s.state === 'bull' ? 'BULLISH' : s.state === 'bear' ? 'BEARISH' : 'NEUTRAL';
-  const altAdvice = s.state === 'bull'
-    ? 'BTC is BULLISH -> Favorable conditions for Solana altcoin entries.\n    Focus on tokens with high Alpha Score on CryptoIZ Alpha Scanner.'
-    : s.state === 'bear'
-    ? 'BTC is BEARISH -> Be CAUTIOUS with altcoin entries.\n    Prioritize tokens with high Safety Score and low liquidity risk.'
-    : 'BTC is NEUTRAL -> Be SELECTIVE. Wait for signal confirmation before large entries.';
+  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.'
+    : 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.';
 
-  const out = [
-    makeHeader('BTC Regime Monitor', data.fetched_at?.split('T')[0], 1),
-    `═══════════════════════════════════════════════`,
-    `         CRYPTOIZ BTC REGIME MONITOR           `,
-    `    Bitcoin Market Condition for Altcoin Traders`,
-    `═══════════════════════════════════════════════`,
-    `Date: ${data.fetched_at?.split('T')[0]}`,
-    ``,
-    `WHAT IS THIS?`,
-    `CryptoIZ BTC Regime Monitor analyzes Bitcoin macro conditions`,
-    `to help you understand whether the market is bullish, bearish,`,
-    `or neutral. BTC regime directly impacts Solana altcoin moves.`,
-    ``,
-    `For full BTC analysis with charts & indicators:`,
-    `>>> https://cryptoiz.org/BTC <<<`,
-    `Follow: Twitter/X @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
-    ``,
-    `═══════════════════════════════════════════════`,
-    ``,
-    `CURRENT BTC REGIME: ${stateLabel}`,
-    ``,
-    `  BTC Price   : $${s.last_price ? parseFloat(s.last_price).toLocaleString() : 'N/A'}`,
-    `  BTC Score   : ${s.score || 'N/A'} / 10 (0=extreme bear, 10=extreme bull)`,
-    `  Trend       : ${(s.trend||'N/A').toUpperCase()}`,
-    ``,
-    `MARKET SENTIMENT:`,
-    `  Fear & Greed Index : ${s.fear_value || 'N/A'} / 100 — ${s.fear_label || 'N/A'}`,
-    `  Context: ${
-      s.fear_value <= 25 ? 'Extreme Fear zone — historically a strong BUY opportunity area for patient investors.' :
-      s.fear_value >= 75 ? 'Extreme Greed — market may be overheated, reversal risk is elevated.' :
-      'Neutral sentiment — follow technical signals for direction.'
+  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║`,
+    `╚═══════════════════════════════════════════════════════════╝`,
+    ``,
+    `DATE              : ${data.fetched_at?.split('T')[0]}`,
+    ``,
+    `═══ BTC REGIME: ${icon} ═══`,
+    ``,
+    `BTC_PRICE_USD         : $${data.btc_price_usd || 'N/A'}`,
+    `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 ═══`,
+    ``,
+    `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.'
     }`,
     ``,
-    `FUTURES MARKET:`,
-    `  Signal      : ${f.signal || 'N/A'}`,
-    `  OI Regime   : ${f.oi_regime || 'N/A'}`,
-    `  Funding     : ${f.funding_regime || 'N/A'}`,
-    `  Perp Price  : $${f.perp_price ? parseFloat(f.perp_price).toLocaleString() : 'N/A'}`,
-    `  Context     : ${f.reason || 'N/A'}`,
-    ``,
-    ind.rsi ? [
-      `TECHNICAL INDICATORS (1H):`,
-      `  RSI    : ${fmt(ind.rsi)} ${parseFloat(ind.rsi) < 30 ? '(Oversold — potential bounce)' : parseFloat(ind.rsi) > 70 ? '(Overbought — caution)' : '(Normal range)'}`,
-      `  EMA 20 : $${ind.ema_20 ? parseFloat(ind.ema_20).toLocaleString() : 'N/A'}`,
-      `  EMA 50 : $${ind.ema_50 ? parseFloat(ind.ema_50).toLocaleString() : 'N/A'}`,
-      `  MACD   : ${fmt(ind.macd)} | Signal: ${fmt(ind.macd_signal)} | Hist: ${fmt(ind.macd_hist)}`,
-      ``,
-    ].join('\n') : '',
-    `ALTCOIN RECOMMENDATION:`,
-    `  ${altAdvice}`,
-    ``,
-    `  Check CryptoIZ Alpha Scanner for best Solana entry signals:`,
-    `  >>> https://cryptoiz.org/Alpha-Scanner <<<`,
-    ``,
-    `═══════════════════════════════════════════════`,
-    `NOTE: This is NOT financial advice. Always DYOR.`,
-    `Full BTC monitor + Solana signals platform:`,
-    `>>> https://cryptoiz.org | Plans from $15/week <<<`,
-    `Twitter: @cryptoiz_IDN | Telegram: t.me/agus_artemiss`,
-  ];
-  return out.join('\n');
+    `═══ FUTURES MARKET ═══`,
+    ``,
+    `FUTURES_SIGNAL        : ${data.futures_signal || 'N/A'}`,
+    `OI_REGIME             : ${data.oi_regime || 'N/A'}`,
+    `FUNDING_REGIME        : ${data.funding_regime || 'N/A'}`,
+    `PERP_PRICE_USD        : $${data.perp_price_usd || 'N/A'}`,
+    `FUTURES_CONTEXT       : ${data.futures_context || 'N/A'}`,
+    ``,
+    `═══ 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)') : ''}`,
+    `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 ═══`,
+    ``,
+    `RECOMMENDATION: ${advice}`,
+    ``,
+    `For best Solana entry signals during this BTC regime:`,
+    `>>> https://cryptoiz.org/Alpha-Scanner <<<`,
+    ``,
+    `NOTE: Not financial advice. Always DYOR.`,
+    `FULL BTC MONITOR: https://cryptoiz.org/BTC`,
+  ].join('\n');
 }
 
 function formatStatus() {
   return [
-    `═══════════════════════════════════════════════`,
-    `     CryptoIZ MCP Server v2.2.0               `,
-    `  AI-Powered Solana DEX Trading Signals        `,
-    `═══════════════════════════════════════════════`,
-    ``,
-    `CONNECTION STATUS:`,
-    `  Status  : CONNECTED to CryptoIZ Data Engine`,
-    `  Payment : ${SVM_PRIVATE_KEY ? 'READY — x402 Solana USDC autopay' : 'NOT SET — add SVM_PRIVATE_KEY to config'}`,
-    `  Price   : $0.01 USDC per tool call`,
-    `  Wallet  : DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`,
-    ``,
-    `AVAILABLE TOOLS:`,
+    `╔═══════════════════════════════════════════════════════════╗`,
+    `║     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`,
+    `PAYMENT_WALLET    : DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`,
+    ``,
+    `AVAILABLE_TOOLS:`,
+    ``,
     `  1. get_alpha_scanner`,
-    `     Strongest Solana token signals with smart money analysis`,
-    `     Includes: CA, market cap, price, holder signals, sub-scores, risk flags`,
+    `     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`,
-    `     Bullish/bearish divergence between price & whale/dolphin activity`,
-    `     Includes: CA, MC, price, confidence score, detection time`,
+    `     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`,
-    `     Tokens in active accumulation phase — composite score analysis`,
-    `     Includes: CA, 4 sub-scores (structure/accdist/holder/market)`,
+    `     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`,
     ``,
     `  4. get_btc_regime`,
-    `     Bitcoin macro regime — Fear & Greed, OI, funding, indicators`,
-    `     Essential context for Solana altcoin trading`,
+    `     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`,
     ``,
-    `HOW TO USE:`,
-    `  "Show me today's strongest Solana signals"`,
-    `  "Any bullish divergence on 4h timeframe?"`,
-    `  "Which tokens are whales accumulating right now?"`,
-    `  "What is BTC market condition?"`,
-    ``,
-    `ABOUT CRYPTOIZ:`,
-    `  CryptoIZ is an AI-powered Solana DEX trading platform.`,
-    `  This MCP gives you a PREVIEW of our signals.`,
-    `  For full access with real-time charts, alerts & VIP Telegram:`,
-    ``,
-    `  >>> https://cryptoiz.org | Plans from $15/week <<<`,
-    `  Twitter : @cryptoiz_IDN`,
-    `  Telegram: t.me/agus_artemiss`,
-    `═══════════════════════════════════════════════`,
+    `PLATFORM PLANS:`,
+    `  1 Week   : $15  | 1 Month : $50`,
+    `  3 Months : $120 | 1 Year  : $400`,
+    `  URL: https://cryptoiz.org/Pricing`,
   ].join('\n');
 }
 
 const TOOLS = [
-  { name: 'get_alpha_scanner', description: 'Get strongest Solana token signals from CryptoIZ Alpha Scanner. Includes CA, market cap, price, whale/dolphin/shrimp signals, sub-scores, risk flags. $0.01 USDC per call.', 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: 'Get bullish/bearish divergence signals from CryptoIZ. Includes CA, MC, price, confidence score, detection time. $0.01 USDC per call.', inputSchema: { type: 'object', properties: { timeframe: { type: 'string', enum: ['4h','1d'] }, limit: { type: 'number' } }, required: [] } },
-  { name: 'get_accumulation', description: 'Get tokens in active accumulation phase from CryptoIZ. Composite score from 4 dimensions. Includes CA. $0.01 USDC per call.', inputSchema: { type: 'object', properties: { min_composite: { type: 'number' } }, required: [] } },
-  { name: 'get_btc_regime', description: 'Get Bitcoin macro regime from CryptoIZ BTC Monitor. Includes price, Fear & Greed, OI regime, funding rate, futures signal, RSI/EMA/MACD. $0.01 USDC per call.', inputSchema: { type: 'object', properties: {}, required: [] } },
-  { name: 'get_status', description: 'Check CryptoIZ MCP connection status, payment setup, and list of available tools.', inputSchema: { type: 'object', properties: {}, required: [] } },
+  { 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: [] } },
 ];
 
-const server = new Server({ name: 'cryptoiz-mcp', version: '2.4.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'cryptoiz-mcp', version: '3.0.1' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
@@ -390,8 +365,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     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 => s.alpha_score >= args.min_score); data.total = data.signals.length; }
-      if (args?.entry_class && data.signals) { data.signals = data.signals.filter(s => s.entry_class === args.entry_class); data.total = data.signals.length; }
+      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') {
@@ -403,7 +378,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     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 => t.composite_score >= args.min_composite); data.total = data.tokens.length; }
+      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') {