home / mcp / binance mcp server

Binance MCP Server

Unofficial tools and server implementation for Binance's Model Context Protocol (MCP). Designed to support developers building crypto trading AI Agents.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "analyticace-binance-mcp-server": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key",
        "your_api_key",
        "--api-secret",
        "your_secret",
        "--binance-testnet"
      ],
      "env": {
        "BINANCE_API_KEY": "your_api_key_here",
        "BINANCE_TESTNET": "true",
        "BINANCE_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

You run a Binance MCP Server to let AI assistants perform trading, market data access, and account management on Binance through a standardized MCP interface. It acts as a bridge between AI clients and your Binance account, enabling you to check prices, view balances, and place trades securely through an automated workflow.

How to use

Set up your MCP client to connect to the Binance server you run locally or remotely. You will configure your MCP client to reference the server under the name you provide (for example, binance). Once connected, you can request real-time prices, balances, and trading actions such as market or limit orders. The server handles authentication with your Binance account using your API credentials and executes actions on your behalf, returning results to your AI agent.

How to install

Prerequisites: you need Python installed on your system to install the Binance MCP Server package.

python3 --version
```

```bash
pip install binance-mcp-server

Configuration and usage notes

Prepare your Binance API credentials and an optional testnet setting to safely develop and test.

# Required: Your Binance API credentials
export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"

# Optional: Use testnet for development and safe testing
export BINANCE_TESTNET="true"

Run the MCP server and integrate with your MCP client

Start the Binance MCP Server using the standard runtime command shown in the practical setup. The server accepts your API key, secret, and an optional testnet flag as command-line arguments.

binance-mcp-server \
  --api-key "your_api_key" \
  --api-secret "your_api_secret" \
  --binance-testnet

Configure your MCP client to use the server

Add a configuration entry for the Binance MCP Server in your MCP client settings. The example below shows naming the server binance and pointing to the local server executable with your credentials embedded.

{
  "mcpServers": {
    "binance": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key", "your_api_key",
        "--api-secret", "your_api_secret",
        "--binance-testnet"
      ]
    }
  }
}

Available tools

get_balance

Retrieve account balances for all assets.

get_account_snapshot

Take a point-in-time snapshot of the account state.

get_fee_info

Fetch trading fee rates (maker/taker).

get_available_assets

List all tradable cryptocurrencies.

get_ticker_price

Obtain the current price for a given trading symbol.

get_ticker

Get 24-hour ticker change statistics.

get_order_book

Return the current order book with bids and asks.

create_order

Place buy or sell orders (market, limit, etc.).

get_orders

List order history for a specific symbol.

get_pnl

Calculate profit and loss for futures trading.

get_position_info

Open futures position details.

get_deposit_address

Fetch deposit address for a cryptocurrency.

get_deposit_history

Retrieve deposit history for a cryptocurrency.

get_withdraw_history

Retrieve withdrawal history for a cryptocurrency.

get_liquidation_history

Show past liquidation events for futures.