<div align="center">

🔶 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

</div>

---

🎯 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

<table> <tr> <td width="50%">

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

</td> <td width="50%">

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

</td> </tr> <tr> <td width="50%">

Wallet & Transfers

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

</td> <td width="50%">

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

</td> </tr> </table>

---

🚀 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

---