🎯 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

🚀 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

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

⚠️ 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