Binance

binance-mcp

typescript

76

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "termix-official-binance-mcp": {
      "command": "node",
      "args": [
        "/Users/Username/Desktop/binance-mcp/build/index.js"
      ],
      "env": {
        "BINANCE_API_KEY": "YOUR_BINANCE_API_KEY",
        "BINANCE_API_SECRET": "YOUR_BINANCE_API_SECRET"
      }
    }
  }
}

You can run and use the Binance MCP Server to securely connect to Binance, view and manage your portfolio, and execute trades with structured, low-impact workflows using the Model Context Protocol (MCP). This server consolidates account data, market data, and order execution into a single, scriptable interface that you can access from MCP clients and Claude Desktop integration.

How to use

You connect a compatible MCP client to the Binance MCP Server to access account information, retrieve market data, and place trades. Start by ensuring your server is built and running, then configure your client to point at the local stdio server endpoint. Use the available functions to query account info, fetch order books, place spot orders, and initiate TWAP-style orders for larger trades. Use your Binance API key and secret to authenticate, and keep keys in secure environments.

How to install

Prerequisites you need before installing the server:

Node.js 16 or later
npm or yarn
Binance API key and secret
A valid Binance Smart Chain (BSC) wallet private key

Install steps you can follow directly:

Clone the project repository
Install dependencies
Build the server (if building is required)
Start the server

Additional setup and configuration

Place your Binance credentials in an environment file or your hosting environment so the server can securely access them. The server can be started in runtime mode or as a built executable depending on how you deploy it.

Available tools

binanceAccountInfo

Retrieves comprehensive information about your Binance account, including balances, trading permissions, and account status.

binanceAccountSnapshot

Gets a snapshot of your Binance account status, including current BTC price information and history for the last 30 days.

binanceOrderBook

Retrieves the current order book for a specified trading pair, showing buy and sell orders up to 50 levels deep.

binanceSpotPlaceOrder

Places a spot market order for immediate execution at the best available price, supporting base asset quantity or quote currency amount.

binanceTimeWeightedAveragePriceFutureAlgo

Places a TWAP order that executes gradually over a specified duration to minimize market impact.