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.

1. Log in to your Binance account and go to API Management.
2. Create a new API Key.
3. 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

Configuration Variables

🛠️ Development & Contributing

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

1. Clone the repo: git clone https://github.com/AnalyticAce/binance-mcp-server.git
2. Install dev dependencies: uv install --dev or pip install -e .[dev]
3. 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.