binance-alpha-mcp is an MCP (Model Context Protocol) server whose purpose is to track Binance Alpha trades to help AI agents optimize the accumulation of alpha points.
Main capabilities:
- Real-time trade monitoring: By subscribing to on-chain events, it tracks buy-side activity of Binance Alpha tokens.
- USD-based metrics: Uses CryptoCompare's real-time prices to calculate trade value in USD.
- Data persistence: Stores trade data in memory and automatically cleans up records older than 1 hour.
- MCP tools: Provides two tools—get_top_tokens and get_trade_stats.
- Configurable endpoints: Uses separate WebSocket (WS_ENDPOINT) and HTTP (RPC_ENDPOINT) endpoints for event listening and token queries, respectively.
Usage:
- Environment requirements: Node.js version 18 or higher; npm for dependency management; BSC node access is required, including a WebSocket endpoint for event listening and an HTTP RPC endpoint for token queries (available from services such as Infura or QuikNode).
- Clone the repository: git clone https://github.com/kukapay/binance-alpha-mcp.git cd binance-alpha-mcp
- Install dependencies: npm install
- Configure the MCP client: To use this server in an MCP client such as Claude Desktop, add the following to the configuration file (or equivalent file): { "mcpServers": { "binance-alpha-mcp": { "command": "node", "args": ["/absolute/path/to/binance-alpha-mcp/index.js"], "env": { "WS_ENDPOINT": "your_ws_endpoint_url", "RPC_ENDPOINT": "your_rpc_endpoint_url" } } } } Replace /absolute/path/to/binance-alpha-mcp with the actual installation path, and update WS_ENDPOINT and RPC_ENDPOINT to your own endpoint URLs.
MCP tool descriptions:
- get_top_tokens: Returns a markdown table of the top tokens sorted by USD trading volume. The input is { limit: number } (optional, default 10), specifying the number of tokens included in the output. Output example (period: last 23 minutes):
Symbol USD Volume Name Address ZK $72516.34 Polyhedra Network 0xc71b5f631354be6853efe9c3ab6b9590f8302e81 B2 $22893.72 BSquared Token 0x783c3f003f172c6ac5ac700218a357d2d66ee2a2 AIOT $5249.05 OKZOO 0x55ad16bd573b3365f43a9daeb0cc66a73821b4a5 gorilla $3263.95 gorilla 0xcf640fdf9b3d9e45cbd69fda91d7e22579c14444 BOOP $2046.32 BOOP 0x9a70815dfb644a24b57358e1041f8d0324c8f6e1 BANK $1305.38 Lorenzo Governance Token 0x3aee7602b612de36088f3ffed8c8f10e86ebf2bf SKYAI $1015.69 SKYAI 0x92aa03137385f18539301349dcfc9ebc923ffb10 KOGE $672.59 BNB48 Club Token 0xe6df05ce8c8301223373cf5b969afcb1498c5528 MYX $477.85 MYX 0xd82544bf0dfe8385ef8fa34d67e6e4940cc63e16 Drama $108.37 Drama 0xf922fb5f88c19f363cb018e8f7c98c10ed294444 - get_trade_stats: Returns statistics about the USD value of trades, including minimum, maximum, median, and distribution. The input is { buckets: number } (optional, default 10), specifying the number of buckets used to divide the trade distribution by USD value. Output example (period: last 1 minute):
min: $0.30, max: $2469.14, median: $653.41
range count 0.30~247.19 26 247.19~494.07 22 494.07~740.95 39 740.95~987.84 6 987.84~1234.72 16 1234.72~1481.61 9 1481.61~1728.49 1 1728.49~1975.38 6 1975.38~2222.26 10 2222.26~2469.14 2
Use cases: Suitable for users who need to let AI agents grasp Binance Alpha token buying activity in real time and optimize alpha points accumulation strategies based on trading volume or trading value distribution.
Limitations: This material does not provide information about fees, pricing, platform support scope, or specific performance guarantees. The project uses the MIT license; see the LICENSE file for details.
