asterdex-mcp-server

56-tool MCP server for Aster DEX perpetual futures trading

A comprehensive Model Context Protocol server that gives Claude (and any MCP-compatible AI) full access to Aster DEX perpetual futures — from real-time market data and institutional-grade analysis to live order execution and automated strategies.

Why This Exists

Most DEX integrations are thin API wrappers. This server includes the analytical layer that makes the data actionable:

| Capability | This Server | Basic Wrappers | |---|---|---| | VPVR (Volume Profile) | POC, VAH, VAL, VWAP, Delta | — | | Cross-Exchange Analysis | Aster vs Hyperliquid vs Binance | — | | Pump / Breakout Detection | MFI, StochRSI, OBV, structural scoring | — | | Market Regime Detection | BTC EMA/RSI regime with confidence band | — | | Binance Flow Signals | OI history, top-trader positioning, taker flow | — | | Accumulation Detection | Pre-move institutional signals | — | | Strategy Automation | Funding farm, grid, pump strategies | — | | Spot + Perps | Both markets, transfers between | — | | QFL Base Signals | CryptoBaseScanner integration | — | | Scale Grid Engine | Multi-level grid with risk management | — |

Tools Reference (56 total)

Market Data

| Tool | Description | |---|---| | get_market_data | Price, ticker, orderbook, funding rates, exchange info | | get_klines | Historical candlestick data | | get_recent_trades | Recent public trades | | scan_markets | Scan all markets sorted by volume, funding, change, OI, or spread | | get_market_intelligence | Comprehensive report: top gainers, losers, volume leaders, funding opportunities |

Perpetual Trading

| Tool | Description | |---|---| | execute_order | Market/limit orders with TP/SL and trailing stops | | manage_orders | Cancel orders, batch place, set auto-cancel timer | | calculate_position_size | Risk-based position sizing from account balance | | panic_button | Emergency close all positions and cancel all orders |

Spot Trading

| Tool | Description | |---|---| | get_spot_market_data | Spot prices, tickers, orderbook, trading pairs | | get_spot_klines | Spot candlestick data | | get_spot_trades | Recent spot trades | | get_spot_account | Balances, open orders, order history, trade history | | execute_spot_order | Market buy/sell or limit orders | | cancel_spot_order | Cancel single or all spot orders | | spot_transfer | Transfer assets between spot and perpetuals wallet |

Account & Risk

| Tool | Description | |---|---| | get_account_info | Balance, positions, orders, ADL risk, liquidation history, PnL, leverage brackets | | manage_credentials | Set/clear API credentials at runtime |

Volume Profile Analytics

| Tool | Description | |---|---| | vpvr_analysis | Full VPVR: POC, VAH, VAL, VWAP, delta, HVN/LVN nodes | | vpvr_cross | Side-by-side VPVR comparison: Aster vs Hyperliquid | | deep_analysis | VPVR + orderbook depth at key levels + BTC correlation + session context | | obv_analysis | Multi-timeframe OBV trends and price/OBV divergences (5m/15m/1h/4h) |

Scanners

| Tool | Description | |---|---| | scan_for_pumps | Early pump signals: volume spikes, MFI, StochRSI (Aster) | | scan_for_pumps_hl | Same scan on Hyperliquid | | scan_for_pumps_cross | Cross-exchange comparison — pairs flagged on both = highest conviction | | scan_breakouts | Structural breakout detection with VPVR-based scoring | | scan_momentum | Active momentum: coins already pumping or dumping with force | | scan_liquidity | Trade tape analysis: liquidity health, bot patterns, tradeability scoring | | scan_oi_divergence | OI vs price divergence: accumulation/distribution signals |

Binance Intelligence

| Tool | Description | |---|---| | get_market_regime | BTC market regime: bullish/bearish/neutral with confidence score | | get_binance_sentiment | Top trader L/S ratio, global L/S ratio, taker buy/sell volume | | get_binance_oi_history | Open interest history — trend over time | | get_binance_funding | Binance funding rates (compare with Aster for arbitrage) | | compare_exchange_volume | Volume, price, OI comparison between Aster and Binance | | scan_exchange_divergence | Find pairs where Binance and Aster diverge significantly | | scan_accumulation | Pre-move institutional signals using OI velocity, funding, taker flow | | scan_funding_extremes | Extreme funding rates — squeeze potential detection | | scan_binance_signals | Primary scanner: institutional-grade signals using Binance as data oracle |

QFL Base Signals (CryptoBaseScanner)

| Tool | Description | |---|---| | get_cbs_signals | Active QFL base cracks — prime buying opportunities | | get_cbs_markets | Markets approaching their base level | | get_cbs_quick_scan | Recent price drops (5-30 min) for fast moves | | compare_cbs_algorithms | Compare original/day_trade/conservative/position algorithms for one symbol |

Strategy Automation

| Tool | Description | |---|---| | manage_strategy | Control funding farm and grid trading strategies | | start_strategy | Start the automated pump strategy engine | | stop_strategy | Stop strategy with optional position close | | get_strategy_status | Current strategy state and open positions | | update_strategy_config | Modify parameters while running | | close_strategy_position | Close a specific strategy-managed position |

