asrai-mcp 0.7.0 → 1.0.1

package/README.md

@@ -55,22 +55,31 @@ Each API call costs **$0.005 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.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 |
+| `market_overview` | Full brief: trending, gainers/losers, RSI, screeners, sentiment, cashflow — use for complete reports only | $0.095 |
+| `trending` | Currently trending coins | $0.005 |
+| `gainers_losers` | Top gainers and losers | $0.005 |
+| `top_bottom` | RSI extremes, top/bottom signals, bounce/dip candidates | $0.015 |
+| `volume_spikes` | Coins with unusually high volume | $0.005 |
+| `high_volume_low_cap` | Low market cap coins with high volume | $0.005 |
+| `ath_tracker` | Coins near or at all-time high | $0.005 |
+| `dominance` | BTC & altcoin dominance signals | $0.01 |
+| `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 |
+| `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 |
+| `smart_money(symbol, timeframe)` | Order blocks, fair value gaps, support/resistance | $0.01 |
+| `elliott_wave(symbol, timeframe)` | Elliott Wave analysis | $0.005 |
+| `ichimoku(symbol, timeframe)` | Ichimoku cloud analysis | $0.005 |
+| `cashflow(mode, symbol)` | Capital flow data | $0.005 |
+| `coin_info(symbol)` | Stats, price, tags, CMC AI + auto DEX data | $0.025–$0.03 |
+| `dexscreener(contract)` | DEX trading data | $0.005 |
+| `chain_tokens(chain, max_mcap)` | Low-cap tokens on a specific chain | $0.005 |
+| `portfolio` | Abu's curated model portfolio — investment reference | $0.005 |
+| `ask_ai(question)` | AI analyst freeform answer | $0.01 |
+| `indicator_guide(name)` | Reference guide for Asrai-specific indicators | FREE |
 
 ## Spend limit
 

package/package.json

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

package/skill/SKILL.md

@@ -55,24 +55,35 @@ Requires `ASRAI_PRIVATE_KEY` set in `~/.env` or environment. Payment is signed a
 
 ## MCP tools
 
+
 | Tool | What it does | Cost |
 |---|---|---|
-| `market_overview` | Trending, gainers/losers, RSI, sentiment, screeners | $0.095 |
-| `technical_analysis(symbol, timeframe)` | Signals, ALSAT, SuperALSAT, Elliott Wave, Ichimoku | $0.06 |
-| `sentiment` | CBBI, CMC sentiment, AI insights | $0.015 |
-| `forecast(symbol)` | AI price forecast | $0.005 |
-| `screener(type)` | Find coins by criteria | $0.005 |
-| `smart_money(symbol, timeframe)` | Order blocks, FVGs, support/resistance | $0.01 |
+| `market_overview` | Full brief: trending, gainers/losers, RSI, screeners, sentiment, cashflow — use for complete reports only | $0.095 |
+| `trending` | Currently trending coins | $0.005 |
+| `gainers_losers` | Top gainers and losers | $0.005 |
+| `top_bottom` | RSI extremes, top/bottom signals, bounce/dip candidates | $0.015 |
+| `volume_spikes` | Coins with unusually high volume | $0.005 |
+| `high_volume_low_cap` | Low market cap coins with high volume | $0.005 |
+| `ath_tracker` | Coins near or at all-time high | $0.005 |
+| `dominance` | BTC & altcoin dominance signals | $0.01 |
+| `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 |
+| `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 |
+| `smart_money(symbol, timeframe)` | Order blocks, fair value gaps, support/resistance | $0.01 |
 | `elliott_wave(symbol, timeframe)` | Elliott Wave analysis | $0.005 |
