asrai-mcp 0.5.5 → 0.5.7

package/README.md

@@ -21,7 +21,7 @@ Crypto market analysis MCP server for Claude Desktop — pay-per-use via x402 on
       "command": "npx",
       "args": ["-y", "asrai-mcp"],
       "env": {
-        "PRIVATE_KEY": "0x<your_base_wallet_private_key>"
+        "ASRAI_PRIVATE_KEY": "0x<your_base_wallet_private_key>"
       }
     }
   }
@@ -31,7 +31,7 @@ Crypto market analysis MCP server for Claude Desktop — pay-per-use via x402 on
 **Or** store your key in `~/.env` (loaded automatically — no `env` block needed in config):
 
 ```
-PRIVATE_KEY=0x<your_base_wallet_private_key>
+ASRAI_PRIVATE_KEY=0x<your_base_wallet_private_key>
 ```
 
 ```json
@@ -47,7 +47,7 @@ PRIVATE_KEY=0x<your_base_wallet_private_key>
 
 **Step 2** — Restart Claude Desktop. Done.
 
-Each API call costs **$0.001 USDC** from your wallet on Base mainnet. Make sure your wallet has a small USDC balance (~$1–2 to start).
+Each API call costs **$0.005 USDC** from your wallet on Base mainnet. Make sure your wallet has a small USDC balance (~$1–2 to start).
 
 ## What you get
 
@@ -55,21 +55,21 @@ Each API call costs **$0.001 USDC** from your wallet on Base mainnet. Make sure
 
 | Tool | What it does | Cost |
 |---|---|---|
-| `market_overview` | Trending, gainers/losers, RSI, screeners, sentiment, narratives, cashflow | $0.019 |
-| `technical_analysis` | ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend, TD, forecast, SMC, S/R, Elliott Wave, Ichimoku | $0.012 |
-| `sentiment` | CBBI, CMC sentiment, AI insights | $0.003 |
-| `forecast` | AI 3-7 day price prediction | $0.001 |
-| `screener` | Find coins by criteria | $0.001 |
-| `smart_money` | Order blocks, FVGs, support/resistance | $0.002 |
-| `elliott_wave` | Elliott Wave analysis | $0.001 |
-| `ichimoku` | Ichimoku cloud | $0.001 |
-| `cashflow` | Capital flow data | $0.001 |
-| `coin_info` | Stats, info, price, tags, CMC AI + auto DEX data | $0.005–$0.006 |
-| `dexscreener` | DEX trading data | $0.001 |
-| `chain_tokens` | Low-cap tokens on chain | $0.001 |
-| `portfolio` | Model portfolio — investment reference | $0.001 |
-| `channel_summary` | Latest crypto narratives | $0.001 |
-| `ask_ai` | AI analyst freeform answer | $0.002 |
+| `market_overview` | Trending, gainers/losers, RSI, screeners, sentiment, narratives, cashflow | $0.095 |
+| `technical_analysis` | ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend, TD, forecast, SMC, S/R, Elliott Wave, Ichimoku | $0.06 |
+| `sentiment` | CBBI, CMC sentiment, AI insights | $0.015 |
+| `forecast` | AI 3-7 day price prediction | $0.005 |
+| `screener` | Find coins by criteria | $0.005 |
+| `smart_money` | Order blocks, FVGs, support/resistance | $0.01 |
+| `elliott_wave` | Elliott Wave analysis | $0.005 |
+| `ichimoku` | Ichimoku cloud | $0.005 |
+| `cashflow` | Capital flow data | $0.005 |
+| `coin_info` | Stats, info, price, tags, CMC AI + auto DEX data | $0.025–$0.03 |
+| `dexscreener` | DEX trading data | $0.005 |
+| `chain_tokens` | Low-cap tokens on chain | $0.005 |
+| `portfolio` | Model portfolio — investment reference | $0.005 |
+| `channel_summary` | Latest crypto narratives | $0.005 |
+| `ask_ai` | AI analyst freeform answer | $0.01 |
 | `indicator_guide` | Asrai indicator reference | FREE |
 
 ## Spend limit
@@ -78,7 +78,7 @@ Default session cap: **$2.00 USDC**. To change:
 
 ```json
 "env": {
-  "PRIVATE_KEY": "0x...",
+  "ASRAI_PRIVATE_KEY": "0x...",
   "ASRAI_MAX_SPEND": "5.0"
 }
 ```

package/bin/asrai-mcp.js

@@ -14,8 +14,8 @@ config({ path: join(homedir(), ".env") });
 config();
 
 // Warn if no key set — one message, once
-if (!process.env.PRIVATE_KEY) {
-  process.stderr.write("[asrai-mcp] Warning: PRIVATE_KEY not set — x402 payments will fail.\n");
+if (!process.env.ASRAI_PRIVATE_KEY) {
+  process.stderr.write("[asrai-mcp] Warning: ASRAI_PRIVATE_KEY not set — x402 payments will fail.\n");
   process.stderr.write("[asrai-mcp] Set it in your Claude Desktop config or ~/.env file.\n");
   process.stderr.write("[asrai-mcp] See: https://github.com/abuzerasr/asrai-mcp\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asrai-mcp",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "Asrai crypto analysis MCP server — pay-per-use via x402 on Base. Zero install: just npx.",
   "keywords": [
     "mcp",

package/src/server.js

@@ -1,5 +1,7 @@
 /**
  * Asrai MCP server — tool definitions and request handlers.
+ * TOOLS imported from tools-definitions.js (synced from asrai-shared/).
+ * Do NOT edit shared TOOLS here — edit in asrai-shared/tools-definitions.js and run sync.py.
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -11,180 +13,12 @@ import {
 
 import * as tools from "./tools.js";
 import { indicator_guide } from "./indicator_guide.js";
+import { TOOLS as BASE_TOOLS } from "./tools-definitions.js";
 
-// ── Tool definitions ────────────────────────────────────────────────────────
+// ── x402-only tools (added on top of shared TOOLS) ───────────────────────────
 
 const TOOLS = [
-  {
-    name: "market_overview",
-    description:
-      "Get current crypto market pulse: trending coins, gainers/losers, RSI extremes, top/bottom signals. " +
-      "Use for general market questions like 'what's moving today' or 'give me a market brief'.",
-    inputSchema: { type: "object", properties: {}, required: [] },
-  },
-  {
-    name: "technical_analysis",
-    description:
-      "Get full technical analysis for a specific coin: signal, ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend. " +
-      "Use when asked about TA, buy/sell signals, or indicators for a coin.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH, SOL" },
-        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Timeframe. Default: 1D" },
-      },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "sentiment",
-    description:
-      "Get market sentiment: CBBI (crypto bull/bear index), CMC sentiment, CMC AI insights. " +
-      "Use for questions about market mood, fear/greed, or cycle position.",
-    inputSchema: { type: "object", properties: {}, required: [] },
-  },
-  {
-    name: "forecast",
-    description: "Get AI-powered 3-7 day price forecast for a coin: direction, confidence, price targets.",
-    inputSchema: {
-      type: "object",
-      properties: { symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" } },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "screener",
-    description:
-      "Run a market screener to find coins matching specific criteria. " +
-      "Types: ichimoku-trend, sar-coins, macd-coins, emacross, techrating, vwap, volume, " +
-      "highvolumelowcap, bounce-dip, galaxyscore, socialdominance, late-unlocked-coins, ath, rsi, rsi-heatmap, ao.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        screener_type: {
-          type: "string",
-          enum: [
-            "ichimoku-trend", "sar-coins", "macd-coins", "emacross",
-            "techrating", "vwap", "volume", "highvolumelowcap",
-            "bounce-dip", "galaxyscore", "socialdominance", "late-unlocked-coins",
-            "ath", "rsi", "rsi-heatmap", "ao",
-          ],
-          description: "Type of screener to run",
-        },
-      },
-      required: ["screener_type"],
-    },
-  },
-  {
-    name: "smart_money",
-    description:
-      "Get Smart Money Concepts (SMC): order blocks, fair value gaps, liquidity zones, BOS/CHoCH, " +
-      "plus support/resistance levels.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
-        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
-      },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "elliott_wave",
-    description: "Get Elliott Wave analysis: current wave position, impulse/corrective structure, price targets.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
-        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
-      },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "ichimoku",
-    description: "Get Ichimoku cloud analysis: cloud position, Tenkan/Kijun cross, kumo twist, trend bias for a coin.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
-        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
-      },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "cashflow",
-    description:
-      "Get capital flow data showing where money is moving. " +
-      "Modes: 'market' (overall), 'coin' (single coin), 'group' (comma-separated coins).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        mode: {
-          type: "string",
-          enum: ["market", "coin", "group"],
-          description: "Scope of cashflow data",
-        },
-        symbol: {
-          type: "string",
-          description: "Coin symbol (required for coin/group modes)",
-        },
-      },
-      required: ["mode"],
-    },
-  },
-  {
-    name: "coin_info",
-    description: "Get detailed info for a coin: market cap, volume, supply, social stats, tokenomics.",
-    inputSchema: {
-      type: "object",
-      properties: { symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH, SOL" } },
-      required: ["symbol"],
-    },
-  },
-  {
-    name: "dexscreener",
-    description: "Get DEX trading data for a token: liquidity, volume, buys/sells, price change. Use contract_address alone for symbol search, or provide chain + contract_address for a specific token.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contract_address: { type: "string", description: "Token contract address or symbol" },
-        chain: { type: "string", description: "Optional chain e.g. ethereum, bsc, base, solana" },
-      },
-      required: ["contract_address"],
-    },
-  },
-  {
-    name: "chain_tokens",
-    description: "Get low-cap tokens on a specific blockchain filtered by max market cap.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        chain: { type: "string", description: "Chain e.g. ethereum, bsc, base, solana, avax" },
-        max_mcap: { type: "string", description: "Max market cap e.g. 10000000 (10M)" },
-      },
-      required: ["chain", "max_mcap"],
-    },
-  },
-  {
-    name: "portfolio",
-    description:
-      "Get Abu's curated crypto portfolio — a model portfolio of carefully selected holdings. " +
-      "Use when users ask 'what should I invest in?', 'build me a portfolio', 'what coins to buy', " +
-      "or 'give me investment advice'. No symbol = full portfolio overview. " +
-      "Symbol provided = Abu's position and analysis for that specific coin.",
-    inputSchema: {
-      type: "object",
-      properties: { symbol: { type: "string", description: "Optional coin symbol to filter" } },
-      required: [],
-    },
-  },
-  {
-    name: "channel_summary",
-    description: "Get a summary of latest crypto narratives and discussions from monitored channels.",
-    inputSchema: { type: "object", properties: {}, required: [] },
-  },
+  ...BASE_TOOLS,
   {
     name: "ask_ai",
     description:
@@ -196,26 +30,6 @@ const TOOLS = [
       required: ["question"],
     },
   },
-  {
-    name: "indicator_guide",
-    description:
-      "Reference guide for Asrai-specific indicators. FREE — no payment. " +
-      "WHEN TO CALL: only when you encounter an unfamiliar indicator name in tool output " +
-      "(e.g. ALSAT, SuperALSAT, AlphaTrend, PMax, MavilimW). " +
-      "Standard indicators (RSI, MACD, Ichimoku, Elliott Wave, BB) are well-known — skip them. " +
-      "indicator='' or 'list' → compact 1-line summary of all. " +
-      "indicator='ALSAT' → full detail. indicator='all' → everything (avoid unless needed).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        indicator: {
-          type: "string",
-          description: "Indicator name e.g. 'ALSAT', 'SuperALSAT', 'PMax'. Empty = compact list.",
-        },
-      },
-      required: [],
-    },
-  },
 ];
 
 // ── Request handlers ─────────────────────────────────────────────────────────
@@ -256,7 +70,7 @@ async function handleTool(name, args) {
 
 export function createServer() {
   const server = new Server(
-    { name: "asrai", version: "0.5.0" },
+    { name: "asrai", version: "0.5.5" },
     { capabilities: { tools: {} } }
   );
 

package/src/sse-server.js

@@ -43,7 +43,7 @@ const streamableTransports = {};
 // ── Key extraction helper ─────────────────────────────────────────────────────
 
 function extractKey(req, res, endpoint) {
-  const key = (req.query.key ?? process.env.PRIVATE_KEY ?? "").trim();
+  const key = (req.query.key ?? process.env.ASRAI_PRIVATE_KEY ?? "").trim();
   if (!key) {
     res.status(401).send(`Missing wallet key. Connect with: ${endpoint}?key=0x<private_key>`);
     return null;

package/src/tool-endpoints.js

@@ -0,0 +1,174 @@
+/**
+ * Shared endpoint lists and tool handlers for asrai-mcp and asrai-mcp-apikey.
+ * SOURCE OF TRUTH — edit here, then run sync.py to propagate.
+ *
+ * Add/remove endpoints here → sync.py copies to both projects.
+ * pricing.json call counts must match the arrays here.
+ * Add new tool handlers to createHandlers() below — auto-available in both projects.
+ */
+
+// ── Static endpoint arrays ────────────────────────────────────────────────────
+
+export const MARKET_OVERVIEW_ENDPOINTS = [
+  "/api/trending/",
+  "/api/gainers-losers/",
+  "/api/rsi/",
+  "/api/top-bottom/",
+  "/api/cmcai/",
+  "/api/cbbi/",
+  "/api/channel-summary/",
+  "/api/cashflow/market",
+  "/api/cmc-sentiment/",
+  "/api/socialdominance/",
+  "/api/ath/",
+  "/api/ichimoku-trend/",
+  "/api/bounce-dip/",
+  "/api/sar-coins/",
+  "/api/macd-coins/",
+  "/api/emacross/",
+  "/api/techrating/",
+  "/api/volume/",
+  "/api/highvolumelowcap/",
+];
+
+export const SENTIMENT_ENDPOINTS = [
+  "/api/cbbi/",
+  "/api/cmc-sentiment/",
+  "/api/cmcai/",
+];
+
+// ── Dynamic endpoint builders (return arrays) ─────────────────────────────────
+
+export function technicalAnalysisEndpoints(s, tf) {
+  return [
+    `/api/signal/${s}usdt/${tf}`,
+    `/api/alsat/${s}usdt/${tf}`,
+    `/api/superalsat/${s}usdt`,
+    `/api/psar/${s}usdt/${tf}`,
+    `/api/macd-dema/${s}usdt/${tf}`,
+    `/api/alphatrend/${s}usdt/${tf}`,
+    `/api/td/${s}usdt/${tf}`,
+    `/api/forecasting/${s}usdt`,
+    `/api/smartmoney/${s}usdt/${tf}`,
+    `/api/support-resistance/${s}usdt/${tf}`,
+    `/api/ew/${s}usdt/${tf}`,
+    `/api/ichimoku/${s}usdt/${tf}`,
+  ];
+}
+
+export function smartMoneyEndpoints(s, tf) {
+  return [
+    `/api/smartmoney/${s}usdt/${tf}`,
+    `/api/support-resistance/${s}usdt/${tf}`,
+  ];
+}
+
+export function coinInfoEndpoints(s) {
+  return [
+    `/api/coinstats/${s}`,
+    `/api/info/${s}`,
+    `/api/price/${s}`,
+    `/api/tags/${s}`,
+    `/api/cmcai/${s}`,
+  ];
+}
+
+// ── Screener valid types ──────────────────────────────────────────────────────
+
+export const SCREENER_TYPES = [
+  "ichimoku-trend", "sar-coins", "macd-coins", "emacross",
+  "techrating", "vwap", "volume", "highvolumelowcap",
+  "bounce-dip", "galaxyscore", "socialdominance", "late-unlocked-coins",
+  "ath", "rsi", "rsi-heatmap", "ao",
+];
+
+// ── Symbol normalisation ──────────────────────────────────────────────────────
+
+function sym(symbol) {
+  return symbol.toLowerCase().replace(/usdt$/, "");
+}
+
+// ── Shared tool handlers ──────────────────────────────────────────────────────
+// _get and _gather are injected per-project (x402 vs apikey transport differs).
+// Add new tools here — sync.py copies this file to both projects automatically.
+
+export function createHandlers(_get, _gather) {
+  return {
+    async market_overview() {
+      return JSON.stringify(await _gather(...MARKET_OVERVIEW_ENDPOINTS), null, 2);
+    },
+
+    async technical_analysis(symbol, timeframe = "1D") {
+      const s = sym(symbol);
+      return JSON.stringify(await _gather(...technicalAnalysisEndpoints(s, timeframe)), null, 2);
+    },
+
+    async sentiment() {
+      return JSON.stringify(await _gather(...SENTIMENT_ENDPOINTS), null, 2);
+    },
+
+    async forecast(symbol) {
+      return JSON.stringify(await _get(`/api/forecasting/${sym(symbol)}usdt`), null, 2);
+    },
+
+    async screener(screener_type) {
+      if (!SCREENER_TYPES.includes(screener_type)) {
+        return JSON.stringify({ error: `Invalid screener. Choose from: ${SCREENER_TYPES.join(", ")}` });
+      }
+      return JSON.stringify(await _get(`/api/${screener_type}/`), null, 2);
+    },
+
+    async smart_money(symbol, timeframe = "1D") {
+      const s = sym(symbol);
+      return JSON.stringify(await _gather(...smartMoneyEndpoints(s, timeframe)), null, 2);
+    },
+
+    async elliott_wave(symbol, timeframe = "1D") {
+      return JSON.stringify(await _get(`/api/ew/${sym(symbol)}usdt/${timeframe}`), null, 2);
+    },
+
+    async ichimoku(symbol, timeframe = "1D") {
+      return JSON.stringify(await _get(`/api/ichimoku/${sym(symbol)}usdt/${timeframe}`), null, 2);
+    },
+
+    async cashflow(mode, symbol = "") {
+      if (mode === "market") {
+        return JSON.stringify(await _get("/api/cashflow/market"), null, 2);
+      }
+      if ((mode === "coin" || mode === "group") && symbol) {
+        return JSON.stringify(await _get(`/api/cashflow/${mode}/${symbol.toLowerCase()}`), null, 2);
+      }
+      return JSON.stringify({ error: "mode must be 'market', 'coin', or 'group'. coin/group require symbol." });
+    },
+
+    async coin_info(symbol) {
+      const s = symbol.toLowerCase();
+      const data = await _gather(...coinInfoEndpoints(s));
+      const contractAddress = data[`/api/info/${s}`]?.info_data?.contract_address;
+      if (contractAddress) {
+        data[`/api/dexscreener/${contractAddress}`] = await _get(`/api/dexscreener/${contractAddress}`);
+      }
+      return JSON.stringify(data, null, 2);
+    },
+
+    async dexscreener(contract_address, chain = "") {
+      const path = chain
+        ? `/api/dexscreener/${chain}/${contract_address}`
+        : `/api/dexscreener/${contract_address}`;
+      return JSON.stringify(await _get(path), null, 2);
+    },
+
+    async chain_tokens(chain, max_mcap) {
+      return JSON.stringify(await _get(`/api/chain/${chain}/${max_mcap}`), null, 2);
+    },
+
+    async portfolio(symbol = "") {
+      const path = symbol ? `/api/portfolio/${symbol.toLowerCase()}` : "/api/portfolio/";
+      return JSON.stringify(await _get(path), null, 2);
+    },
+
+    async channel_summary() {
+      return JSON.stringify(await _get("/api/channel-summary/"), null, 2);
+    },
+  };
+}

package/src/tools-definitions.js

@@ -0,0 +1,201 @@
+/**
+ * Shared tool definitions for asrai-mcp and asrai-mcp-apikey.
+ * SOURCE OF TRUTH — edit here, then run sync.py to propagate.
+ *
+ * Note: ask_ai is x402-only and is added in asrai-mcp/src/server.js directly.
+ */
+
+export const TOOLS = [
+  {
+    name: "market_overview",
+    description:
+      "Get current crypto market pulse: trending coins, gainers/losers, RSI extremes, top/bottom signals. " +
+      "Use for general market questions like 'what's moving today' or 'give me a market brief'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "technical_analysis",
+    description:
+      "Get full technical analysis for a specific coin: signal, ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend. " +
+      "Use when asked about TA, buy/sell signals, or indicators for a coin.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH, SOL" },
+        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Timeframe. Default: 1D" },
+      },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "sentiment",
+    description:
+      "Get market sentiment: CBBI (crypto bull/bear index), CMC sentiment, CMC AI insights. " +
+      "Use for questions about market mood, fear/greed, or cycle position.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "forecast",
+    description: "Get AI-powered 3-7 day price forecast for a coin: direction, confidence, price targets.",
+    inputSchema: {
+      type: "object",
+      properties: { symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" } },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "screener",
+    description:
+      "Run a market screener to find coins matching specific criteria. " +
+      "Types: ichimoku-trend, sar-coins, macd-coins, emacross, techrating, vwap, volume, " +
+      "highvolumelowcap, bounce-dip, galaxyscore, socialdominance, late-unlocked-coins, ath, rsi, rsi-heatmap, ao.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        screener_type: {
+          type: "string",
+          enum: [
+            "ichimoku-trend", "sar-coins", "macd-coins", "emacross",
+            "techrating", "vwap", "volume", "highvolumelowcap",
+            "bounce-dip", "galaxyscore", "socialdominance", "late-unlocked-coins",
+            "ath", "rsi", "rsi-heatmap", "ao",
+          ],
+          description: "Type of screener to run",
+        },
+      },
+      required: ["screener_type"],
+    },
+  },
+  {
+    name: "smart_money",
+    description:
+      "Get Smart Money Concepts (SMC): order blocks, fair value gaps, liquidity zones, BOS/CHoCH, " +
+      "plus support/resistance levels.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
+        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
+      },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "elliott_wave",
+    description: "Get Elliott Wave analysis: current wave position, impulse/corrective structure, price targets.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
+        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
+      },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "ichimoku",
+    description: "Get Ichimoku cloud analysis: cloud position, Tenkan/Kijun cross, kumo twist, trend bias for a coin.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH" },
+        timeframe: { type: "string", enum: ["1D", "4H", "1W"], description: "Default: 1D" },
+      },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "cashflow",
+    description:
+      "Get capital flow data showing where money is moving. " +
+      "Modes: 'market' (overall), 'coin' (single coin), 'group' (comma-separated coins).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        mode: {
+          type: "string",
+          enum: ["market", "coin", "group"],
+          description: "Scope of cashflow data",
+        },
+        symbol: {
+          type: "string",
+          description: "Coin symbol (required for coin/group modes)",
+        },
+      },
+      required: ["mode"],
+    },
+  },
+  {
+    name: "coin_info",
+    description: "Get detailed info for a coin: market cap, volume, supply, social stats, tokenomics.",
+    inputSchema: {
+      type: "object",
+      properties: { symbol: { type: "string", description: "Coin symbol e.g. BTC, ETH, SOL" } },
+      required: ["symbol"],
+    },
+  },
+  {
+    name: "dexscreener",
+    description:
+      "Get DEX trading data for a token: liquidity, volume, buys/sells, price change. " +
+      "Use contract_address alone for symbol search, or provide chain + contract_address for a specific token.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        contract_address: { type: "string", description: "Token contract address or symbol" },
+        chain: { type: "string", description: "Optional chain e.g. ethereum, bsc, base, solana" },
+      },
+      required: ["contract_address"],
+    },
+  },
+  {
+    name: "chain_tokens",
+    description: "Get low-cap tokens on a specific blockchain filtered by max market cap.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        chain: { type: "string", description: "Chain e.g. ethereum, bsc, base, solana, avax" },
+        max_mcap: { type: "string", description: "Max market cap e.g. 10000000 (10M)" },
+      },
+      required: ["chain", "max_mcap"],
+    },
+  },
+  {
+    name: "portfolio",
+    description:
+      "Get Abu's curated crypto portfolio — a model portfolio of carefully selected holdings. " +
+      "Use when users ask 'what should I invest in?', 'build me a portfolio', 'what coins to buy', " +
+      "or 'give me investment advice'. No symbol = full portfolio overview. " +
+      "Symbol provided = Abu's position and analysis for that specific coin.",
+    inputSchema: {
+      type: "object",
+      properties: { symbol: { type: "string", description: "Optional coin symbol to filter" } },
+      required: [],
+    },
+  },
+  {
+    name: "channel_summary",
+    description: "Get a summary of latest crypto narratives and discussions from monitored channels.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "indicator_guide",
+    description:
+      "Reference guide for Asrai-specific indicators. FREE — no payment required. " +
+      "WHEN TO CALL: only when you encounter an unfamiliar indicator name in tool output " +
+      "(e.g. ALSAT, SuperALSAT, AlphaTrend, PMax, MavilimW). " +
+      "Standard indicators (RSI, MACD, Ichimoku, Elliott Wave, BB) are well-known — skip them. " +
+      "indicator='' or 'list' → compact 1-line summary of all. " +
+      "indicator='ALSAT' → full detail. indicator='all' → everything (avoid unless needed).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        indicator: {
+          type: "string",
+          description: "Indicator name e.g. 'ALSAT', 'SuperALSAT', 'PMax'. Empty = compact list.",
+        },
+      },
+      required: [],
+    },
+  },
+];

package/src/tools.js

@@ -1,29 +1,34 @@
 /**
  * Asrai API calls via x402 payment protocol.
- * Each call costs $0.001 USDC from the user's wallet on Base mainnet.
+ * Each call costs PRICE_PER_CALL USDC from the user's wallet on Base mainnet.
  *
  * Supports two modes:
- *  - stdio (Claude Desktop): reads PRIVATE_KEY from env
+ *  - stdio (Claude Desktop): reads ASRAI_PRIVATE_KEY from env
  *  - SSE (Docker/n8n): key injected per-connection via AsyncLocalStorage
+ *
+ * Endpoints and tool handlers imported from tool-endpoints.js (synced from asrai-shared/).
+ * Do NOT edit tool handlers here — edit in asrai-shared/tool-endpoints.js and run sync.py.
  */
 
 import { AsyncLocalStorage } from "node:async_hooks";
 import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
 import { registerExactEvmScheme } from "@x402/evm/exact/client";
 import { privateKeyToAccount } from "viem/accounts";
+import { createHandlers } from "./tool-endpoints.js";
 
 const BASE_URL = "https://x402.asrai.me";
 const X402_HEADERS = { "x-coinbase-402": "true", "x-payment-token": "usdc" };
 
 // Per-connection state — works for both stdio and multi-user SSE
-// In stdio mode: nothing set here, falls back to PRIVATE_KEY env var
-// In SSE mode: each connection runs inside connectionStorage.run({ key, spend: 0 }, ...)
 export const connectionStorage = new AsyncLocalStorage();
 
 function getMaxSpend() {
   return parseFloat(process.env.ASRAI_MAX_SPEND ?? "2.0");
 }
 
+// PRICE_PER_CALL — updated by sync.py when pricing.json changes
+const PRICE_PER_CALL = 0.005;
+
 function checkSpend(amount) {
   const store = connectionStorage.getStore();
   if (store) {
@@ -38,11 +43,9 @@ function checkSpend(amount) {
 }
 
 function buildFetch() {
-  // SSE mode: key from per-connection storage
-  // stdio mode: key from env var
   const store = connectionStorage.getStore();
-  const key = store?.key ?? process.env.PRIVATE_KEY;
-  if (!key) throw new Error("PRIVATE_KEY environment variable is required");
+  const key = store?.key ?? process.env.ASRAI_PRIVATE_KEY;
+  if (!key) throw new Error("ASRAI_PRIVATE_KEY environment variable is required");
 
   const signer = privateKeyToAccount(key);
   const client = new x402Client();
@@ -51,7 +54,7 @@ function buildFetch() {
 }
 
 async function _get(path) {
-  checkSpend(0.001);
+  checkSpend(PRICE_PER_CALL);
   const fetchWithPayment = buildFetch();
   const res = await fetchWithPayment(`${BASE_URL}${path}`, {
     headers: X402_HEADERS,
@@ -62,7 +65,7 @@ async function _get(path) {
 }
 
 async function _post(path, body) {
-  checkSpend(0.001);
+  checkSpend(PRICE_PER_CALL);
   const fetchWithPayment = buildFetch();
   const res = await fetchWithPayment(`${BASE_URL}${path}`, {
     method: "POST",
@@ -84,147 +87,15 @@ async function _gather(...paths) {
   return results;
 }
 
-// ── Symbol normalisation ────────────────────────────────────────────────────
-
-function sym(symbol) {
-  return symbol.toLowerCase().replace(/usdt$/, "");
-}
-
-// ── Tool handlers ───────────────────────────────────────────────────────────
-
-export async function market_overview() {
-  return JSON.stringify(await _gather(
-    "/api/trending/",
-    "/api/gainers-losers/",
-    "/api/rsi/",
-    "/api/top-bottom/",
-    "/api/cmcai/",
-    "/api/cbbi/",
-    "/api/channel-summary/",
-    "/api/cashflow/market",
-    "/api/cmc-sentiment/",
-    "/api/socialdominance/",
-    "/api/ath/",
-    "/api/ichimoku-trend/",
-    "/api/bounce-dip/",
-    "/api/sar-coins/",
-    "/api/macd-coins/",
-    "/api/emacross/",
-    "/api/techrating/",
-    "/api/volume/",
-    "/api/highvolumelowcap/",
-  ), null, 2);
-}
-
-export async function technical_analysis(symbol, timeframe = "1D") {
-  const s = sym(symbol);
-  return JSON.stringify(await _gather(
-    `/api/signal/${s}usdt/${timeframe}`,
-    `/api/alsat/${s}usdt/${timeframe}`,
-    `/api/superalsat/${s}usdt`,
-    `/api/psar/${s}usdt/${timeframe}`,
-    `/api/macd-dema/${s}usdt/${timeframe}`,
-    `/api/alphatrend/${s}usdt/${timeframe}`,
-    `/api/td/${s}usdt/${timeframe}`,
-    `/api/forecasting/${s}usdt`,
-    `/api/smartmoney/${s}usdt/${timeframe}`,
-    `/api/support-resistance/${s}usdt/${timeframe}`,
-    `/api/ew/${s}usdt/${timeframe}`,
-    `/api/ichimoku/${s}usdt/${timeframe}`,
-  ), null, 2);
-}
-
-export async function sentiment() {
-  return JSON.stringify(await _gather(
-    "/api/cbbi/",
-    "/api/cmc-sentiment/",
-    "/api/cmcai/",
-  ), null, 2);
-}
-
-export async function forecast(symbol) {
-  return JSON.stringify(await _get(`/api/forecasting/${sym(symbol)}usdt`), null, 2);
-}
-
-export async function screener(screener_type) {
-  const valid = [
-    "ichimoku-trend", "sar-coins", "macd-coins", "emacross",
-    "techrating", "vwap", "volume", "highvolumelowcap",
-    "bounce-dip", "galaxyscore", "socialdominance", "late-unlocked-coins",
-    "ath", "rsi", "rsi-heatmap", "ao",
-  ];
-  if (!valid.includes(screener_type)) {
-    return JSON.stringify({ error: `Invalid screener. Choose from: ${valid.join(", ")}` });
-  }
-  return JSON.stringify(await _get(`/api/${screener_type}/`), null, 2);
-}
-
-export async function smart_money(symbol, timeframe = "1D") {
-  const s = sym(symbol);
-  return JSON.stringify(await _gather(
-    `/api/smartmoney/${s}usdt/${timeframe}`,
-    `/api/support-resistance/${s}usdt/${timeframe}`,
-  ), null, 2);
-}
-
-export async function elliott_wave(symbol, timeframe = "1D") {
-  return JSON.stringify(await _get(`/api/ew/${sym(symbol)}usdt/${timeframe}`), null, 2);
-}
-
-export async function ichimoku(symbol, timeframe = "1D") {
-  return JSON.stringify(await _get(`/api/ichimoku/${sym(symbol)}usdt/${timeframe}`), null, 2);
-}
-
-export async function cashflow(mode, symbol = "") {
-  if (mode === "market") {
-    return JSON.stringify(await _get("/api/cashflow/market"), null, 2);
-  }
-  if ((mode === "coin" || mode === "group") && symbol) {
-    return JSON.stringify(await _get(`/api/cashflow/${mode}/${symbol.toLowerCase()}`), null, 2);
-  }
-  return JSON.stringify({ error: "mode must be 'market', 'coin', or 'group'. coin/group require symbol." });
-}
-
-export async function coin_info(symbol) {
-  const s = symbol.toLowerCase();
+// ── Shared handlers (from tool-endpoints.js) ──────────────────────────────────
 
-  // Phase 1: sequential (x402 wallet conflict prevents parallel)
-  const data = await _gather(
-    `/api/coinstats/${s}`,
-    `/api/info/${s}`,
-    `/api/price/${s}`,
-    `/api/tags/${s}`,
-    `/api/cmcai/${s}`,
-  );
-
-  // Phase 2: dexscreener via contract_address if available
-  const contractAddress = data[`/api/info/${s}`]?.info_data?.contract_address;
-  if (contractAddress) {
-    data[`/api/dexscreener/${contractAddress}`] = await _get(`/api/dexscreener/${contractAddress}`);
-  }
+export const {
+  market_overview, technical_analysis, sentiment, forecast, screener,
+  smart_money, elliott_wave, ichimoku, cashflow, coin_info,
+  dexscreener, chain_tokens, portfolio, channel_summary,
+} = createHandlers(_get, _gather);
 
-  return JSON.stringify(data, null, 2);
-}
-
-export async function dexscreener(contract_address, chain = "") {
-  const path = chain
-    ? `/api/dexscreener/${chain}/${contract_address}`
-    : `/api/dexscreener/${contract_address}`;
-  return JSON.stringify(await _get(path), null, 2);
-}
-
-export async function chain_tokens(chain, max_mcap) {
-  return JSON.stringify(await _get(`/api/chain/${chain}/${max_mcap}`), null, 2);
-}
-
-export async function portfolio(symbol = "") {
-  const path = symbol ? `/api/portfolio/${symbol.toLowerCase()}` : "/api/portfolio/";
-  return JSON.stringify(await _get(path), null, 2);
-}
-
-export async function channel_summary() {
-  return JSON.stringify(await _get("/api/channel-summary/"), null, 2);
-}
+// ── x402-only tools ───────────────────────────────────────────────────────────
 
 export async function ask_ai(question) {
   return JSON.stringify(await _post("/ai", { message: question }), null, 2);