Scale Grid Engine

| Tool | Description | |---|---| | grid_preview | Preview grid levels before committing capital | | grid_start | Start a scale grid with custom parameters | | grid_status | Current grid state, levels, PnL | | grid_adjust | Modify TP and risk parameters while running | | grid_pause | Pause grid without closing positions | | grid_resume | Resume a paused grid | | grid_close | Close grid and optionally the underlying position |

Infrastructure

| Tool | Description | |---|---| | manage_stream | WebSocket stream control (start, stop, status, collect events) | | manage_cache | Cache management — scan, retrieve, clear, load |

Installation

Prerequisites

Node.js 20+
pnpm (npm install -g pnpm)
Aster DEX account with API key (get one here)

Clone and build

git clone https://github.com/tyranosurasmax/asterdex-mcp-server.git
cd asterdex-mcp-server
pnpm install
pnpm run build

Configure credentials

cp .env.example .env
# Edit .env with your Aster API key and secret

Setup with Claude

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "aster": {
      "command": "node",
      "args": ["/path/to/asterdex-mcp-server/dist/mcp-server.js"],
      "env": {
        "ASTER_API_KEY": "your_key",
        "ASTER_API_SECRET": "your_secret"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add aster -- node /path/to/asterdex-mcp-server/dist/mcp-server.js

Or add to .mcp.json in your project:

{
  "mcpServers": {
    "aster": {
      "command": "node",
      "args": ["/path/to/asterdex-mcp-server/dist/mcp-server.js"],
      "env": {
        "ASTER_API_KEY": "your_key",
        "ASTER_API_SECRET": "your_secret"
      }
    }
  }
}

OpenCode

Add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "aster": {
      "type": "local",
      "command": ["node", "/path/to/asterdex-mcp-server/dist/mcp-server.js"],
      "env": {
        "ASTER_API_KEY": "your_key",
        "ASTER_API_SECRET": "your_secret"
      }
    }
  }
}

Usage Examples

Once connected, ask Claude naturally:

What's the current BTC funding rate on Aster vs Hyperliquid?

Run VPVR analysis on ETHUSDT and tell me the key support/resistance levels.

Scan for pump signals — show me the top 5 with highest conviction.

What's the current market regime? Should I be longing or shorting right now?

Open a 100 USDT long on SOL with 10x leverage and a 2.5% stop loss.

Where is institutional accumulation happening right now?

Start a funding farm strategy on the top 3 positive-funding pairs.

Compare Binance and Aster volume on ETHUSDT — which exchange is leading?

Standalone Scripts

The scripts/ folder contains CLI tools that run directly — no MCP server needed, no Claude required:

# Build first
pnpm run build

# Visual VPVR analysis with color output
node scripts/vpvr-analysis.mjs LINKUSDT

# Cross-exchange VPVR comparison (Aster vs Hyperliquid)
node scripts/vpvr-cross.mjs BTCUSDT

# In-depth VPVR analysis with extended metrics
node scripts/vpvr-analyzer.mjs ETHUSDT

# RSI-based ranging market detection across all pairs
node scripts/scan-ranging.mjs

VPVR Output Example

ENHANCED VPVR: LINKUSDT

KEY LEVELS:
   Current: $14.0470
   POC:     $13.4613  (highest volume node)
   VWAP:    $13.7240  (volume-weighted avg)
   VA High: $13.8994
   VA Low:  $13.4307

POSITION: ABOVE VA (Bullish Breakout) · Above VWAP

DELTA (Buy/Sell Pressure):
   Buy:  $485k  |  Sell: $403k  |  Net: +$82k (9.2%) [WEAK]

VOLUME PROFILE:
   $ 14.1948 |
  +$ 14.1541 |##
  +$ 14.1133 |###
   $ 14.0726 |####
   $ 14.0318 |## > NOW
   $ 13.9911 |###
   $ 13.9503 |###
  +$ 13.9096 |#### <-- VAH
  ...
   $ 13.4613 |████████████████ POC
   ...

Cross-Exchange VPVR Example

PRICE LEVELS COMPARISON
                    ASTER    HYPERLIQUID      DIFF
POC               90167.5       90163.9    +0.00%
VWAP              90856.4       91040.0    -0.20%
VA High           91523.0       91818.0
VA Low            89240.0       89229.0

DELTA ANALYSIS
Aster:       7.5%  BUYERS
Hyperliquid: 5.9%  BUYERS

VOLUME COMPARISON
Aster:       $4,670,814k
Hyperliquid: $41k
Ratio:       113,696x  (Aster leads)

Environment Variables

| Variable | Required | Description | |---|---|---| | ASTER_API_KEY | For trading | Your Aster DEX API key | | ASTER_API_SECRET | For trading | Your Aster DEX API secret | | CBS_API_KEY | Optional | CryptoBaseScanner key for QFL signals |

Market data and analysis tools work without credentials. Trading and account tools require API keys.

Attribution

Exchange API client originally adapted from lugondev's aster-dex-api and significantly extended.

Disclaimer

This software is for informational and educational purposes. Perpetual futures trading involves substantial risk of loss. Never risk capital you cannot afford to lose.

License

MIT — see LICENSE

MCP Servers