Binance

This Binance MCP Server provides a ready-made MCP (Model Control Protocol) interface to interact with Binance trading features. It exposes practical, ready-to-use actions for real-time price lookup, balance checks, placing market orders, viewing history, managing open orders, and exploring arbitrage opportunities, giving you a solid foundation to build automated trading strategies and risk controls.

How to use

You interact with the server through an MCP client to perform a set of predefined actions. Each action is designed to help you build automated trading workflows or analytical tooling. Here are the core capabilities you can call:

• get_symbol_price: Retrieve the current price for a trading pair
• get_account_balance: Check the balance of a specific cryptocurrency
• place_market_order: Submit a market order (buy or sell)
• get_trade_history: Retrieve past trades
• get_open_orders: List currently open orders
• cancel_order: Cancel a specific order
• get_funding_rate_history: Obtain historical funding rates
• execute_hedge_arbitrage_strategy: Run a hedge arbitrage strategy
• find_arbitrage_pairs: Discover potential arbitrage opportunities

To start using these endpoints, ensure your MCP client is configured with the Binance MCP Server connection details. Then call the actions by selecting the corresponding tool names and supplying required parameters (such as symbol, order size, or order IDs). Each action returns structured data you can inspect or feed into your trading logic.

How to install

Prerequisites: Python 3.13 or newer, MCP CLI (mcp[cli]) version 1.6.0 or newer, and the requests library version 2.32.3 or newer.

# 1) Clone the project repository
git clone https://github.com/mixuechu/binance-mcp.git
cd binance-mcp-server

# 2) Create and activate a virtual environment
python -m venv venv
source venv/bin/activate

# 3) Install runtime dependencies
pip install --upgrade pip
pip install mcp[cli]>=1.6.0 requests>=2.32.3

4. Configure the MCP connection for this server by creating or editing your MCP config file and adding the runtime command shown below. This enables the MCP client to launch the Binance MCP Server using the standard runner.

{
  "binance_mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/binance-mcp-server",
      "run",
      "binance.py",
      "--binance-api-key",
      "YOUR_API_KEY",
      "--binance-secret-key",
      "YOUR_SECRET_KEY"
    ]
  }
}

Additional notes

Security: Safeguard your API keys and secret keys. Apply least-privilege API keys and consider restricting IPs if supported by Binance. Before trading, validate the workflow on a test environment or sandbox if available.

Development and extension: The server provides a solid base for adding new trading strategies, enhancing error handling and logging, and integrating additional exchange APIs. You can experiment with more order types and more sophisticated arbitrage logic as your needs grow.

Available tools

get_symbol_price

Fetch the latest price for a specified trading symbol, enabling real-time price tracking.

get_account_balance

Query the balance of a specific asset in your Binance account to monitor holdings.

place_market_order

Execute a market order to buy or sell a given quantity of an asset at the current market price.

get_trade_history

Retrieve historical trades for analysis, auditing, or strategy backtesting.

get_open_orders

List all currently open orders to manage active positions and orders.

cancel_order

Cancel a specific open order by its identifier to adjust trading activity.

get_funding_rate_history

Obtain historical funding rates to assess funding costs for perpetual futures positions.

execute_hedge_arbitrage_strategy

Run a hedge-based arbitrage routine to manage risk while seeking price discrepancies.

find_arbitrage_pairs

Scan markets to identify potential arbitrage opportunities across trading pairs.