cryptoiz-mcp 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# cryptoiz-mcp
+
+> Real-time Solana DEX signals for Claude Desktop — powered by CryptoIZ Alpha Scanner & Divergence Engine.
+
+## What is this?
+
+`cryptoiz-mcp` is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that connects Claude Desktop directly to CryptoIZ's proprietary Solana signal data.
+
+Ask Claude things like:
+- *"Which Solana tokens are being accumulated today?"*
+- *"Show me bullish divergence signals on 4h timeframe"*
+- *"What are the top alpha signals right now?"*
+
+## Quick Start
+
+### 1. Add to Claude Desktop config
+
+Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "cryptoiz": {
+      "command": "npx",
+      "args": ["cryptoiz-mcp"],
+      "env": {
+        "CRYPTOIZ_API_KEY": "ciz_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### 2. Restart Claude Desktop
+
+That's it. Claude can now call CryptoIZ tools automatically.
+
+---
+
+## Free vs Paid
+
+| Feature | Free (no key) | Basic ($15/mo) | Pro ($25/mo) |
+|---|---|---|---|
+| Accumulation signals | Top 3 only | ✅ Full list | ✅ Full list |
+| Alpha score detail | ❌ | ✅ | ✅ |
+| Whale & dolphin signal | ❌ | ✅ | ✅ |
+| Divergence signals | ❌ | ✅ 4h + 1d | ✅ 4h + 1d |
+| Warkudara peaks | ❌ | ❌ | ✅ |
+| Daily call limit | 3/day | 200/day | Unlimited |
+
+Get your API key → **[cryptoiz.org/Pricing](https://cryptoiz.org/Pricing)**
+
+---
+
+## Available Tools
+
+### `get_accum_signals`
+Accumulation tokens hari ini dari CryptoIZ Alpha Scanner.
+
+```
+Parameters:
+  min_score (optional) — Minimum alpha score filter (0-100)
+```
+
+### `get_divergence`
+Divergence signals dari CryptoIZ Divergence Engine.
+
+```
+Parameters:
+  timeframe (optional) — "4h" (default) or "1d"
+  limit     (optional) — Max results, 1-50 (default: 20)
+```
+
+### `get_status`
+Cek koneksi, tier aktif, dan tools yang tersedia.
+
+---
+
+## Example Prompts
+
+```
+"Show me today's accumulation signals with score above 70"
+"Any bullish divergence on 1d timeframe?"
+"Which tokens are whales accumulating right now on Solana?"
+"Give me the top 5 alpha signals from CryptoIZ today"
+```
+
+---
+
+## About CryptoIZ
+
+CryptoIZ adalah AI-powered Solana DEX trading platform. Data sinyal kami berasal dari proprietary scanner yang menganalisis holder tier, whale/dolphin rotation, phase engine, dan divergence — bukan dari lagging indicators.
+
+Website: [cryptoiz.org](https://cryptoiz.org)
+Twitter: [@cryptoiz_IDN](https://twitter.com/cryptoiz_IDN)
+
+---
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "cryptoiz-mcp",
+  "version": "1.0.0",
+  "description": "CryptoIZ MCP Server — Solana DEX Alpha Scanner, Divergence & Accumulation signals for Claude Desktop",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "cryptoiz-mcp": "src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "keywords": ["cryptoiz", "solana", "defi", "mcp", "claude", "crypto", "alpha", "signals", "divergence", "accumulation"],
+  "author": "CryptoIZ <cryptoiz.suport@gmail.com> (https://cryptoiz.org)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dadang11/cryptoiz-internal-dashboard2"
+  },
+  "homepage": "https://cryptoiz.org",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const BASE_URL = 'https://rehqwsypjnjirhuiapqh.supabase.co/functions/v1';
+const API_KEY  = process.env.CRYPTOIZ_API_KEY || '';
+
+async function callApi(endpoint, params = {}) {
+  const url = new URL(`${BASE_URL}/${endpoint}`);
+  Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+  const headers = { 'Content-Type': 'application/json' };
+  if (API_KEY) headers['x-api-key'] = API_KEY;
+  const res = await fetch(url.toString(), { headers });
+  const json = await res.json();
+  if (!res.ok) throw new Error(json.error || `HTTP ${res.status}`);
+  return json;
+}
+
+function formatAlphaScanner(data) {
+  if (!data.signals || data.signals.length === 0) return 'Tidak ada sinyal Alpha Scanner saat ini.';
+  const lines = [
+    `CRYPTOIZ ALPHA SCANNER`,
+    `Tier: ${data.tier.toUpperCase()} | Total: ${data.total} | ${new Date(data.fetched_at).toUTCString()}`,
+    data.note ? `INFO: ${data.note}` : '',
+    '',
+    ...data.signals.map((s, i) => {
+      if (data.tier === 'free') return `${i+1}. ${s.token} — Phase: ${s.phase} [${s.entry_class}]`;
+      const whale = s.whale_delta > 0 ? `WHALE+${s.whale_delta}` : `WHALE${s.whale_delta}`;
+      const dolph = s.dolphin_delta > 0 ? `DOLPHIN+${s.dolphin_delta}` : `DOLPHIN${s.dolphin_delta}`;
+      return `${i+1}. ${s.token} — Score: ${s.alpha_score} | ${s.entry_class} | Phase: ${s.phase}\n   ${whale} | ${dolph} | Regime: ${s.regime || 'N/A'}`;
+    }).filter(Boolean),
+    '', 'Source: CryptoIZ Alpha Entry Scanner | cryptoiz.org',
+  ];
+  return lines.join('\n');
+}
+
+function formatDivergence(data) {
+  if (!data.signals || data.signals.length === 0) return `Tidak ada divergence signal (${data.timeframe}).`;
+  const lines = [
+    `CRYPTOIZ DIVERGENCE SCANNER — ${data.timeframe?.toUpperCase()}`,
+    `Tier: ${data.tier.toUpperCase()} | Total: ${data.total} | ${new Date(data.fetched_at).toUTCString()}`,
+    '',
+    ...data.signals.map((s, i) => {
+      const type  = s.divergence_type === 'bullish' ? 'BULLISH' : s.divergence_type === 'bearish' ? 'BEARISH' : (s.divergence_type||'').toUpperCase();
+      const score = s.divergence_score ? `Score: ${s.divergence_score.toFixed(1)}` : '';
+      const conf  = s.confidence_score ? `Conf: ${s.confidence_score.toFixed(1)}` : '';
+      const mc    = s.market_cap_usd ? `MC: $${(s.market_cap_usd/1000).toFixed(0)}K` : '';
+      const chg   = s.price_change_pct ? `${s.price_change_pct>0?'+':''}${s.price_change_pct.toFixed(1)}%` : '';
+      return `${i+1}. ${s.token||s.symbol} [${type}]\n   ${[score,conf,mc,chg].filter(Boolean).join(' | ')}`;
+    }),
+    '', 'Source: CryptoIZ Divergence Engine | cryptoiz.org',
+  ];
+  return lines.join('\n');
+}
+
+function formatAccumulation(data) {
+  if (!data.tokens || data.tokens.length === 0) return 'Tidak ada token dalam mode akumulasi saat ini.';
+  const lines = [
+    `CRYPTOIZ AKUMULASI`,
+    `Tier: ${data.tier.toUpperCase()} | Total: ${data.total} | ${new Date(data.fetched_at).toUTCString()}`,
+    data.note ? `INFO: ${data.note}` : '',
+    '',
+    ...data.tokens.map((t, i) => {
+      if (data.tier === 'free') return `${i+1}. ${t.token} — ${t.strength} | ${t.accdist}`;
+      const s = t.scores;
+      return `${i+1}. ${t.token} — Composite: ${s.composite?.toFixed(1)||'N/A'} | ${t.strength}\n   Structure: ${s.structure?.toFixed(1)||'-'} | AccDist: ${s.accdist?.toFixed(0)||'-'} | Holder: ${s.holder?.toFixed(1)||'-'} | Market: ${s.market?.toFixed(1)||'-'}`;
+    }).filter(Boolean),
+    '', 'Source: CryptoIZ Accumulation Dashboard | cryptoiz.org',
+  ];
+  return lines.join('\n');
+}
+
+function formatStatus() {
+  return [
+    `CryptoIZ MCP Server v1.1.0`, `Status  : CONNECTED`,
+    `Tier    : ${API_KEY ? 'Basic/Pro (API key terdeteksi)' : 'Free (tidak ada API key)'}`,
+    ``, `Tools tersedia:`,
+    `  1. get_alpha_scanner  — Sinyal entry terbaik (Alpha Scanner)`,
+    `  2. get_divergence     — Divergence bullish/bearish 4h atau 1d`,
+    `  3. get_accumulation   — Token fase akumulasi (Accum Dashboard)`,
+    `  4. get_status         — Info koneksi & tier`,
+    ``, `Upgrade: cryptoiz.org/Pricing`,
+  ].join('\n');
+}
+
+const TOOLS = [
+  {
+    name: 'get_alpha_scanner',
+    description: 'Sinyal dari CryptoIZ Alpha Entry Scanner — token Solana dengan akumulasi terkuat berdasarkan alpha_score. Free: top 3. Basic/Pro: full list + detail.',
+    inputSchema: { type: 'object', properties: {
+      min_score: { type: 'number', description: 'Filter minimum alpha score (0-100).' },
+      entry_class: { type: 'string', enum: ['ALPHA_BUILDING','ALPHA_EARLY','WATCHLIST_ONLY'], description: 'Filter berdasarkan entry class.' },
+    }, required: [] },
+  },
+  {
+    name: 'get_divergence',
+    description: 'Sinyal divergence dari CryptoIZ — deteksi bullish/bearish divergence antara harga dan aktivitas whale/dolphin. Butuh API key Basic/Pro.',
+    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: 'Token dalam fase akumulasi dari CryptoIZ Accumulation Dashboard — menggunakan composite_score (Structure + AccDist + Holder + Market). Identik dengan tab Akumulasi di dashboard.',
+    inputSchema: { type: 'object', properties: {
+      min_composite: { type: 'number', description: 'Filter minimum composite score (0-100).' },
+    }, required: [] },
+  },
+  {
+    name: 'get_status',
+    description: 'Cek status koneksi CryptoIZ MCP dan daftar tools tersedia.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+];
+
+const server = new Server(
+  { name: 'cryptoiz-mcp', version: '1.1.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 callApi('mcp-accum-signals');
+      if (args?.min_score && data.tier !== 'free' && data.signals) { data.signals = data.signals.filter(s => s.alpha_score >= args.min_score); data.total = data.signals.length; }
+      if (args?.entry_class && data.tier !== 'free' && data.signals) { data.signals = data.signals.filter(s => s.entry_class === args.entry_class); data.total = data.signals.length; }
+      return { content: [{ type: 'text', text: formatAlphaScanner(data) }] };
+    }
+    if (name === 'get_divergence') {
+      const params = {};
+      if (args?.timeframe) params.tf = args.timeframe;
+      if (args?.limit) params.limit = String(args.limit);
+      const data = await callApi('mcp-divergence-signals', params);
+      return { content: [{ type: 'text', text: formatDivergence(data) }] };
+    }
+    if (name === 'get_accumulation') {
+      const data = await callApi('mcp-accumulation');
+      if (args?.min_composite && data.tier !== 'free' && data.tokens) { data.tokens = data.tokens.filter(t => t.scores?.composite >= args.min_composite); data.total = data.tokens.length; }
+      return { content: [{ type: 'text', text: formatAccumulation(data) }] };
+    }
+    return { content: [{ type: 'text', text: `Tool tidak dikenal: ${name}` }], isError: true };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);