kukapay/binance-alpha-mcp

An MCP server for tracking Binance Alpha trades, helping AI agents optimize alpha point accumulation.
Features
- **Real-time Trade Monitoring**: Track buy-side activity for Binance Alpha tokens by Subscribing to on-chain events.
- **USD-based Metrics**: Calculates trade values in USD using real-time prices from the CryptoCompare.
- **Data Persistence**: Maintains trade data in memory, with automatic cleanup of records older than 1 hour.
- **MCP Tools**:
- get_top_tokens: Returns a markdown table of top tokens by USD trading volume, including symbol, USD volume, name, and address.
- get_trade_stats: Provides statistics on trade USD values (min, max, median) and a distribution table.
- **Configurable Endpoints**: Uses separate WebSocket (WS_ENDPOINT) and HTTP (RPC_ENDPOINT) endpoints for event listening and token queries.
Prerequisites
- **Node.js**: Version 18 or higher.
- **npm**: For dependency management.
- **BSC Node Access**: A WebSocket endpoint for event listening and an HTTP RPC endpoint for token queries, which can be obtained from services like Infura or QuikNode.
Installation
1. **Clone the Repository**:
2. **Install Dependencies**:
3. **Configure MCP Client**:
To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
Replace /absolute/path/to/binance-alpha-mcp with your actual installation path, and update WS_ENDPOINT and PRC_ENDPOINT with your own endpoint URLs.
Usage
The server exposes two MCP tools:
get_top_tokens
- **Description**: Returns a markdown table of the top tokens by USD trading volume.
- **Input**: { limit: number } (optional, defaults to 10). Specifies how many tokens to include in the output.
- **Output Example**:
get_trade_stats
- **Description**: Returns statistics about trade USD values, including min, max, median, and distribution.
- **Input**: { buckets: number } (optional, defaults to 10). Specifies the number of buckets to divide the trade distribution by USD value.