Binance MCP Server

Multi-language Documentation

• English (current)
• 中文
• 日本語

A Model Context Protocol (MCP) server that provides Claude Code with Binance exchange API functionality.

Quick Start# 📹 Video Tutorial

Watch our comprehensive MCP usage tutorial to get started quickly:

Note: For the full video tutorial, you can also find it in docs/mcp-usage-tutorial.mp4.

Installation

npm install -g binance-mcp-server

Configuration

This MCP server can be used with various AI tools that support MCP:

MCP Configuration

Add the following configuration to your MCP settings file:

Claude Desktop: claude_desktop_config.json
Cursor: .cursor/mcp_config.json

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["binance-mcp-server"],
      "env": {
        "BINANCE_API_KEY": "your_api_key",
        "BINANCE_API_SECRET": "your_api_secret",
        "BINANCE_TESTNET": "true"
      }
    }
  }
}

Environment Setup## Getting API Keys

For Testnet (Recommended for Development):

1. Visit Binance Testnet
2. Create a testnet account (no real verification required)
3. Go to API Management in your testnet account
4. Create a new API key with trading permissions
5. Note: Testnet uses virtual funds - completely safe for testing

For Mainnet (Production):

1. Create a verified account on Binance
2. Complete KYC verification
3. Go to API Management in your account settings
4. Create a new API key with required permissions
5. ⚠️ Warning: Mainnet uses real money - be very careful!

Configuration

Create .env file:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
BINANCE_TESTNET=true  # Set to false for mainnet (REAL money)

Available Tools# Market Data

• get_price - Get current price for trading pair
• get_orderbook - Get order book depth data
• get_klines - Get K-line/candlestick data
• get_24hr_ticker - Get 24-hour price statistics

Account

• get_account_info - Get account information and balances
• get_open_orders - Get current open orders
• get_order_history - Get historical orders

Trading (Mainnet & Testnet)

• place_order - Place a new order (supports both mainnet and testnet)
• cancel_order - Cancel specific order (supports both mainnet and testnet)
• cancel_all_orders - Cancel all open orders (supports both mainnet and testnet)

Usage Examples

Ask Claude to:

• "Get the current price of Bitcoin"
• "Show me the order book for ETHUSDT"
• "Check my account balance"
• "Place a limit buy order for 0.001 BTC at $50,000"

Security

⚠️ Important:

• Set BINANCE_TESTNET=true for safe testing with virtual funds
• Set BINANCE_TESTNET=false or omit for mainnet trading with REAL money
• Mainnet trading will display warnings before executing orders

Development

npm run build    # Compile TypeScript
npm run dev      # Development mode
npm run lint     # Run linting