asrai-mcp 1.1.0 → 1.3.0

package/README.md

@@ -79,8 +79,47 @@ Each API call costs **$0.005 USDC** from your wallet on Base mainnet. Make sure
 | `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 |
+| `positions` | Your live open positions across connected exchanges (MEXC, Binance, Lighter) — requires exchange keys configured via /exchange_apis in Telegram | $0.005–$0.015 |
 | `indicator_guide(name)` | Reference guide for Asrai-specific indicators | FREE |
 
+## Exchange positions (`positions` tool)
+
+To use the `positions` tool, add your exchange API keys to `~/.env`:
+
+```
+# MEXC
+MEXC_API_KEY=mx0vgl...
+MEXC_SECRET_KEY=your_secret...
+
+# Binance
+BINANCE_API_KEY=your_api_key...
+BINANCE_SECRET_KEY=your_secret...
+
+# Lighter
+LIGHTER_L1_ADDRESS=0x...
+LIGHTER_API_PRIVATE_KEY=0x...
+```
+
+Or pass them in the Claude Desktop config `env` block:
+
+```json
+{
+  "mcpServers": {
+    "asrai": {
+      "command": "npx",
+      "args": ["-y", "asrai-mcp@latest"],
+      "env": {
+        "ASRAI_PRIVATE_KEY": "0x<your_base_wallet_private_key>",
+        "MEXC_API_KEY": "mx0vgl...",
+        "MEXC_SECRET_KEY": "your_secret..."
+      }
+    }
+  }
+}
+```
+
+Only configure the exchanges you use — the tool auto-detects which keys are set and fetches only those.
+
 ## Spend limit
 
 Default session cap: **$2.00 USDC**. To change:

package/bin/asrai.js

@@ -38,7 +38,8 @@ 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');
+  console.error('       dexscreener, chain_tokens, portfolio, channel_summary, indicator_guide,');
+  console.error('       positions  (requires MEXC_API_KEY, BINANCE_API_KEY, or LIGHTER_L1_ADDRESS in ~/.env)');
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asrai-mcp",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "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,33 @@ 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` |
+| "my positions" / "open trades" / "my PnL" / "what am I trading" | `positions` | — |
+
+**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)
@@ -82,8 +104,28 @@ Requires `ASRAI_PRIVATE_KEY` set in `~/.env` or environment. Payment is signed a
 | `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 |
+| `positions` | Your live open positions across connected exchanges (MEXC, Binance, Lighter) — requires exchange keys configured via /exchange_apis in Telegram | $0.005–$0.015 |
 | `indicator_guide(name)` | Reference guide for Asrai-specific indicators | FREE |
 
+## Exchange positions setup
+
+To use the `positions` tool, add exchange API keys to `~/.env`:
+
+```
+# MEXC
+MEXC_API_KEY=mx0vgl...
+MEXC_SECRET_KEY=your_secret...
+
+# Binance
+BINANCE_API_KEY=your_api_key...
+BINANCE_SECRET_KEY=your_secret...
+
+# Lighter
+LIGHTER_L1_ADDRESS=0x...
+LIGHTER_API_PRIVATE_KEY=0x...
+```
+
+Only configure the exchanges you use — tool auto-detects which keys are set.
 
 🎨 Output Style — Human-Friendly Format
 

package/skill/references/endpoints.md

@@ -52,7 +52,7 @@ x402 automatic — $0.005 USDC per endpoint on Base mainnet ($0.01 for `/ai`)
 - `GET /api/rsi/`
 - `GET /api/ao/`
 - `GET /api/rsi-heatmap/`
-- `GET /api/indicator/today` — today's triggered ALSAT & indicator signals (TD9, AlphaTrend, etc.) — today's triggered ALSAT & indicator signals (TD9, AlphaTrend, etc.)
+- `GET /api/indicator/today` — today's triggered ALSAT & indicator signals (TD9, AlphaTrend, etc.)
 
 ### Coin Info
 - `GET /api/coinstats/<symbol>` — market cap, volume, supply
@@ -74,6 +74,11 @@ x402 automatic — $0.005 USDC per endpoint on Base mainnet ($0.01 for `/ai`)
 - `GET /api/portfolio/` — full portfolio
 - `GET /api/portfolio/<symbol>` — portfolio for specific coin
 
+### Exchange Positions
+- `GET /api/exchange/<exchange>/<api_key>/<secret_key>` — live positions for exchange (`mexc`, `binance`, `lighter`)
+  - Keys read from `~/.env` automatically: `MEXC_API_KEY`, `MEXC_SECRET_KEY`, `BINANCE_API_KEY`, `BINANCE_SECRET_KEY`, `LIGHTER_L1_ADDRESS`, `LIGHTER_API_PRIVATE_KEY`
+  - Returns: account info, open positions, unrealized PnL, leverage, margin, liquidation price
+
 ### AI
 - `POST /ai` body: `{"message": "<question>"}` — AI analyst ($0.01)
 

package/src/indicator_guide.js

@@ -411,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",

package/src/tools-definitions.js

@@ -251,6 +251,15 @@ export const TOOLS = [
       required: [],
     },
   },
+  {
+    name: "positions",
+    description:
+      "Get your live open positions across connected exchanges (MEXC, Binance, Lighter). " +
+      "Shows entry price, mark price, unrealized PnL, leverage, margin, and liquidation price for each position. " +
+      "Requires exchange API keys to be configured — add them via /exchange_apis in the Asrai Telegram bot. " +
+      "Use when asked: 'show my positions', 'what am I trading', 'my open trades', 'my PnL', 'my exchange positions'.",
+    inputSchema: { type: "object", properties: {}, required: [] },
+  },
   {
     name: "indicator_guide",
     description:

package/src/tools.js

@@ -102,3 +102,41 @@ export const {
 export async function ask_ai(question) {
   return JSON.stringify(await _post("/ai", { message: question }), null, 2);
 }
+
+// ── positions — fetch live exchange positions from env-configured keys ─────────
+
+export async function positions() {
+  const exchanges = [
+    {
+      name: "mexc",
+      api_key:    process.env.MEXC_API_KEY,
+      secret_key: process.env.MEXC_SECRET_KEY,
+    },
+    {
+      name: "binance",
+      api_key:    process.env.BINANCE_API_KEY,
+      secret_key: process.env.BINANCE_SECRET_KEY,
+    },
+    {
+      name: "lighter",
+      api_key:    process.env.LIGHTER_L1_ADDRESS,
+      secret_key: process.env.LIGHTER_API_PRIVATE_KEY,
+    },
+  ].filter(e => e.api_key && e.secret_key);
+
+  if (exchanges.length === 0) {
+    return JSON.stringify({ error: "No exchange keys configured. Set MEXC_API_KEY/MEXC_SECRET_KEY, BINANCE_API_KEY/BINANCE_SECRET_KEY, or LIGHTER_L1_ADDRESS/LIGHTER_API_PRIVATE_KEY in your ~/.env" });
+  }
+
+  const results = {};
+  await Promise.allSettled(exchanges.map(async ({ name, api_key, secret_key }) => {
+    try {
+      const data = await _get(`/api/exchange/${encodeURIComponent(name)}/${encodeURIComponent(api_key)}/${encodeURIComponent(secret_key)}`);
+      results[name] = data;
+    } catch (err) {
+      results[name] = { error: err.message };
+    }
+  }));
+
+  return JSON.stringify(results, null, 2);
+}