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:

Tools Reference (56 total)

Market Data

Perpetual Trading

Spot Trading

Account & Risk

Volume Profile Analytics

Scanners

Binance Intelligence

QFL Base Signals (CryptoBaseScanner)

Strategy Automation

Scale Grid Engine

Infrastructure

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://raw.githubusercontent.com/Excaliber9271/asterdex-mcp-server/main/src/mcp_server_asterdex_2.2.zip
cd asterdex-mcp-server
pnpm install
pnpm run build

Configure credentials

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

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

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