-| `ichimoku(symbol, timeframe)` | Ichimoku cloud | $0.005 |
-| `cashflow(mode, symbol)` | Capital flow | $0.005 |
-| `coin_info(symbol)` | Stats, price, CMC AI, DEX data | $0.025–$0.03 |
-| `dexscreener(contract)` | DEX data | $0.005 |
-| `chain_tokens(chain, max_mcap)` | Low-cap tokens on chain | $0.005 |
-| `portfolio` | Abu's curated model portfolio | $0.005 |
-| `channel_summary` | Latest narratives | $0.005 |
-| `ask_ai(question)` | AI analyst answer | $0.01 |
-| `indicator_guide(name)` | Guide for custom indicators | FREE |
+| `ichimoku(symbol, timeframe)` | Ichimoku cloud analysis | $0.005 |
+| `cashflow(mode, symbol)` | Capital flow data | $0.005 |
+| `coin_info(symbol)` | Stats, price, tags, CMC AI + auto DEX data | $0.025–$0.03 |
+| `dexscreener(contract)` | DEX trading data | $0.005 |
+| `chain_tokens(chain, max_mcap)` | Low-cap tokens on a specific chain | $0.005 |
+| `portfolio` | Abu's curated model portfolio — investment reference | $0.005 |
+| `ask_ai(question)` | AI analyst freeform answer | $0.01 |
+| `indicator_guide(name)` | Reference guide for Asrai-specific indicators | FREE |
+
 
 ## Output rules
 

package/src/tool-endpoints.js

@@ -35,6 +35,23 @@ export const SENTIMENT_ENDPOINTS = [
   "/api/cbbi/",
   "/api/cmc-sentiment/",
   "/api/cmcai/",
+  "/api/channel-summary/",
+  "/api/galaxyscore/",
+  "/api/socialdominance/",
+];
+
+export const TOP_BOTTOM_ENDPOINTS = [
+  "/api/rsi/",
+  "/api/top-bottom/",
+  "/api/bounce-dip/",
+];
+
+export const TRADE_SIGNALS_ENDPOINTS = [
+  "/api/trending/",
+  "/api/gainers-losers/",
+  "/api/bounce-dip/",
+  "/api/sar-coins/",
+  "/api/macd-coins/",
 ];
 
 // ── Dynamic endpoint builders (return arrays) ─────────────────────────────────
@@ -73,6 +90,20 @@ export function coinInfoEndpoints(s) {
   ];
 }
 
