asrai-mcp 1.0.4 → 1.2.1

package/README.md

@@ -66,7 +66,7 @@ Each API call costs **$0.005 USDC** from your wallet on Base mainnet. Make sure
 | `macro` | S&P 500 & Nasdaq signals — global market context | $0.01 |
 | `sentiment` | CBBI, CMC sentiment, AI insights, channel news, Galaxy Score, social dominance | $0.03 |
 | `late_unlocked_coins` | Post-vesting coins with low remaining selling pressure | $0.005 |
-| `trade_signals` | Trade setups: trending movers, bounces, SAR & MACD entries | $0.025 |
+| `trade_signals` | Trade setups: trending movers, bounces, SAR & MACD entries, RSI, Galaxy Score, today's indicator signals | $0.04 |
 | `technical_analysis(symbol, timeframe)` | Signals, ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend, TD, SMC, S/R, Elliott Wave, Ichimoku | $0.06 |
 | `forecast(symbol)` | AI 3-7 day price prediction | $0.005 |
 | `screener(type)` | Find coins by criteria (ichimoku-trend, rsi, vwap, volume, bounce-dip...) | $0.005 |

package/package.json

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

package/skill/SKILL.md

@@ -13,11 +13,32 @@ Use Asrai tools when the user asks about crypto prices, market analysis, trading
 
 - Crypto price / chart / technical analysis → use asrai tools
 - Market sentiment, CBBI, fear/greed → use asrai tools
-- "What should I buy?" / portfolio advice → use `portfolio` tool
+- "What should I buy?" / buy opportunities / entry points → use `trade_signals` + `portfolio`
+- Full market overview / morning report → use `market_overview`
 - Elliott Wave, smart money, order blocks → use asrai tools
 - DEX data, low-cap tokens → use asrai tools
 - General knowledge you already know well → answer directly (costs $0.005 per call)
 
+## Tool selection guide
+
+| User asks... | Primary tool | Supporting tools |
+|---|---|---|
+| "what to buy?" / "buy opportunities" / "entry points" | `trade_signals` | `portfolio`, `sentiment` |
+| "market overview" / "morning report" / "full brief" | `market_overview` | — |
+| "what's trending?" / "hot coins" | `trending` | `gainers_losers` |
+| "BTC analysis" / chart / signals | `technical_analysis` | `smart_money`, `elliott_wave` |
+| "price prediction" / "forecast" | `forecast` | `technical_analysis` |
+| "market sentiment" / "fear greed" / CBBI | `sentiment` | `dominance`, `macro` |
+| "ATH" / "all-time high" coins | `ath_tracker` | `trade_signals` |
+| "volume spikes" / unusual volume | `volume_spikes` | `high_volume_low_cap` |
+| "find coins" / screener criteria | `screener` | `top_bottom` |
+| "cashflow" / capital flow | `cashflow` | `sentiment` |
+| "unlocked coins" / vesting pressure | `late_unlocked_coins` | — |
+| "low cap gems" / DEX / chain tokens | `chain_tokens` | `dexscreener`, `high_volume_low_cap` |
+| "portfolio" / "Abu's picks" | `portfolio` | `coin_info` |
+
+**Important:** For buy opportunity questions ALWAYS call `trade_signals` — it combines trending movers, bounces, SAR & MACD entries, RSI, and Galaxy Score in one call.
+
 ## How to call
 
 ### If asrai MCP tools are available (Cursor, Cline, Claude Desktop)
@@ -69,7 +90,7 @@ Requires `ASRAI_PRIVATE_KEY` set in `~/.env` or environment. Payment is signed a
 | `macro` | S&P 500 & Nasdaq signals — global market context | $0.01 |
 | `sentiment` | CBBI, CMC sentiment, AI insights, channel news, Galaxy Score, social dominance | $0.03 |
 | `late_unlocked_coins` | Post-vesting coins with low remaining selling pressure | $0.005 |
