Binance Alpha MCP

1# Binance Alpha MCP
2 
3An MCP server for tracking Binance Alpha trades, helping AI agents optimize alpha point accumulation.
4 
5[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
6[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Real-time Trade Monitoring**:  Track buy-side activity for Binance Alpha tokens by Subscribing to on-chain events.
12- **USD-based Metrics**: Calculates trade values in USD using real-time prices from the CryptoCompare.
13- **Data Persistence**: Maintains trade data in memory, with automatic cleanup of records older than 1 hour.
14- **MCP Tools**:
15  - `get_top_tokens`: Returns a markdown table of top tokens by USD trading volume, including symbol, USD volume, name, and address.
16  - `get_trade_stats`: Provides statistics on trade USD values (min, max, median) and a distribution table.
17- **Configurable Endpoints**: Uses separate WebSocket (`WS_ENDPOINT`) and HTTP (`RPC_ENDPOINT`) endpoints for event listening and token queries.
18 
19## Prerequisites
20 
21- **Node.js**: Version 18 or higher.
22- **npm**: For dependency management.
23- **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.
24 
25## Installation
26 
271. **Clone the Repository**:
28   ```bash
29   git clone https://github.com/kukapay/binance-alpha-mcp.git
30   cd binance-alpha-mcp
31   ```
32 
332. **Install Dependencies**:
34   ```bash
35   npm install
36   ```
373. **Configure MCP Client**:
38   To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
39    ```json
40    {
41      "mcpServers": {
42        "binance-alpha-mcp": {
43          "command": "node",
44          "args": ["/absolute/path/to/binance-alpha-mcp/index.js"],
45          "env": { 
46             "WS_ENDPOINT": "your_ws_endpoint_url",
47             "RPC_ENDPOINT": "your_rpc_endpoint_url"
48          }
49        }
50      }
51    }   
52    ```
53   Replace `/absolute/path/to/binance-alpha-mcp` with your actual installation path, and update `WS_ENDPOINT` and `PRC_ENDPOINT` with your own endpoint URLs.
54 
55## Usage
56 
57The server exposes two MCP tools:
58 
59### get_top_tokens
60- **Description**: Returns a markdown table of the top tokens by USD trading volume.
61- **Input**: `{ limit: number }` (optional, defaults to 10). Specifies how many tokens to include in the output.
62- **Output Example**:
63  ```
64  period: last 23 minutes
65  | Symbol | USD Volume | Name | Address |
66  |--------|------------|------|---------|
67  | ZK | $72516.34 | Polyhedra Network | 0xc71b5f631354be6853efe9c3ab6b9590f8302e81 |
68  | B2 | $22893.72 | BSquared Token | 0x783c3f003f172c6ac5ac700218a357d2d66ee2a2 |
69  | AIOT | $5249.05 | OKZOO | 0x55ad16bd573b3365f43a9daeb0cc66a73821b4a5 |
70  | gorilla | $3263.95 | gorilla | 0xcf640fdf9b3d9e45cbd69fda91d7e22579c14444 |
71  | BOOP | $2046.32 | BOOP | 0x9a70815dfb644a24b57358e1041f8d0324c8f6e1 |
72  | BANK | $1305.38 | Lorenzo Governance Token | 0x3aee7602b612de36088f3ffed8c8f10e86ebf2bf |
73  | SKYAI | $1015.69 | SKYAI | 0x92aa03137385f18539301349dcfc9ebc923ffb10 |
74  | KOGE | $672.59 | BNB48 Club Token | 0xe6df05ce8c8301223373cf5b969afcb1498c5528 |
75  | MYX | $477.85 | MYX | 0xd82544bf0dfe8385ef8fa34d67e6e4940cc63e16 |
76  | Drama | $108.37 | Drama | 0xf922fb5f88c19f363cb018e8f7c98c10ed294444 |
77  ```
78  
79### get_trade_stats
80- **Description**: Returns statistics about trade USD values, including min, max, median, and distribution.
81- **Input**: `{ buckets: number }` (optional, defaults to 10). Specifies the number of buckets to divide the trade distribution by USD value.
82- **Output Example**:
83  ```
84  period: last 1 minutes
85  min: $0.30, max: $2469.14, median: $653.41
86  | range | count |
87  |-------|-------|
88  | 0.30~247.19 | 26 |
89  | 247.19~494.07 | 22 |
90  | 494.07~740.95 | 39 |
91  | 740.95~987.84 | 6 |
92  | 987.84~1234.72 | 16 |
93  | 1234.72~1481.61 | 9 |
94  | 1481.61~1728.49 | 1 |
95  | 1728.49~1975.38 | 6 |
96  | 1975.38~2222.26 | 10 |
97  | 2222.26~2469.14 | 2 |
98  ```
99 
100## License
101 
102This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
103 
104