aster-mcp
Supports wallet management (creation, balance checks), token deposits and withdrawals, and cross-chain operations on the BNB Chain network via AsterDEX.
Supports wallet management (creation, balance checks), token deposits and withdrawals, and cross-chain operations on the Ethereum network via AsterDEX.
Supports wallet management (creation, balance checks), token deposits and withdrawals, and cross-chain operations on the Solana network via AsterDEX.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aster-mcpswap 0.5 ETH on Ethereum to USDC on Arbitrum"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
💎 Aster MCP Server v0.1.0
Production-ready Model Context Protocol (MCP) server for AsterDEX
Features • Quick Start • Tools • Prompts • Security • Contributing
🚀 Features
🏗️ Multi-Chain Support
Ethereum - EVM-compatible smart contracts
Arbitrum - Layer 2 scaling solution
BNB Chain - High-performance blockchain
Solana - Ultra-fast blockchain with low fees
Seamless cross-chain operations
🛠️ Comprehensive Trading Tools
Wallet creation for all supported networks
On-chain balance checks (native & tokens)
Market buy orders on AsterDEX
Real-time price data
Deposit & withdrawal operations
Cross-chain swap & bridge in one command
🔧 Developer-Friendly
Simple JSON-RPC interface
Comprehensive error handling
Environment-based per-network configuration
Docker containerization support
MCP protocol 2024-11-05 implementation
Automatic token symbol resolution (USDT, ARB, etc.)
🎯 Production-Ready Architecture
Dual-server design (HTTP + MCP stdio)
Rate limiting built-in
EIP-712 signatures for secure withdrawals
Automatic ERC20 token approval handling
Per-network wallet configuration
Graceful error handling and logging
Related MCP server: Armor Crypto MCP
📦 Quick Start
✅ Prerequisites
# Required
Node.js >= 18.0.0
npm >= 9.0.0🔑 Configuration
Create a .env file with your configuration:
Required for Trading:
ASTER_API_KEY: Your AsterDEX API key
ASTER_API_SECRET: Your AsterDEX API secret
ASTER_API_BASE_URL: AsterDEX API endpoint (default: https://sapi.asterdex.com)
Per-Network Wallet Configuration (for deposits/withdrawals):
ETHEREUM_WALLET_PRIVATE_KEY or ETHEREUM_WALLET_MNEMONIC
ARBITRUM_WALLET_PRIVATE_KEY or ARBITRUM_WALLET_MNEMONIC
BNB_WALLET_PRIVATE_KEY or BNB_WALLET_MNEMONIC
SOLANA_WALLET_PRIVATE_KEY or SOLANA_WALLET_MNEMONIC
RPC Endpoints (optional, defaults provided):
ETHEREUM_RPC_URL (default: https://eth.llamarpc.com)
ARBITRUM_RPC_URL (default: https://arbitrum-one-rpc.publicnode.com)
BNB_RPC_URL (default: https://bsc-rpc.publicnode.com)
SOLANA_RPC_URL (default: https://solana-rpc.publicnode.com)
Debug Mode (optional):
DEBUG_FULL - Set to
truefor detailed transaction logging including gas usage, allowances, block numbers, and tx hashes (default: false)
📥 Installation
# Clone the repository
git clone https://github.com/Tairon-ai/aster-mcp.git
cd aster-mcp
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your API credentials and wallet keys
# Start the HTTP server
npm start
# MCP stdio server for Claude Desktop
npm run mcp🤖 Claude Desktop Integration
In Claude Desktop settings, go to the Developer tab and edit the configuration by adding the following:
{
"mcpServers": {
"aster-dex": {
"command": "node",
"args": ["/path/to/aster-mcp/mcp/index.js"],
"env": {
"ASTER_API_KEY": "your_api_key_here",
"ASTER_API_SECRET": "your_api_secret_here",
"ETHEREUM_WALLET_PRIVATE_KEY": "0x...",
"ARBITRUM_WALLET_PRIVATE_KEY": "0x...",
"BNB_WALLET_PRIVATE_KEY": "0x...",
"SOLANA_WALLET_PRIVATE_KEY": "base58_key_here"
}
}
}
}🛠 Available Tools
💼 Wallet Management
Tool | Description | Parameters | Returns |
| Create new EVM wallet (Ethereum/Arbitrum/BNB) |
| Address, private key, mnemonic |
| Create new Solana wallet | None | Address, private key, mnemonic |
💰 Balance & Portfolio
Tool | Description | Parameters | Returns |
| Check on-chain wallet balance |
| Balance, decimals, symbol |
| Get AsterDEX exchange balance | None | Available & locked balances for all assets |
📊 Market Data
Tool | Description | Parameters | Returns |
| Get current market price |
| Current price & 24h stats |
| Get exchange trading rules |
| Trading pairs, filters, limits |
🛒 Trading
Tool | Description | Parameters | Returns |
| Execute market buy order |
| Order details & execution price |
📥 Deposits & Withdrawals
Tool | Description | Parameters | Returns |
| Deposit tokens to AsterDEX |
| Transaction hash & status |
| Get withdrawal fee estimate |
| Fee amount & network |
| Withdraw from AsterDEX to wallet |
| Transaction details & status |
🌉 Cross-Chain Operations
Tool | Description | Parameters | Returns |
| Cross-chain swap in one command |
| Complete transaction flow details |
🤖 Prompts
💼 Wallet Management
"Create a new Ethereum wallet"
"Generate a Solana wallet for me"
"Create an Arbitrum wallet"💰 Balance Checks
"Check my Ethereum balance"
"What's my USDT balance on Arbitrum?"
"Show balance of 0x... on Ethereum"
"Check SOL balance of [solana_address]"📊 Exchange Balance & Info
"Show my AsterDEX account balance"
"What's my balance on the exchange?"
"Get exchange info for BTCUSDT"
"Show all available trading pairs"💹 Price Checks
"What's the current price of BTCUSDT?"
"Get ETH price in USDT"
"Show me ASTER price"🛒 Trading
"Buy BTC for 2 USDT"
"Market buy ETHUSDT with 1 USDT"
"Buy ASTER for 3 USDT"
"Execute market buy of 2 USDT worth of BTC"📥 Deposits
"Deposit 1 USDT from Ethereum to AsterDEX"
"Deposit 2 SOL from Solana"
"Deposit 3 USDC from Arbitrum"
"Transfer 1.5 BNB from BNB Chain to exchange"📤 Withdrawals
"What's the withdrawal fee for USDT on Ethereum?"
"Get withdrawal fee for BTC on Arbitrum"
"Withdraw 2 USDT to 0x... on Ethereum"
"Send 1 USDC to my Arbitrum wallet 0x..."
"Withdraw 1 USDT to my wallet on BNB Chain"
"Withdraw 0.5 ETH on Ethereum (to my env wallet)"🌉 Cross-Chain Swaps
"Deposit 2 USDT from BNB, buy USDC, and withdraw to Arbitrum address 0x..."
"Swap 1 USDC from Ethereum to BTC and bridge to Arbitrum"
"Deposit 3 USDT from Arbitrum, swap to ASTER, withdraw to BSC 0x..."🔧 Testing Tools
# Test with curl (HTTP endpoint)
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "get_price", "arguments": {"symbol": "BTCUSDT"}}, "id": 1}'
# Health check
curl http://localhost:8080/health
# Server info
curl http://localhost:8080/info🔒 Security
🛡️ Security Best Practices
API Key Protection - Never commit
.envfiles or API keys to version controlPer-Network Wallets - Each network has isolated wallet configuration
Private Key Security - Private keys never leave your environment, only used for signing
Environment Variables - All sensitive data stored in environment variables
Input Validation - All inputs validated before processing
EIP-712 Signatures - Secure withdrawal signatures following Ethereum standards
Rate Limiting - Built-in rate limiting prevents API abuse
Secure Communication - HTTPS for all external API calls
Error Handling - Errors don't expose sensitive information
🔐 Wallet Configuration Priority
The server uses this priority order for wallet credentials:
User-provided private key (in tool parameters)
Network-specific private key (from
NETWORK_WALLET_PRIVATE_KEYenv var)Network-specific mnemonic (from
NETWORK_WALLET_MNEMONICenv var)
⚠️ Important Security Notes
Solana private keys must be in base58 format (NO 0x prefix!)
EVM private keys must be in hex format WITH 0x prefix
Keep separate wallets for different networks if needed
Use hardware wallets or secure key management in production
Never share your private keys or mnemonics
🚀 Deployment
🏭 Production Deployment
# Start production HTTP server
NODE_ENV=production npm start
# With PM2
pm2 start server.js --name aster-mcp
# With Docker
docker build -t aster-mcp .
docker run -d -p 8080:8080 --env-file .env aster-mcp
# Docker Compose
docker-compose up -d🔑 Environment Variables
# Aster DEX API Configuration
ASTER_API_KEY=your_api_key_here
ASTER_API_SECRET=your_api_secret_here
ASTER_API_BASE_URL=https://sapi.asterdex.com
ASTER_RECV_WINDOW=5000
# Ethereum Wallet (EVM - hex format with 0x prefix)
ETHEREUM_WALLET_PRIVATE_KEY=0x_your_ethereum_private_key_here
ETHEREUM_WALLET_MNEMONIC=your twelve word ethereum mnemonic phrase here
ETHEREUM_RPC_URL=https://eth.llamarpc.com
# Arbitrum Wallet (EVM - hex format with 0x prefix)
ARBITRUM_WALLET_PRIVATE_KEY=0x_your_arbitrum_private_key_here
ARBITRUM_WALLET_MNEMONIC=your twelve word arbitrum mnemonic phrase here
ARBITRUM_RPC_URL=https://arbitrum-one-rpc.publicnode.com
# BNB Chain Wallet (EVM - hex format with 0x prefix)
BNB_WALLET_PRIVATE_KEY=0x_your_bnb_private_key_here
BNB_WALLET_MNEMONIC=your twelve word bnb mnemonic phrase here
BNB_RPC_URL=https://bsc-rpc.publicnode.com
# Solana Wallet (base58 format - NO 0x prefix!)
SOLANA_WALLET_PRIVATE_KEY=your_solana_private_key_base58_here
SOLANA_WALLET_MNEMONIC=your twelve word solana mnemonic phrase here
SOLANA_RPC_URL=https://solana-rpc.publicnode.com
# Server Configuration
PORT=8080
NODE_ENV=production
# Rate Limiting
RATE_LIMIT_REQUESTS_PER_SECOND=10
# Debug Mode (set to 'true' for detailed transaction logging)
# Enables verbose logging for deposits, approvals, and transactions
# Shows: RPC URLs, gas usage, allowances, block numbers, tx hashes
DEBUG_FULL=false🤝 Contributing
We welcome contributions! Please read CONTRIBUTING.md for details on our development process.
# Fork the repository
git clone https://github.com/Tairon-ai/aster-mcp.git
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and commit
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature
# Open Pull Request📝 Development Guidelines
Follow existing code style and structure
Add tests for new features
Update documentation for API changes
Ensure security best practices
Test with all supported networks
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📚 Resources
🎯 Supported Networks & Chains
Network | Chain ID | Type | Native Token |
Ethereum | 1 | EVM | ETH |
Arbitrum | 42161 | EVM L2 | ETH |
BNB Chain | 56 | EVM | BNB |
Solana | mainnet-beta | Non-EVM | SOL |
🔗 Links
Website: asterdex.com
Documentation: docs.asterdex.com
API Reference: sapi.asterdex.com
Support: support@asterdex.com
Built by Tairon.ai team with help from Claude
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tairon-ai/aster-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server