asrai-mcp 0.5.8 → 0.7.0

package/bin/asrai.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * asrai CLI — call any Asrai tool from bash.
+ *
+ * Usage:
+ *   npx -y -p asrai-mcp asrai <tool> [args...]
+ *
+ * Examples:
+ *   npx -y -p asrai-mcp asrai ask_ai "What is the BTC outlook?"
+ *   npx -y -p asrai-mcp asrai technical_analysis BTC 4h
+ *   npx -y -p asrai-mcp asrai sentiment
+ *   npx -y -p asrai-mcp asrai forecast ETH
+ *   npx -y -p asrai-mcp asrai market_overview
+ *   npx -y -p asrai-mcp asrai coin_info SOL
+ *   npx -y -p asrai-mcp asrai screener ath
+ *   npx -y -p asrai-mcp asrai smart_money BTC 1d
+ *   npx -y -p asrai-mcp asrai elliott_wave BTC 4h
+ *   npx -y -p asrai-mcp asrai cashflow market
+ *   npx -y -p asrai-mcp asrai portfolio
+ *   npx -y -p asrai-mcp asrai channel_summary
+ *   npx -y -p asrai-mcp asrai indicator_guide ALSAT
+ *
+ * Requires ASRAI_PRIVATE_KEY in ~/.env or environment.
+ */
+
+import { config } from 'dotenv';
+import { homedir } from 'os';
+import { join } from 'path';
+
+config({ path: join(homedir(), '.env') });
+config();
+
+const key = process.env.ASRAI_PRIVATE_KEY?.trim();
+
+const [,, tool, ...args] = process.argv;
+
+if (!tool) {
+  console.error('Usage: asrai <tool> [args...]');
+  console.error('Tools: ask_ai, technical_analysis, sentiment, forecast, market_overview,');
+  console.error('       coin_info, screener, smart_money, elliott_wave, ichimoku, cashflow,');
+  console.error('       dexscreener, chain_tokens, portfolio, channel_summary, indicator_guide');
+  process.exit(1);
+}
+
+// indicator_guide is free — no key needed
+if (tool !== 'indicator_guide' && !key) {
+  console.error('Error: ASRAI_PRIVATE_KEY is not set. Add it to ~/.env');
+  process.exit(1);
+}
+
+import * as tools from '../src/tools.js';
+import { indicator_guide } from '../src/indicator_guide.js';
+
+const allTools = { ...tools, indicator_guide };
+const fn = allTools[tool];
+if (!fn) {
+  console.error(`Unknown tool: ${tool}`);
+  console.error('Run "asrai" with no arguments to see available tools.');
+  process.exit(1);
+}
+
+let result;
+try {
+  result = await fn(...args);
+} catch (err) {
+  console.error(`Error: ${err.message}`);
+  process.exit(1);
+}
+
+console.log(typeof result === 'string' ? result : JSON.stringify(result, null, 2));

