Binance MCP Servers

This repository includes two Binance MCP server packages in the packages/ directory:

1. binance-mcp-server - Full Binance.com API integration
2. binance-us-mcp-server - Binance US API integration

---

Binance MCP Server (Global)

Full-featured MCP server for Binance.com with support for:

• Spot trading
• Futures (USD-M and COIN-M)
• Margin trading
• Options
• Copy trading
• Auto-invest
• Mining
• Staking
• Simple Earn
• And more...

Installation

cd packages/binance-mcp-server
npm install
npm run build

Configuration

Create config.json:

{
  "apiKey": "your_binance_api_key",
  "apiSecret": "your_binance_api_secret",
  "testnet": false
}

Modules

Module	Description
algo	Algorithmic trading orders
auto-invest	Auto-invest plans
c2c	Crypto-to-crypto trading
convert	Convert between assets
copy-trading	Copy trading
crypto-loans	Crypto-backed loans
dual-investment	Dual investment products
fiat	Fiat deposit/withdrawal
futures-coinm	COIN-M futures
futures-usdm	USD-M futures
gift-card	Binance gift cards
margin	Margin trading
mining	Mining pool
nft	NFT marketplace
options	Options trading
pay	Binance Pay
portfolio-margin	Portfolio margin
rebate	Rebate program
simple-earn	Simple Earn products
spot	Spot trading
staking	Staking products
vip-loan	VIP loans
wallet	Wallet operations

Usage with Claude Desktop

{
  "mcpServers": {
    "binance": {
      "command": "node",
      "args": ["/path/to/packages/binance-mcp-server/dist/index.js"],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_API_SECRET": "your_secret"
      }
    }
  }
}

---

Binance US MCP Server

MCP server specifically for Binance US API.

Installation

cd packages/binance-us-mcp-server
npm install
npm run build

Key Differences from Global

• US-compliant API endpoints
• Limited asset selection
• No futures or margin trading
• Different trading pairs

Available Tools

Tool	Description
Market data	Prices, order books, trades
Account info	Balances, trade history
Spot trading	Buy/sell orders
OCO orders	One-cancels-other orders
Wallet	Deposits, withdrawals

Configuration

{
  "apiKey": "your_binance_us_api_key",
  "apiSecret": "your_binance_us_api_secret"
}

Documentation

See the docs/ folder in the binance-us-mcp-server package:

• API Reference
• Tools Reference
• Configuration Guide
• Examples
• Security

---

Security Best Practices

API Key Permissions

Only enable the permissions you need:

Permission	Use Case
Read	Market data, account info
Spot Trading	Buy/sell on spot
Margin Trading	Margin orders (global only)
Futures Trading	Futures orders (global only)
Withdrawals	⚠️ Only if needed

IP Whitelisting

Always whitelist your server IP in Binance API settings.

Environment Variables

Never commit API keys. Use environment variables:

export BINANCE_API_KEY=your_key
export BINANCE_API_SECRET=your_secret

---

Example Prompts

Market Data

"Get the current BTC/USDT price on Binance"
"Show me the order book for ETH/USDT"
"Get 24h trading volume for BNB"

Trading

"Place a limit buy order for 0.01 BTC at $40,000"
"Sell 100 USDT worth of ETH at market price"
"Cancel order #12345"

Account

"Show my Binance spot balances"
"Get my recent trade history"
"What are my open orders?"

Futures (Global Only)

"Get my futures positions"
"Set leverage to 5x for BTC/USDT"
"Place a long position with stop loss"