-| `trade_signals` | Trade setups: trending movers, bounces, SAR & MACD entries | $0.025 |
+| `trade_signals` | Trade setups: trending movers, bounces, SAR & MACD entries, RSI, Galaxy Score, today's indicator signals | $0.04 (8 calls) |
 | `technical_analysis(symbol, timeframe)` | Signals, ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend, TD, SMC, S/R, Elliott Wave, Ichimoku | $0.06 |
 | `forecast(symbol)` | AI 3-7 day price prediction | $0.005 |
 | `screener(type)` | Find coins by criteria (ichimoku-trend, rsi, vwap, volume, bounce-dip...) | $0.005 |

package/skill/references/endpoints.md

@@ -49,8 +49,10 @@ x402 automatic — $0.005 USDC per endpoint on Base mainnet ($0.01 for `/ai`)
 - `GET /api/galaxyscore/`
 - `GET /api/socialdominance/`
 - `GET /api/late-unlocked-coins/`
-- `GET /api/rsi/` — RSI heatmap
-- `GET /api/ao/` — Awesome Oscillator screener
+- `GET /api/rsi/`
+- `GET /api/ao/`
+- `GET /api/rsi-heatmap/`
+- `GET /api/indicator/today` — today's triggered ALSAT & indicator signals (TD9, AlphaTrend, etc.)
 
 ### Coin Info
 - `GET /api/coinstats/<symbol>` — market cap, volume, supply

package/src/indicator_guide.js

@@ -366,6 +366,34 @@ const GUIDE = {
       "BULLISH + confidence > 70% + ALSAT BUY = high-conviction long setup.",
   },
 
