Enables AI agents to interact with the Binance cryptocurrency exchange, providing comprehensive trading tools, real-time market data access, portfolio management, order placement and management, account balance tracking, and risk management capabilities for both spot and futures markets.
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.
Related MCP server: Pinecone Assistant MCP
🚀 Quick Start
1️⃣ Installation
The easiest way to install is using pip:
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:
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):
🎯 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
🏦 Account & Portfolio Management
Tool | Purpose |
| Retrieve account balances for all assets |
| Point-in-time account state snapshot |
| Trading fee rates (maker/taker commissions) |
| List all tradable cryptocurrencies |
📊 Market Data & Analysis
Tool | Purpose |
| Current price for a trading symbol |
| 24-hour ticker price change statistics |
| Current order book (bids/asks) |
💱 Trading Operations
Tool | Purpose |
| Create buy/sell orders (market, limit, etc.) |
| List order history for a specific symbol |
📈 Performance & Analytics
Tool | Purpose |
| Calculate profit and loss for futures trading |
| Open futures positions details |
🏪 Wallet & Transfers
Tool | Purpose |
| Get deposit address for a specific coin |
| Deposit history for a specific coin |
| Withdrawal history for a specific coin |
🛡️ Risk Management
Tool | Purpose |
| Past liquidation events for futures |
Configuration Variables
Variable | Description | Required | Default |
| Your Binance API key | ✅ | - |
| Your Binance API secret | ✅ | - |
| Use testnet environment | ❌ |
|
🛠️ 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.gitInstall dev dependencies:
uv install --devorpip 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.