home / mcp / binance alpha mcp server

Binance Alpha MCP Server

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

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kukapay-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"
      }
    }
  }
}

You run Binance Alpha MCP to monitor real-time Binance Alpha trades, compute USD-based metrics, and expose MCP tools for quick analysis. This server helps AI agents optimize alpha point accumulation by delivering top tokens by USD volume and trade statistics on demand.

How to use

You connect to the Binance Alpha MCP server with an MCP client to access two built-in tools. Use the tools to view the most actively traded tokens in USD and to obtain trade value distributions. No low-level protocol work is required; you simply call the tools with straightforward inputs and read the structured outputs.

How to install

Prerequisites you need to install and run the server.

# 1) Install Node.js (version 18 or higher)
# 2) Install npm (comes with Node.js)
# 3) Install dependencies for the MCP
npm install
# 4) Start the MCP server locally (example command shown in the config snippet below)
npx -y binance-alpha-mcp --help

Configuration and usage notes

Configure your MCP client to connect to the local or remote server using the provided MCP command. The server expects two endpoints for operation: a WebSocket endpoint for listening to on-chain events and an HTTP endpoint for token queries. Populate these values in your client configuration to enable real-time tracking and data queries.

{
  "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"
      }
    }
  }
}

Examples of MCP tools usage

There are two built-in MCP tools you can call from your client:

get_top_tokens returns a markdown table of tokens by USD trading volume. You can specify an optional limit to control how many tokens are included. The output includes symbol, USD volume, name, and on-chain address for each top token.

get_trade_stats provides statistics on trade USD values, including a distribution across value ranges. You can specify the number of buckets to divide the distribution into.

Notes on data and endpoints

- Data is tracked in real time and values are computed in USD using live prices. - Trade records older than one hour are automatically cleaned up to keep memory usage reasonable.

Security and access

Keep your MCP client configuration secure. Do not expose endpoint URLs or environment variables in public environments. Use access controls and rotate any credentials used in your MCP setup.

Available tools

get_top_tokens

Returns a markdown table of the top tokens by USD trading volume, including Symbol, USD Volume, Name, and Address. Accepts an optional limit to control how many tokens are shown.

get_trade_stats

Provides statistics on trade USD values (min, max, median) and a distribution table. Accepts an optional buckets parameter to define distribution granularity.