asrai-mcp 1.2.1 → 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.2.1",
+  "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

@@ -36,6 +36,7 @@ Use Asrai tools when the user asks about crypto prices, market analysis, trading
 | "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.
 
@@ -103,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

@@ -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/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);
+}