🔶 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

• Spot Trading — Orders, market data, account info
• Margin Trading — Cross & isolated margin
• Futures (USD-M & COIN-M) — Perpetual contracts
• Options — European-style options
• Portfolio Margin — Unified margin accounts
• Algo Trading — TWAP, VP algorithms

Earn & Invest

• Simple Earn — Flexible & locked products
• Staking — ETH & SOL staking
• Auto-Invest — DCA & recurring buys
• Dual Investment — Structured products
• Crypto Loans — Flexible rate loans
• VIP Loans — Institutional lending

Wallet & Transfers

• Wallet — Deposits, withdrawals, transfers
• Sub-Accounts — Multi-account management
• Convert — Instant asset conversion
• Pay — Binance Pay integration
• Gift Cards — Create & redeem

Additional Services

• Copy Trading — Lead trader features
• Mining — Pool mining operations
• NFT — NFT marketplace
• C2C/P2P — Peer-to-peer trading
• Fiat — Fiat on/off ramps
• Rebate — Referral program

🚀 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 .env file. 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)

1. Start the SSE server: npm run start:sse
2. 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

1. Create tool file in src/tools/binance-{module}/
2. Export registration function
3. Import and register in module's index.ts
4. 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.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

nich — @nichxbt