READMEmain

Binance MCP Server 🚀

A powerful Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the Binance cryptocurrency exchange. This server provides a comprehensive suite of trading tools, market data access, and account management capabilities through the standardized MCP interface.

🌟 What is this?

This tool acts as a bridge between AI Assistants (like Claude, Cursor AI, or ChatGPT) and your Binance Account.

Instead of manually navigating the Binance website or app, you can ask your AI to:

"Check the current price of Bitcoin"
"Show me my account balance"
"Buy 0.1 ETH at the current market price"

The AI sends the request to this server, which securely executes it on Binance and returns the result to your AI.

🚀 Quick Start

1️⃣ Installation

The easiest way to install is using pip or uv:

# using pip
pip install binance-mcp-server
# using uv
uv add binance-mcp-server

2️⃣ Configuration

You need your Binance API Keys to allow this tool to access your account.

Log in to your Binance account and go to API Management.
Create a new API Key.
Set the keys as environment variables in your terminal:

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

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

3️⃣ Running with your AI

Configure for Claude Desktop / VSCode / Cursor

Add the following to your MCP settings configuration file (e.g., claude_desktop_config.json or mcp_config.json):

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

🎯 Key Capabilities

Real-time Market Data: Get live prices, order books, and ticker stats.
Account Management: specific Check balances and account status.
Trading Operations: Place buy/sell orders (Market, Limit, etc.).
Portfolio Tracking: Monitor open positions and Profit/Loss (PnL).

📚 Technical Reference

Available Tools

Click to expand full list of tools

🏦 Account & Portfolio Management

Tool	Purpose
`get_balance`	Retrieve account balances for all assets
`get_account_snapshot`	Point-in-time account state snapshot
`get_fee_info`	Trading fee rates (maker/taker commissions)
`get_available_assets`	List all tradable cryptocurrencies

📊 Market Data & Analysis

Tool	Purpose
`get_ticker_price`	Current price for a trading symbol
`get_ticker`	24-hour ticker price change statistics
`get_order_book`	Current order book (bids/asks)

💱 Trading Operations

Tool	Purpose
`create_order`	Create buy/sell orders (market, limit, etc.)
`get_orders`	List order history for a specific symbol

📈 Performance & Analytics

Tool	Purpose
`get_pnl`	Calculate profit and loss for futures trading
`get_position_info`	Open futures positions details

🏪 Wallet & Transfers

Tool	Purpose
`get_deposit_address`	Get deposit address for a specific coin
`get_deposit_history`	Deposit history for a specific coin
`get_withdraw_history`	Withdrawal history for a specific coin

🛡️ Risk Management

Tool	Purpose
`get_liquidation_history`	Past liquidation events for futures

Configuration Variables

Variable	Description	Required	Default
`BINANCE_API_KEY`	Your Binance API key	✅	-
`BINANCE_API_SECRET`	Your Binance API secret	✅	-
`BINANCE_TESTNET`	Use testnet environment	❌	`false`

🛠️ Development & Contributing

We welcome contributions! If you are a developer looking to improve this project:

Clone the repo: git clone https://github.com/AnalyticAce/binance-mcp-server.git
Install dev dependencies: uv install --dev or pip install -e .[dev]
Run tests: pytest

See CONTRIBUTING.md for detailed guidelines.

📄 License & Disclaimer

License: MIT

Disclaimer: This software is for educational purposes. Cryptocurrency trading involves financial risk. Always use the Binance Testnet for testing and development. The developers are not responsible for any financial losses.

binance-mcp-server