cryptoiz-mcp 2.0.2 → 2.1.0

package/package.json

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

@@ -13,6 +13,18 @@ const USDC_MINT = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
 const SOL_RPC = 'https://api.mainnet-beta.solana.com';
 const AMOUNT = 10000;
 
+// ─── Footer branding (selalu muncul di setiap response) ──────────────────────
+const FOOTER = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🌐 cryptoiz.org — Platform AI Trading Solana
+📊 Alpha Scanner · Divergence · Accumulation · BTC Regime
+🐦 Twitter/X : @cryptoiz_IDN
+💬 Telegram  : t.me/agus_artemiss
+💡 Untuk data lebih lengkap, analisis mendalam, dan sinyal premium
+   kunjungi cryptoiz.org dan subscribe platform kami.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`;
+
+// ─── Payment handler ──────────────────────────────────────────────────────────
 async function payAndFetch(url) {
   if (!SVM_PRIVATE_KEY) {
     return { error: 'SVM_PRIVATE_KEY tidak ditemukan.', setup: 'Tambahkan SVM_PRIVATE_KEY ke config Claude Desktop.', help: 'cryptoiz.org' };
@@ -35,93 +47,244 @@ async function payAndFetch(url) {
   }
 }
 
-// ─── Formatters ───────────────────────────────────────────────────────────────
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+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 ? `⚠️  ${fmt(r)}%` : `✅ 0%`;
+const fmtPrice = p => p ? `$${parseFloat(p).toFixed(6)}` : 'N/A';
+
+function entryAdvice(s) {
+  const lines = [];
+  if (s.entry_class === 'ALPHA_EARLY' && s.phase?.includes('ACCUM')) {
+    lines.push('💡 SINYAL KUAT: Fase akumulasi awal dengan smart money masuk. Potensi entry terbaik sebelum harga naik.');
+  } else if (s.entry_class === 'ALPHA_BUILDING') {
+    lines.push('💡 MEMBANGUN: Akumulasi sedang berlanjut. Timing masih baik namun hati-hati dengan risiko.');
+  } else {
+    lines.push('👁️  WATCHLIST: Belum memenuhi semua kriteria entry. Monitor terus untuk konfirmasi.');
+  }
+  if (s.whale_delta > 0 && s.dolphin_delta > 0) lines.push('✅ Whale & Dolphin sama-sama masuk — sinyal kuat smart money akumulasi.');
+  if (s.smart_money_trap_risk > 30) lines.push('⚠️  Trap Risk tinggi — waspadai jebakan sebelum entry.');
+  if (s.liquidity_drain_risk > 30) lines.push('⚠️  Liquidity Risk tinggi — pastikan ada likuiditas cukup saat exit.');
+  if (s.safety_score >= 80) lines.push('🛡️  Safety score tinggi — risiko manipulasi rendah.');
+  return lines.join('\n   ');
+}
 
-function fmt(n, dec=2) { return n != null ? parseFloat(n).toFixed(dec) : 'N/A'; }
-function fmtMC(mc) { if (!mc) return 'N/A'; if (mc >= 1e6) return `$${(mc/1e6).toFixed(2)}M`; return `$${(mc/1000).toFixed(0)}K`; }
-function fmtDelta(d) { return d > 0 ? `+${d}` : `${d}`; }
-function fmtRisk(r) { return r > 0 ? `⚠️ ${fmt(r)}%` : '✅ 0%'; }
+function divergenceAdvice(s) {
+  if (s.divergence_type === 'bullish') return '💡 BULLISH DIVERGENCE: Harga turun tapi whale/dolphin masuk. Potensi reversal ke atas — perhatikan untuk entry.';
+  if (s.divergence_type === 'bearish') return '⚠️  BEARISH DIVERGENCE: Harga naik tapi whale/dolphin keluar. Potensi reversal ke bawah — hati-hati jika sudah hold.';
+  return '📊 Divergence terdeteksi — analisa lebih lanjut diperlukan.';
+}
+
+function accumAdvice(s) {
+  if (s.strength_label?.includes('VERY_STRONG')) return '💡 VERY STRONG: Smart money sangat aktif akumulasi. Kandidat entry terkuat.';
+  if (s.strength_label?.includes('STRONG')) return '💡 STRONG: Akumulasi kuat terdeteksi. Perhatikan untuk entry opportunity.';
+  return '👁️  FORMING: Akumulasi mulai terbentuk. Monitor untuk konfirmasi lebih lanjut.';
+}
+
+// ─── Formatters ───────────────────────────────────────────────────────────────
 
 function formatAlpha(data) {
-  if (data.error) return `❌ ERROR: ${data.error}\n${data.setup||''}`;
-  if (!data.signals?.length) return 'Tidak ada sinyal Alpha Scanner saat ini.';
+  if (data.error) return `❌ ${data.error}\n${data.setup||''}\n📱 Setup: cryptoiz.org`;
+  if (!data.signals?.length) return `Tidak ada sinyal Alpha Scanner saat ini.\n${FOOTER}`;
+
   const lines = [
-    `╔═══ CRYPTOIZ ALPHA SCANNER ═══╗`,
-    `📅 ${data.fetched_at?.split('T')[0]} | Total: ${data.total} sinyal`,
-    `💰 $0.01 USDC | cryptoiz.org | @cryptoiz_IDN`,
-    `╚═══════════════════════════════╝`,
-    '',
+    `╔══════════════════════════════════════╗`,
+    `║     CRYPTOIZ ALPHA ENTRY SCANNER     ║`,
+    `╚══════════════════════════════════════╝`,
+    `📅 ${data.fetched_at?.split('T')[0]} | Total Sinyal: ${data.total}`,
+    ``,
+    `📖 APA INI?`,
+    `Alpha Scanner menggunakan AI untuk mendeteksi token Solana`,
+    `yang sedang diakumulasi oleh whale & dolphin (smart money)`,
+    `sebelum harga bergerak. Score 0-100 berdasarkan:`,
+    `• Accumulation Score — seberapa aktif smart money masuk`,
+    `• Timing Score       — seberapa tepat timing entry`,
+    `• Safety Score       — seberapa aman dari manipulasi`,
+    ``,
+    `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
     ...data.signals.map((s, i) => [
-      `${i+1}. ━━━ ${s.name} ━━━`,
-      `   📊 Alpha Score : ${fmt(s.alpha_score)} | ${s.entry_class}`,
-      `   📍 Phase       : ${s.phase} (Conf: ${fmt(s.phase_confidence)}% | Age: ${s.phase_age_bars} bars)`,
-      `   🌐 Regime      : ${s.regime}`,
-      `   🐋 Whale       : ${fmtDelta(s.whale_delta)} (${fmt(s.whale_pct)}% supply)`,
-      `   🐬 Dolphin     : ${fmtDelta(s.dolphin_delta)} (${fmt(s.dolphin_pct)}% supply)`,
-      `   🦐 Shrimp      : ${fmtDelta(s.shrimp_delta)}`,
-      `   📈 Sub-scores  : Accum ${fmt(s.accumulation_score)} | Timing ${fmt(s.timing_score)} | Safety ${fmt(s.safety_score)}`,
-      `   ⚠️  Risks       : Liq ${fmtRisk(s.liquidity_drain_risk)} | Trap ${fmtRisk(s.smart_money_trap_risk)}`,
-      `   📉 Price Drop  : ${s.price_drop_pct != null ? fmt(s.price_drop_pct)+'%' : 'N/A'}`,
-      `   💰 Market Cap  : ${fmtMC(s.market_cap_usd)}`,
-      `   💵 Price       : $${s.price_usd ? parseFloat(s.price_usd).toFixed(6) : 'N/A'}`,
-      `   🔗 Address     : ${s.token_address}`,
+      ``,
+      `${i+1}. ━━━ ${s.name} ━━━━━━━━━━━━━━━━━━━`,
+      `   🔗 Address    : ${s.token_address}`,
+      `   📊 Alpha Score: ${fmt(s.alpha_score)} / 100 | Kelas: ${s.entry_class}`,
+      `   📍 Phase      : ${s.phase} | Regime: ${s.regime}`,
+      `   🎯 Keyakinan  : ${fmt(s.phase_confidence)}% | Umur Phase: ${s.phase_age_bars} bars`,
+      ``,
+      `   HOLDER SIGNALS:`,
+      `   🐋 Whale      : ${fmtD(s.whale_delta)} (${fmt(s.whale_pct)}% supply)`,
+      `   🐬 Dolphin    : ${fmtD(s.dolphin_delta)} (${fmt(s.dolphin_pct)}% supply)`,
+      `   🦐 Shrimp     : ${fmtD(s.shrimp_delta)} (keluar = bullish)`,
+      ``,
+      `   SUB-SCORES:`,
+      `   📈 Accum      : ${fmt(s.accumulation_score)} | Timing: ${fmt(s.timing_score)} | Safety: ${fmt(s.safety_score)}`,
+      ``,
+      `   RISIKO:`,
+      `   💧 Liquidity  : ${fmtRisk(s.liquidity_drain_risk)}`,
+      `   🪤 Trap Risk  : ${fmtRisk(s.smart_money_trap_risk)}`,
+      ``,
+      `   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'}`,
+      ``,
+      `   REKOMENDASI:`,
+      `   ${entryAdvice(s)}`,
+      `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
     ].join('\n')),
-    '',
-    '📊 Data by CryptoIZ — cryptoiz.org | @cryptoiz_IDN',
+    FOOTER,
   ];
   return lines.join('\n');
 }
 
 function formatDivergence(data) {
-  if (data.error) return `❌ ERROR: ${data.error}`;
-  if (!data.signals?.length) return `Tidak ada divergence signal (${data.timeframe}).`;
+  if (data.error) return `❌ ${data.error}\n${FOOTER}`;
+  if (!data.signals?.length) return `Tidak ada divergence signal (${data.timeframe}).\n${FOOTER}`;
+
   const lines = [
-    `╔═══ CRYPTOIZ DIVERGENCE SCANNER ═══╗`,
-    `📅 ${data.timeframe?.toUpperCase()} | Total: ${data.total}`,
-    `💰 $0.01 USDC | cryptoiz.org | @cryptoiz_IDN`,
-    `╚════════════════════════════════════╝`,
-    '',
+    `╔══════════════════════════════════════╗`,
+    `║     CRYPTOIZ DIVERGENCE SCANNER      ║`,
+    `╚══════════════════════════════════════╝`,
+    `📅 ${data.fetched_at?.split('T')[0]} | Timeframe: ${data.timeframe?.toUpperCase()} | Total: ${data.total}`,
+    ``,
+    `📖 APA INI?`,
+    `Divergence terjadi ketika harga bergerak berlawanan dengan`,
+    `aktivitas smart money (whale/dolphin). Ini adalah sinyal awal`,
+    `sebelum harga berbalik arah:`,
+    `• BULLISH: Harga turun tapi smart money masuk → potensi naik`,
+    `• BEARISH: Harga naik tapi smart money keluar → potensi turun`,
+    ``,
+    `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
     ...data.signals.map((s, i) => {
-      const type = s.divergence_type === 'bullish' ? '🟢 BULLISH' : s.divergence_type === 'bearish' ? '🔴 BEARISH' : (s.divergence_type||'').toUpperCase();
+      const type = s.divergence_type === 'bullish' ? '🟢 BULLISH' : s.divergence_type === 'bearish' ? '🔴 BEARISH' : `⚪ ${(s.divergence_type||'').toUpperCase()}`;
       return [
-        `${i+1}. ━━━ ${s.name||s.symbol} ━━━`,
-        `   📊 Divergence : ${type} (Score: ${fmt(s.divergence_score)})`,
-        `   🎯 Confidence : ${fmt(s.confidence_score)}%`,
-        `   📍 Phase      : ${s.phase_label}`,
-        `   🐋 Whale      : ${fmtDelta(s.whale_delta)} | 🐬 Dolphin: ${fmtDelta(s.dolphin_delta)}`,
-        `   💰 Market Cap : ${fmtMC(s.market_cap_usd)}`,
-        `   💵 Price      : $${s.price_usd ? parseFloat(s.price_usd).toFixed(6) : 'N/A'}`,
-        `   📉 Change     : ${s.price_change_pct ? fmt(s.price_change_pct)+'%' : 'N/A'}`,
-        `   🔗 Address    : ${s.token_address}`,
-        `   🕐 Detected   : ${s.detected_at ? new Date(s.detected_at).toUTCString() : 'N/A'}`,
+        ``,
+        `${i+1}. ━━━ ${s.name||s.symbol} [${type}] ━━━`,
+        `   🔗 Address     : ${s.token_address}`,
+        `   📊 Div. 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)}`,
+        ``,
+        `   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).toLocaleString('id-ID') : 'N/A'}`,
+        ``,
+        `   REKOMENDASI:`,
+        `   ${divergenceAdvice(s)}`,
+        `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
       ].join('\n');
     }),
-    '',
-    '📊 Data by CryptoIZ — cryptoiz.org | @cryptoiz_IDN',
+    FOOTER,
   ];
   return lines.join('\n');
 }
 
-function formatAccum(data) {
-  if (data.error) return `❌ ERROR: ${data.error}`;
-  if (!data.tokens?.length) return 'Tidak ada token dalam fase akumulasi.';
+function formatAccumulation(data) {
+  if (data.error) return `❌ ${data.error}\n${FOOTER}`;
+  if (!data.tokens?.length) return `Tidak ada token dalam fase akumulasi.\n${FOOTER}`;
+
   const lines = [
-    `╔═══ CRYPTOIZ AKUMULASI ═══╗`,
-    `📅 ${data.fetched_at?.split('T')[0]} | Total: ${data.total}`,
-    `💰 $0.01 USDC | cryptoiz.org | @cryptoiz_IDN`,
-    `╚══════════════════════════╝`,
-    '',
+    `╔══════════════════════════════════════╗`,
+    `║     CRYPTOIZ ACCUMULATION SCANNER    ║`,
+    `╚══════════════════════════════════════╝`,
+    `📅 ${data.fetched_at?.split('T')[0]} | Total: ${data.total} token akumulasi`,
+    ``,
+    `📖 APA INI?`,
+    `Accumulation Dashboard mendeteksi token yang sedang dalam`,
+    `fase akumulasi berdasarkan 4 dimensi analisis:`,
+    `• Structure Score — pola price action & holder tier`,
+    `• AccDist Score   — distribusi akumulasi vs distribusi`,
+    `• Holder Score    — kualitas & konsistensi holder`,
+    `• Market Score    — kondisi pasar & volume`,
+    `Composite Score = gabungan keempat dimensi di atas.`,
+    ``,
+    `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
     ...data.tokens.map((t, i) => [
-      `${i+1}. ━━━ ${t.name} ━━━`,
-      `   📊 Composite   : ${fmt(t.composite_score)} | ${t.strength_label}`,
-      `   🔄 AccDist     : ${t.accdist_label} (Score: ${fmt(t.accdist_score)})`,
-      `   📈 Structure   : ${fmt(t.structure_score)}`,
-      `   👥 Holder      : ${fmt(t.holder_score)}`,
-      `   📉 Market      : ${fmt(t.market_score)}`,
-      `   🔗 Address     : ${t.token_address}`,
+      ``,
+      `${i+1}. ━━━ ${t.name} ━━━━━━━━━━━━━━━━━━━`,
+      `   🔗 Address      : ${t.token_address}`,
+      `   📊 Composite    : ${fmt(t.composite_score)} / 100`,
+      `   💪 Strength     : ${t.strength_label}`,
+      `   🔄 AccDist      : ${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)}`,
+      ``,
+      `   REKOMENDASI:`,
+      `   ${accumAdvice(t)}`,
+      `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
     ].join('\n')),
-    '',
-    '📊 Data by CryptoIZ — cryptoiz.org | @cryptoiz_IDN',
+    FOOTER,
+  ];
+  return lines.join('\n');
+}
+
+function formatBTC(data) {
+  if (data.error) return `❌ ${data.error}\n${FOOTER}`;
+  const s = data.btc_signal || {};
+  const f = data.futures_signal || {};
+  const ind = data.indicators || {};
+
+  const stateEmoji = s.state === 'bull' ? '🟢' : s.state === 'bear' ? '🔴' : '🟡';
+  const signalEmoji = f.signal === 'LONG' ? '🟢' : f.signal === 'SHORT' ? '🔴' : '🟡';
+
+  const lines = [
+    `╔══════════════════════════════════════╗`,
+    `║       CRYPTOIZ BTC REGIME MONITOR    ║`,
+    `╚══════════════════════════════════════╝`,
+    `📅 ${data.fetched_at?.split('T')[0]}`,
+    ``,
+    `📖 APA INI?`,
+    `BTC Regime Monitor menganalisis kondisi makro Bitcoin`,
+    `untuk membantu kamu memahami apakah pasar sedang bullish,`,
+    `bearish, atau neutral. Ini penting karena kondisi BTC`,
+    `sangat mempengaruhi pergerakan altcoin di Solana.`,
+    ``,
+    `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+    ``,
+    `${stateEmoji} KONDISI BTC SAAT INI: ${(s.state||'').toUpperCase()}`,
+    `   💵 Harga BTC  : $${s.last_price ? parseFloat(s.last_price).toLocaleString() : 'N/A'}`,
+    `   📊 BTC Score  : ${s.score || 'N/A'} (0=sangat bear, 10=sangat bull)`,
+    `   📈 Trend      : ${s.trend || 'N/A'}`,
+    ``,
+    `SENTIMENT:`,
+    `   😱 Fear & Greed: ${s.fear_label || 'N/A'} (${s.fear_value || 'N/A'}/100)`,
+    `   💡 ${s.fear_value <= 25 ? 'Extreme Fear = peluang beli sering muncul di level ini' : s.fear_value >= 75 ? 'Extreme Greed = hati-hati, pasar bisa reversal' : 'Sentimen netral — ikuti sinyal teknikal'}`,
+    ``,
+    `FUTURES DATA:`,
+    `   ${signalEmoji} Signal Futures : ${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'}`,
+    `   📝 Alasan      : ${f.reason || 'N/A'}`,
+    ``,
+    ind.rsi ? [
+      `INDIKATOR TEKNIKAL (1H):`,
+      `   RSI    : ${fmt(ind.rsi)} ${parseFloat(ind.rsi) < 30 ? '(Oversold ✅)' : parseFloat(ind.rsi) > 70 ? '(Overbought ⚠️)' : '(Normal)'}`,
+      `   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)}`,
+      ``,
+    ].join('\n') : '',
+    `REKOMENDASI UNTUK ALTCOIN SOLANA:`,
+    s.state === 'bull' ? `   🟢 BTC bullish → kondisi BAGUS untuk cari entry altcoin Solana.
+   Fokus pada token dengan Alpha Score tinggi di cryptoiz.org.` :
+    s.state === 'bear' ? `   🔴 BTC bearish → HATI-HATI entry altcoin.
+   Prioritaskan token dengan Safety Score tinggi dan liq risk rendah.` :
+    `   🟡 BTC neutral → Selektif dalam memilih entry.
+   Tunggu konfirmasi signal sebelum masuk posisi besar.`,
+    `   📊 Cek kondisi terkini di: cryptoiz.org/BTC`,
+    ``,
+    `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+    `⚠️  Bukan financial advice. Selalu DYOR.`,
+    FOOTER,
   ];
   return lines.join('\n');
 }
@@ -129,33 +292,52 @@ function formatAccum(data) {
 function formatStatus() {
   const hasKey = !!SVM_PRIVATE_KEY;
   return [
-    `╔═══ CryptoIZ MCP Server v2.0.2 ═══╗`,
-    `   Status  : ✅ CONNECTED`,
-    `   Payment : ${hasKey ? '✅ READY — x402 Solana USDC ($0.01/call)' : '❌ NOT SET — tambahkan SVM_PRIVATE_KEY'}`,
-    `   Wallet  : DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`,
-    `╚═══════════════════════════════════╝`,
-    ``,
-    `Tools tersedia:`,
-    `  1. get_alpha_scanner  — Alpha entry signals + address + MC`,
-    `  2. get_divergence     — Divergence bullish/bearish + address`,
-    `  3. get_accumulation   — Token fase akumulasi + address`,
-    `  4. get_status         — Info server ini`,
-    ``,
-    `💰 $0.01 USDC per call via Solana`,
-    `🌐 cryptoiz.org | @cryptoiz_IDN`,
+    `╔══════════════════════════════════════╗`,
+    `║     CryptoIZ MCP Server v2.1.0       ║`,
+    `╚══════════════════════════════════════╝`,
+    ``,
+    `STATUS KONEKSI:`,
+    `   ✅ CONNECTED ke CryptoIZ Data Engine`,
+    `   ${hasKey ? '✅ PAYMENT READY — x402 Solana USDC' : '❌ PAYMENT NOT SET — tambahkan SVM_PRIVATE_KEY'}`,
+    `   💰 Harga      : $0.01 USDC per call`,
+    `   🏦 Wallet CRZ : DsKmdkYx49Xc1WhqMUAztwhdYPTqieyC98VmnnJdgpXX`,
+    ``,
+    `TOOLS TERSEDIA:`,
+    `   1. get_alpha_scanner  — Token Solana dengan akumulasi terkuat`,
+    `      Termasuk: address, MC, price, holder signals, sub-scores, risks`,
+    ``,
+    `   2. get_divergence     — Divergence bullish/bearish`,
+    `      Termasuk: address, MC, price, confidence, waktu deteksi`,
+    ``,
+    `   3. get_accumulation   — Token fase akumulasi (composite score)`,
+    `      Termasuk: address, 4 sub-scores, strength label`,
+    ``,
+    `   4. get_btc_regime     — Kondisi makro Bitcoin`,
+    `      Termasuk: price, fear & greed, OI regime, funding, indikator`,
+    ``,
+    `   5. get_status         — Info server ini`,
+    ``,
+    `CARA PAKAI:`,
+    `   • Tanya: "Sinyal Solana hari ini?"`,
+    `   • Tanya: "Ada divergence bullish?"`,
+    `   • Tanya: "Token mana yang diakumulasi whale?"`,
+    `   • Tanya: "Kondisi BTC sekarang?"`,
+    FOOTER,
   ].join('\n');
 }
 
+// ─── Tool definitions ─────────────────────────────────────────────────────────
 const TOOLS = [
-  { name: 'get_alpha_scanner', description: 'Sinyal token Solana terkuat dari CryptoIZ Alpha Scanner — lengkap dengan address, MC, price, holder signals, sub-scores, risks. $0.01 USDC/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: 'Divergence signals dari CryptoIZ — bullish/bearish dengan address, MC, confidence score. $0.01 USDC/call.', inputSchema: { type: 'object', properties: { timeframe: { type: 'string', enum: ['4h','1d'] }, limit: { type: 'number' } }, required: [] } },
-  { name: 'get_accumulation', description: 'Token fase akumulasi dari CryptoIZ Accumulation Dashboard — composite score, holder, market score + address. $0.01 USDC/call.', inputSchema: { type: 'object', properties: { min_composite: { type: 'number' } }, required: [] } },
-  { name: 'get_status', description: 'Status koneksi CryptoIZ MCP dan info payment.', inputSchema: { type: 'object', properties: {}, required: [] } },
+  { name: 'get_alpha_scanner', description: 'Ambil sinyal token Solana terkuat dari CryptoIZ Alpha Scanner. Termasuk contract address, market cap, price, holder signals (whale/dolphin/shrimp), sub-scores (accum/timing/safety), dan risiko. Biaya $0.01 USDC via Solana.', 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'], description: 'Filter entry class.' } }, required: [] } },
+  { name: 'get_divergence', description: 'Ambil divergence signals dari CryptoIZ — deteksi bullish/bearish divergence antara harga dan aktivitas whale/dolphin. Termasuk address, MC, price, confidence score, waktu deteksi. Biaya $0.01 USDC.', inputSchema: { type: 'object', properties: { timeframe: { type: 'string', enum: ['4h','1d'], description: 'Timeframe. Default: 4h.' }, limit: { type: 'number', description: 'Max hasil (1-50). Default: 20.' } }, required: [] } },
+  { name: 'get_accumulation', description: 'Ambil token dalam fase akumulasi dari CryptoIZ Accumulation Dashboard. Composite score dari 4 dimensi: Structure, AccDist, Holder, Market. Termasuk address. Biaya $0.01 USDC.', inputSchema: { type: 'object', properties: { min_composite: { type: 'number', description: 'Minimum composite score (0-100).' } }, required: [] } },
+  { name: 'get_btc_regime', description: 'Ambil kondisi makro Bitcoin dari CryptoIZ BTC Monitor. Termasuk: state (bull/bear/neutral), Fear & Greed Index, OI regime, funding rate, sinyal futures, dan indikator teknikal. Penting untuk konteks altcoin Solana. Biaya $0.01 USDC.', inputSchema: { type: 'object', properties: {}, required: [] } },
+  { name: 'get_status', description: 'Cek status koneksi CryptoIZ MCP, info payment, dan daftar tools tersedia.', inputSchema: { type: 'object', properties: {}, required: [] } },
 ];
 
-const server = new Server({ name: 'cryptoiz-mcp', version: '2.0.2' }, { capabilities: { tools: {} } });
+// ─── Server ───────────────────────────────────────────────────────────────────
+const server = new Server({ name: 'cryptoiz-mcp', version: '2.1.0' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
-
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
   try {
@@ -179,7 +361,12 @@ 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; }
-      return { content: [{ type: 'text', text: formatAccum(data) }] };
+      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: `Tool tidak dikenal: ${name}` }], isError: true };