+  Indicator_Today: {
+    what_it_is:
+      "Today's triggered BUY/SELL signals from Asrai's signal tracking system. " +
+      "Two categories: alsat_signals (ALSAT cycle top/bottom signals) and indicator_signals " +
+      "(individual indicator signals: TD9, AlphaTrend, and others). " +
+      "Accessed via screener('indicator-today'). Shows only signals that fired today.",
+    key_fields: {
+      "alsat_signals[].symbol":   "Coin that triggered an ALSAT BUY or SELL today",
+      "alsat_signals[].signal":   "BUY | SELL",
+      "alsat_signals[].interval": "Timeframe the signal fired on (e.g. 1D, 4H)",
+      "alsat_signals[].price":    "Price at the time the signal fired",
+      "alsat_signals[].time":     "Exact timestamp the signal was recorded",
+      "indicator_signals[].symbol":    "Coin that triggered an indicator signal today",
+      "indicator_signals[].indicator": "Which indicator fired: TD9 | AlphaTrend | etc.",
+      "indicator_signals[].signal":    "BUY | SELL",
+      "indicator_signals[].interval":  "Timeframe (1D, 4H, 1W)",
+      "indicator_signals[].price":     "Price when signal fired",
+      "indicator_signals[].time":      "Exact timestamp",
+    },
+    how_to_interpret:
+      "alsat_signals BUY = ALSAT cycle bottom detected today — strong reversal candidate. " +
+      "alsat_signals SELL = ALSAT cycle top detected today — consider taking profit or shorting. " +
+      "indicator_signals TD9 BUY = Tom DeMark exhaustion bottom today — high-probability bounce. " +
+      "indicator_signals AlphaTrend BUY = trend just flipped bullish on this timeframe. " +
+      "Multiple signals on the same coin (ALSAT + TD9 + AlphaTrend) = highest conviction setup. " +
+      "Empty alsat_signals or indicator_signals = no signals fired today on that table — normal.",
+  },
+
   Market_Indicators: {
     what_it_is: "Reference for indicators returned by market_overview, sentiment, and screener tools.",
     indicators: {
@@ -383,6 +411,7 @@ const GUIDE = {
       cmc_sentiment: "CMC per-coin sentiment — bullish/bearish crowd reading",
       highvolumelowcap: "High volume + small cap = early mover potential, higher risk",
       bounce_dip: "Auto-detected dip-buy or bounce zones — best aligned with ALSAT BUY",
+      Indicator_Today: "Today's triggered signals. alsat_signals = ALSAT BUY/SELL fired today. indicator_signals = TD9/AlphaTrend/etc fired today. Access via screener('indicator-today')",
       ath: "Coins near all-time highs — momentum continuation or blow-off top risk",
       late_unlocked_coins: "Far-future vesting tokens — no near-term selling pressure, safer hold",
       cmcai: "CMC AI insights — explains why market is up/down, narratives, institutional flow",
@@ -431,6 +460,7 @@ const SUMMARY = {
   RSI: "Momentum 0-100. <30=oversold, >70=overbought. In ALSAT response as rsi + market_condition",
   CBBI: "Bitcoin cycle position 0-100. <10=bottom, >90=top. From sentiment() tool",
   Forecast: "AI 3-7 day prediction. Fields: direction, confidence (>70%=reliable), primary_target",
+  Indicator_Today: "Today's triggered signals. alsat_signals = ALSAT BUY/SELL fired today. indicator_signals = TD9/AlphaTrend/etc fired today. Access via screener('indicator-today')",
   Market_Indicators: "trending, gainers_losers, rsi_screener, sar_coins, macd_coins, emacross, techrating, vwap, galaxyscore, bounce_dip, cmcai",
   Support_Resistance: "Key levels. Fields: fib_0_618, ema.ema200, latest_high_pivot, trendline_breaks.current_support",
 };

package/src/tool-endpoints.js

@@ -52,6 +52,9 @@ export const TRADE_SIGNALS_ENDPOINTS = [
   "/api/bounce-dip/",
   "/api/sar-coins/",
   "/api/macd-coins/",
+  "/api/galaxyscore/",
+  "/api/rsi/",
+  "/api/indicator/today",
 ];
 
 // ── Dynamic endpoint builders (return arrays) ─────────────────────────────────
@@ -110,7 +113,7 @@ 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",
+  "ath", "rsi", "rsi-heatmap", "ao", "indicator-today",
 ];
 
 // ── Symbol normalisation ──────────────────────────────────────────────────────
@@ -186,7 +189,10 @@ export function createHandlers(_get, _gather) {
       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);
+      const path = screener_type === "indicator-today"
+        ? "/api/indicator/today"
+        : `/api/${screener_type}/`;
+      return JSON.stringify(await _get(path), null, 2);
     },
 
     async smart_money(symbol, timeframe = "1D") {

package/src/tools-definitions.js

@@ -89,9 +89,11 @@ export const TOOLS = [
   {
     name: "trade_signals",
     description:
-      "Get actionable trade setups: trending coins, top movers, bounce/dip candidates, SAR and MACD signals. " +
+      "Get actionable trade setups: trending coins, top movers, bounce/dip candidates, SAR, MACD, RSI signals, " +
+      "Galaxy Score, and today's triggered indicator & ALSAT signals from the database. " +
       "Combines momentum context with technical entry signals to find good position-opening opportunities. " +
-      "Use for: 'coins with good entry points', 'trade opportunity', 'coins with buy signals', 'trade setups'.",
+      "Use for: 'coins with good entry points', 'trade opportunity', 'coins with buy signals', 'trade setups', " +
+      "'which coins look good today', 'what should I trade'.",
     inputSchema: { type: "object", properties: {}, required: [] },
   },
   {
@@ -122,7 +124,9 @@ export const TOOLS = [
     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.",
+      "highvolumelowcap, bounce-dip, galaxyscore, socialdominance, late-unlocked-coins, ath, rsi, rsi-heatmap, ao. " +
+      "Use indicator-today ONLY when user asks what signals fired/triggered today in the database " +
+      "(e.g. 'today\\'s ALSAT signals', 'which indicators triggered today', 'today\\'s TD9/AlphaTrend signals').",
     inputSchema: {
       type: "object",
       properties: {
@@ -132,7 +136,7 @@ export const TOOLS = [
             "ichimoku-trend", "sar-coins", "macd-coins", "emacross",
             "techrating", "vwap", "volume", "highvolumelowcap",
             "bounce-dip", "galaxyscore", "socialdominance", "late-unlocked-coins",
-            "ath", "rsi", "rsi-heatmap", "ao",
+            "ath", "rsi", "rsi-heatmap", "ao", "indicator-today",
           ],
           description: "Type of screener to run",
         },
@@ -252,7 +256,7 @@ export const TOOLS = [
     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). " +
+      "(e.g. ALSAT, SuperALSAT, AlphaTrend, PMax, MavilimW, Indicator_Today). " +
       "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).",