@nirholas/binance-mcp-server

🔶 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)

• 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