+export function dominanceEndpoints() {
+  return [
+    "/api/signal/btc.d/1D",
+    "/api/signal/others.d/1D",
+  ];
+}
+
+export function macroEndpoints() {
+  return [
+    "/api/signal/spx/1D",
+    "/api/signal/ndq/1D",
+  ];
+}
+
 // ── Screener valid types ──────────────────────────────────────────────────────
 
 export const SCREENER_TYPES = [
@@ -98,15 +129,55 @@ export function createHandlers(_get, _gather) {
       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 trending() {
+      return JSON.stringify(await _get("/api/trending/"), null, 2);
+    },
+
+    async gainers_losers() {
+      return JSON.stringify(await _get("/api/gainers-losers/"), null, 2);
+    },
+
+    async top_bottom() {
+      return JSON.stringify(await _gather(...TOP_BOTTOM_ENDPOINTS), null, 2);
+    },
+
+    async volume_spikes() {
+      return JSON.stringify(await _get("/api/volume/"), null, 2);
+    },
+
+    async high_volume_low_cap() {
+      return JSON.stringify(await _get("/api/highvolumelowcap/"), null, 2);
+    },
+
+    async ath_tracker() {
+      return JSON.stringify(await _get("/api/ath/"), null, 2);
+    },
+
+    async dominance() {
+      return JSON.stringify(await _gather(...dominanceEndpoints()), null, 2);
+    },
+
+    async macro() {
+      return JSON.stringify(await _gather(...macroEndpoints()), null, 2);
     },
 
     async sentiment() {
       return JSON.stringify(await _gather(...SENTIMENT_ENDPOINTS), null, 2);
     },
 
+    async late_unlocked_coins() {
+      return JSON.stringify(await _get("/api/late-unlocked-coins/"), null, 2);
+    },
+
+    async trade_signals() {
+      return JSON.stringify(await _gather(...TRADE_SIGNALS_ENDPOINTS), null, 2);
+    },
+
+    async technical_analysis(symbol, timeframe = "1D") {
+      const s = sym(symbol);
+      return JSON.stringify(await _gather(...technicalAnalysisEndpoints(s, timeframe)), null, 2);
+    },
+
     async forecast(symbol) {
       return JSON.stringify(await _get(`/api/forecasting/${sym(symbol)}usdt`), null, 2);
     },
@@ -166,9 +237,5 @@ export function createHandlers(_get, _gather) {
       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

@@ -9,14 +9,95 @@ 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'.",
+      "Full broad market brief: trending, gainers/losers, RSI, cashflow, sentiment, screeners, volume. " +
+      "Use ONLY when a complete market overview is requested (e.g. 'give me a full market brief', 'morning report'). " +
+      "For single-topic questions use the specific granular tools instead.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "trending",
+    description:
+      "Get currently trending coins. " +
+      "Use for: 'what's trending', 'what's hot right now', 'which coins are trending'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "gainers_losers",
+    description:
+      "Get top gainers and losers. " +
+      "Use for: 'biggest movers today', 'top gainers', 'what pumped/dumped'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "top_bottom",
+    description:
+      "Get RSI extremes, top/bottom signals, and bounce/dip candidates. " +
+      "Use for: 'overbought/oversold coins', 'dip opportunities', 'bounce candidates', 'RSI extremes'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "volume_spikes",
+    description:
+      "Get coins with unusually high volume. " +
+      "Use for: 'high volume coins', 'volume anomalies', 'volume spikes today'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "high_volume_low_cap",
+    description:
+      "Get low market cap coins with high volume (hidden gems). " +
+      "Use for: 'low cap movers', 'hidden gems', 'small caps with volume'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "ath_tracker",
+    description:
+      "Get coins near or at their all-time high. " +
+      "Use for: 'coins near ATH', 'all-time high coins', 'breaking ATH'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "dominance",
+    description:
+      "Get BTC dominance and altcoin dominance signals. " +
+      "Use for: 'BTC dominance', 'altseason?', 'is alt season coming', 'dominance trend'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "macro",
+    description:
+      "Get S&P 500 and Nasdaq signals to understand global market context. " +
+      "Use for: 'global market mood', 'S&P/Nasdaq today', 'risk-on/risk-off', 'macro situation', 'traditional markets'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "sentiment",
+    description:
+      "Get full market sentiment: CBBI cycle index, CMC sentiment, CMC AI market insights, " +
+      "channel news summaries, Galaxy Score, and social dominance. " +
+      "Use for: 'market mood', 'fear/greed', 'cycle position', 'social buzz', 'what are people saying', " +
+      "'crypto news', 'social reactions', 'community sentiment'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "late_unlocked_coins",
+    description:
+      "Get coins with recent vesting unlocks that have low remaining selling pressure. " +
+      "Use for: 'less selling pressure', 'post-unlock coins', 'vesting unlocks', 'which coins finished unlocking'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
+  {
+    name: "trade_signals",
+    description:
+      "Get actionable trade setups: trending coins, top movers, bounce/dip candidates, SAR and MACD signals. " +
+      "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'.",
     inputSchema: { type: "object", properties: {}, required: [] },
   },
   {
     name: "technical_analysis",
     description:
-      "Get full technical analysis for a specific coin: signal, ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend. " +
+      "Get full technical analysis for a specific coin: signal, ALSAT (top and bottom), SuperALSAT (approved top and bottom), PSAR, MACD-DEMA, AlphaTrend (trend indicator), Elliot Wave , TD(trend reversal  tom demark), SMC(Smart money), SR(support and resistance), Ichimoku " +
       "Use when asked about TA, buy/sell signals, or indicators for a coin.",
     inputSchema: {
       type: "object",
@@ -27,13 +108,6 @@ export const TOOLS = [
       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.",
@@ -173,11 +247,6 @@ export const TOOLS = [
       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: