binance-alpha-mcp

An MCP server for tracking Binance Alpha trades, helping AI agents optimize alpha point accumulation.

[](https://opensource.org/licenses/MIT) [](https://nodejs.org/)

• 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.

• 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.

1. Clone the Repository:

   git clone https://github.com/kukapay/binance-alpha-mcp.git
   cd binance-alpha-mcp

1. Install Dependencies:

   npm install

1. Configure MCP Client:

To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):

    {
      "mcpServers": {
        "binance-alpha-mcp": {
          "command": "node",
          "args": ["/absolute/path/to/binance-alpha-mcp/index.js"],
          "env": { 
             "WS_ENDPOINT": "your_ws_endpoint_url",