🔶 Binance MCP Server
The most comprehensive Model Context Protocol server for Binance — 478+ tools covering the entire Binance.com API
Quick Start • Features • Configuration • Documentation • Contributing
🎯 Overview
Binance MCP Server enables AI assistants like Claude, ChatGPT, and other MCP-compatible clients to interact directly with the Binance cryptocurrency exchange. Execute trades, manage portfolios, analyze markets, and automate strategies through natural language.
Why Binance MCP?
- Complete Coverage — 478+ tools spanning every Binance API endpoint
- 🔐 Secure by Design — API credentials never leave your machine
- ⚡ Production Ready — Built with official Binance SDKs and TypeScript
- 🔌 Universal Compatibility — Works with Claude Desktop, Cursor, ChatGPT, and any MCP client
- 📡 Dual Transport — STDIO for desktop apps, SSE for web applications
✨ Features
Trading & Markets
|
Earn & Invest
|
Wallet & Transfers
|
Additional Services
|
🚀 Quick Start
Prerequisites
- Node.js ≥ 18.0.0
- Binance account with API credentials
- An MCP-compatible client (Claude Desktop, Cursor, etc.)
Installation
# Clone the repository
git clone https://github.com/nirholas/Binance-MCP.git
cd Binance-MCP
# Install dependencies
npm install
# Build the project
npm run build
Interactive Setup
Run the setup wizard to configure your environment:
npm run init
This will guide you through:
- Setting up your Binance API credentials
- Choosing your transport method (STDIO/SSE)
- Configuring your MCP client
⚙️ Configuration
Environment Variables
Create a .env file in the project root:
BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
🔒 Security Note: Never commit your
.envfile. It's already in.gitignore.
Running the Server
STDIO Transport (Claude Desktop, Cursor)
npm run start
SSE Transport (ChatGPT, Web Apps)
npm run start:sse
Development Mode (Hot Reload)
npm run dev # STDIO
npm run dev:sse # SSE
🖥️ Client Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"binance": {
"command": "node",
"args": ["/absolute/path/to/Binance-MCP/build/index.js"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
}
Cursor
Add to your Cursor MCP settings:
{
"binance": {
"command": "node",
"args": ["/absolute/path/to/Binance-MCP/build/index.js"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
ChatGPT (via SSE)
- Start the SSE server:
npm run start:sse - Connect to
http://localhost:3000/sse
📖 Usage Examples
Check Account Balance
"What's my current Binance account balance?"
Place a Market Order
"Buy 0.01 BTC at market price"
Get Market Data
"Show me the order book for BTCUSDT with 20 levels"
Set Up Auto-Invest
"Create a daily auto-invest plan to buy $100 of ETH"
Manage Futures Position
"Open a 5x long position on ETHUSDT futures with $1000"
📊 Module Coverage
| Module | Tools | Description |
|---|---|---|
| Wallet | 40+ | Deposits, withdrawals, transfers, asset management |
| Spot | 35+ | Market data, trading, order management |
| Futures (USD-M) | 40+ | Perpetual futures, positions, leverage |
| Futures (COIN-M) | 35+ | Coin-margined futures contracts |
| Margin (Cross) | 26 | Cross-margin trading and borrowing |
| Margin (Isolated) | 15 | Isolated margin pairs |
| Options | 27 | European-style options trading |
| Portfolio Margin | 15 | Unified margin account management |
| Sub-Account | 22 | Sub-account creation and management |
| Staking | 22+ | ETH, SOL, and other staking products |
| Simple Earn | 15+ | Flexible and locked savings products |
| Auto-Invest | 13 | DCA and recurring purchase plans |
| Mining | 13+ | Mining pool statistics and earnings |
| Algo Trading | 11+ | TWAP, VP, and algorithmic orders |
| VIP Loan | 9+ | Institutional lending services |
| Convert | 9+ | Instant asset conversion |
| Dual Investment | 10+ | Structured yield products |
| NFT | 10+ | NFT marketplace operations |
| Gift Card | 8 | Gift card creation and redemption |
| Copy Trading | 10+ | Lead trader and copy features |
| Crypto Loans | 12+ | Flexible rate crypto loans |
| Fiat | 5+ | Fiat deposit and withdrawal |
| Pay | 5+ | Binance Pay transactions |
| C2C/P2P | 5+ | Peer-to-peer trading |
| Rebate | 5+ | Referral rebate tracking |
Total: 478+ tools
🏗️ Project Structure
Binance-MCP/
├── src/
│ ├── index.ts # Entry point
│ ├── binance.ts # Module registration
│ ├── init.ts # Setup wizard
│ ├── config/
│ │ ├── binanceClient.ts # API clients with signing
│ │ └── client.ts # HTTP utilities
│ ├── server/
│ │ ├── base.ts # Base MCP server
│ │ ├── stdio.ts # STDIO transport
│ │ └── sse.ts # SSE transport
│ ├── modules/ # API module definitions
│ │ ├── spot/
│ │ ├── margin/
│ │ ├── futures-usdm/
│ │ ├── futures-coinm/
│ │ └── ... (24 modules)
│ ├── tools/ # Tool implementations
│ │ ├── binance-spot/
│ │ ├── binance-margin/
│ │ ├── binance-futures-usdm/
│ │ └── ... (24 tool sets)
│ └── utils/
│ └── logger.ts
├── docs/
│ ├── QUICK_START.md # Getting started guide
│ └── TOOLS_REFERENCE.md # Complete tool documentation
├── build/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── config.json # Runtime configuration
🛠️ Development
Build
npm run build
Type Check
npx tsc --noEmit
Test with MCP Inspector
npm run test
Adding New Tools
- Create tool file in
src/tools/binance-{module}/ - Export registration function
- Import and register in module's
index.ts - Register module in
src/binance.ts
📚 Documentation
| Resource | Description |
|---|---|
| Quick Start Guide | Get running in 5 minutes |
| Tools Reference | Complete API for all 478+ tools |
| Binance API Docs | Official Binance documentation |
| MCP Specification | Model Context Protocol spec |
⚠️ Disclaimer
This software is provided for educational and informational purposes only.
- Not Financial Advice — This tool does not provide financial, investment, or trading advice
- Use at Your Own Risk — Cryptocurrency trading involves substantial risk of loss
- API Security — Protect your API credentials; use IP restrictions and withdrawal limits
- No Warranty — The software is provided "as is" without warranty of any kind
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
👤 Author
nich — @nichxbt