package/bin/install-skill.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * asrai-mcp install-skill
+ *
+ * Auto-installs SKILL.md to detected agent directories.
+ * Supports: OpenClaw, Cursor/Cline/.agents/skills, manual fallback.
+ *
+ * Usage:
+ *   npx -y -p asrai-mcp install-skill
+ */
+
+import { existsSync, mkdirSync, copyFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const home = homedir();
+
+// Files bundled inside this package
+const SKILL_SRC = join(__dirname, '..', 'skill', 'SKILL.md');
+const ENDPOINTS_SRC = join(__dirname, '..', 'skill', 'references', 'endpoints.md');
+
+// Candidate install paths
+const candidates = [
+  {
+    name: 'OpenClaw',
+    path: join(home, '.openclaw', 'workspace', 'skills', 'asrai'),
+    detect: join(home, '.openclaw', 'workspace', 'skills'),
+  },
+  {
+    name: 'OpenClaw (alt)',
+    path: join(home, '.openclaw', 'skills', 'asrai'),
+    detect: join(home, '.openclaw', 'skills'),
+  },
+  {
+    name: 'agents/skills (local)',
+    path: join(process.cwd(), '.agents', 'skills', 'asrai'),
+    detect: join(process.cwd(), '.agents', 'skills'),
+  },
+  {
+    name: 'agents/skills (home)',
+    path: join(home, '.agents', 'skills', 'asrai'),
+    detect: join(home, '.agents', 'skills'),
+  },
+];
+
+function installTo(destDir, label) {
+  mkdirSync(join(destDir, 'references'), { recursive: true });
+  copyFileSync(SKILL_SRC, join(destDir, 'SKILL.md'));
+  copyFileSync(ENDPOINTS_SRC, join(destDir, 'references', 'endpoints.md'));
+  console.log(`✓ Installed to ${label}: ${destDir}`);
+}
+
+let installed = 0;
+
+for (const c of candidates) {
+  if (existsSync(c.detect)) {
+    installTo(c.path, c.name);
+    installed++;
+  }
+}
+
+if (installed === 0) {
+  console.log('No agent skills directory detected automatically.\n');
+  console.log('Manual install options:');
+  console.log('  OpenClaw:');
+  console.log(`    mkdir -p ~/.openclaw/workspace/skills/asrai/references`);
+  console.log(`    cp ${SKILL_SRC} ~/.openclaw/workspace/skills/asrai/SKILL.md`);
+  console.log(`    cp ${ENDPOINTS_SRC} ~/.openclaw/workspace/skills/asrai/references/endpoints.md`);
+  console.log('');
+  console.log('  Or clone the skill repo directly:');
+  console.log('    git clone https://github.com/abuzerasr/asrai-skill.git ~/.openclaw/workspace/skills/asrai');
+} else {
+  console.log('\nDone. Restart your agent or run "refresh skills" to activate asrai.');
+  console.log('\nNext: set ASRAI_PRIVATE_KEY in ~/.env');
+  console.log('  echo "ASRAI_PRIVATE_KEY=0x<your_key>" >> ~/.env');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asrai-mcp",
-  "version": "0.5.8",
+  "version": "0.7.0",
   "description": "Asrai crypto analysis MCP server — pay-per-use via x402 on Base. Zero install: just npx.",
   "keywords": [
     "mcp",
@@ -19,11 +19,14 @@
   "type": "module",
   "bin": {
     "asrai-mcp": "./bin/asrai-mcp.js",
-    "asrai-mcp-server": "./bin/asrai-mcp-server.js"
+    "asrai-mcp-server": "./bin/asrai-mcp-server.js",
+    "asrai": "./bin/asrai.js",
+    "install-skill": "./bin/install-skill.js"
   },
   "files": [
     "bin/",
     "src/",
+    "skill/",
     "README.md"
   ],
   "engines": {

package/skill/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: asrai-x402
+description: Crypto market analysis using Asrai API. Covers technical analysis, screeners, sentiment, forecasting, smart money, Elliott Wave, cashflow, DEX data, and AI-powered insights. Each API call costs $0.005 USDC from your own wallet on Base mainnet via x402.
+license: MIT
+metadata: {"openclaw":{"emoji":"📈","requires":{"env":["ASRAI_PRIVATE_KEY"]}},"clawdbot":{"emoji":"📈","requires":{"env":["ASRAI_PRIVATE_KEY"]}}}
+---
+
+# Asrai — Crypto Analysis via x402
+
+Use Asrai tools when the user asks about crypto prices, market analysis, trading signals, sentiment, or investment advice.
+
+## When to use
+
+- 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
+- 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)
+
+## How to call
+
+### If asrai MCP tools are available (Cursor, Cline, Claude Desktop)
+
+Call the appropriate MCP tool directly:
+```
+technical_analysis(symbol, timeframe)
+sentiment()
+forecast(symbol)
+market_overview()
+ask_ai(question)
+...
+```
+
+### If no MCP tool — use bash (OpenClaw and other agents)
+
+Use the same tool names via bash:
+```bash
+npx -y -p asrai-mcp asrai <tool> [args...]
+```
+
+Examples:
+```bash
+npx -y -p asrai-mcp asrai ask_ai "What is the outlook for BTC today?"
+npx -y -p asrai-mcp asrai technical_analysis BTC 4h
+npx -y -p asrai-mcp asrai sentiment
+npx -y -p asrai-mcp asrai forecast ETH
+npx -y -p asrai-mcp asrai market_overview
+npx -y -p asrai-mcp asrai coin_info SOL
+npx -y -p asrai-mcp asrai portfolio
+npx -y -p asrai-mcp asrai indicator_guide ALSAT
+```
+
+Requires `ASRAI_PRIVATE_KEY` set in `~/.env` or environment. Payment is signed automatically.
+
+## 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 |
+| `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 |
+
+## Output rules
+
+- Write like an experienced trader explaining to a friend — conversational, confident, direct
+- Think like both a trader AND a long-term investor. Default to investor mode. Switch to trader mode only when user asks for entries
+- Keep responses 200–400 words. Short lines, breathing room between sections
+- Never list raw indicator values — synthesize into plain language verdict
+- End with 1 clear action bias: accumulate / wait / avoid — and why
+- Never mention tool names, API calls, or payment details in responses
+
+## Cost
+
+$0.005 USDC per call (most tools), $0.01 for `ask_ai`, FREE for `indicator_guide`. Signed from the user's own wallet on Base mainnet. Tell the user if they ask.

package/skill/references/endpoints.md

@@ -0,0 +1,82 @@
+# Asrai x402 Endpoints
+
+## Base URL
+`https://x402.asrai.me`
+
+## Payment
+x402 automatic — $0.005 USDC per endpoint on Base mainnet ($0.01 for `/ai`)
+
+## Endpoint Catalog
+
+### Market Pulse
+- `GET /api/trending/` — trending coins
+- `GET /api/gainers-losers/` — top gainers and losers
+- `GET /api/rsi/` — RSI extremes (overbought/oversold)
+- `GET /api/top-bottom/` — top/bottom signals
+- `GET /api/ath/` — coins near all-time high
+- `GET /api/channel-summary/` — latest narratives from monitored channels
+
+### Sentiment
+- `GET /api/cbbi/` — Bitcoin cycle index
+- `GET /api/cmc-sentiment/` — CMC market sentiment
+- `GET /api/cmcai/` — CMC AI insights
+- `GET /api/cmcai/<symbol>` — CMC AI for specific coin
+
+### Technical Signals (single coin)
+- `GET /api/signal/<symbol>usdt/1D|4H|1W` — buy/sell signal
+- `GET /api/alsat/<symbol>usdt/1D|4H|1W` — ALSAT indicator
+- `GET /api/superalsat/<symbol>usdt` — SuperALSAT
+- `GET /api/alphatrend/<symbol>usdt/1D|4H|1W` — AlphaTrend
+- `GET /api/psar/<symbol>usdt/1D|4H|1W` — Parabolic SAR
+- `GET /api/macd-dema/<symbol>usdt/1D|4H|1W` — MACD + DEMA
+- `GET /api/td/<symbol>usdt/1D|4H|1W` — Tom DeMark sequential
+- `GET /api/ichimoku/<symbol>usdt/1D|4H|1W` — Ichimoku cloud
+- `GET /api/ew/<symbol>usdt/1D|4H|1W` — Elliott Wave
+- `GET /api/smartmoney/<symbol>usdt/1D|4H|1W` — SMC (order blocks, FVG, BOS)
+- `GET /api/support-resistance/<symbol>usdt/1D|4H|1W` — support/resistance levels
+- `GET /api/forecasting/<symbol>usdt` — AI price forecast
+
+### Screeners
+- `GET /api/ichimoku-trend/`
+- `GET /api/sar-coins/`
+- `GET /api/macd-coins/`
+- `GET /api/emacross/`
+- `GET /api/techrating/`
+- `GET /api/vwap/`
+- `GET /api/volume/`
+- `GET /api/highvolumelowcap/`
+- `GET /api/bounce-dip/`
+- `GET /api/galaxyscore/`
+- `GET /api/socialdominance/`
+- `GET /api/late-unlocked-coins/`
+- `GET /api/rsi/` — RSI heatmap
+- `GET /api/ao/` — Awesome Oscillator screener
+
+### Coin Info
+- `GET /api/coinstats/<symbol>` — market cap, volume, supply
+- `GET /api/info/<symbol>` — project info
+- `GET /api/price/<symbol>` — current price
+- `GET /api/tags/<symbol>` — coin tags/categories
+
+### Cashflow
+- `GET /api/cashflow/market` — market-wide capital flow
+- `GET /api/cashflow/coin/<symbol>` — flow for one coin
+- `GET /api/cashflow/group/<symbols_csv>` — flow for group of coins
+
+### Chain / DEX
+- `GET /api/dexscreener/<contract_address>` — DEX data by contract
+- `GET /api/dexscreener/<chain>/<contract_address>` — DEX data by chain + contract
+- `GET /api/chain/<chain>/<max_mcap>` — low-cap tokens on a chain
+
+### Portfolio
+- `GET /api/portfolio/` — full portfolio
+- `GET /api/portfolio/<symbol>` — portfolio for specific coin
+
+### AI
+- `POST /ai` body: `{"message": "<question>"}` — AI analyst ($0.01)
+
+## Macro signals
+- `GET /api/signal/btc.d/1D` — BTC dominance
+- `GET /api/signal/others.d/1D` — altcoin dominance
+- `GET /api/signal/spx/1D` — S&P 500
+- `GET /api/signal/ndq/1D` — Nasdaq

package/src/server.js

@@ -71,7 +71,7 @@ async function handleTool(name, args) {
 export function createServer() {
   const server = new Server(
     { name: "asrai", version: "0.5.5" },
-    { capabilities: { tools: {} }, requestHandlerTimeout: 120_000 }
+    { capabilities: { tools: {} } }
   );
 
   server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));

package/src/tools.js

@@ -78,13 +78,13 @@ async function _post(path, body) {
 }
 
 async function _gather(...paths) {
-  // Sequential — parallel x402 payments from same wallet can conflict
-  const results = {};
-  for (const path of paths) {
-    try { results[path] = await _get(path); }
-    catch (e) { results[path] = String(e); }
-  }
-  return results;
+  const entries = await Promise.all(
+    paths.map(async (path) => {
+      try { return [path, await _get(path)]; }
+      catch (e) { return [path, String(e)]; }
+    })
+  );
+  return Object.fromEntries(entries);
 }
 
 // ── Shared handlers (from tool-endpoints.js) ──────────────────────────────────