@node2flow/binance-mcp

MCP server for Binance Global — the world's largest cryptocurrency exchange. 23 tools for market data, trading, orders, and account management via the Model Context Protocol.

Quick Start

Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["-y", "@node2flow/binance-mcp"],
      "env": {
        "BINANCE_API_KEY": "your-api-key",
        "BINANCE_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Note: API keys are optional. 11 market data tools work without authentication.

HTTP Mode

BINANCE_API_KEY=xxx BINANCE_SECRET_KEY=xxx npx @node2flow/binance-mcp --http

MCP endpoint: http://localhost:3000/mcp

Cloudflare Worker

Available at: https://binance-mcp-community.node2flow.net/mcp

POST https://binance-mcp-community.node2flow.net/mcp?BINANCE_API_KEY=xxx&BINANCE_SECRET_KEY=xxx

Tools (23)

Market Data (11) — Public, No API Key Required

Trading (7) — Requires API Key

Account (2) — Requires API Key

User Data Stream (3) — Requires API Key

Test Orders (Safe Trading)

Binance provides a test order endpoint that validates all parameters without executing:

bn_test_order → validates symbol, quantity, price, filters
bn_new_order  → actually places the order (REAL MONEY)

Always use bn_test_order first to verify your order parameters are valid before placing a real order with bn_new_order.

API Key Setup

1. Go to Binance API Management

2. Create a new API key

3. Enable permissions:

   • Enable Reading — Required for account/order queries

   • Enable Spot Trading — Required for placing/canceling orders

4. Recommended: Set IP whitelist for security

Security Best Practices

• Never share your API key or secret key

• Use IP whitelist on Binance to restrict API access

• Disable withdrawal permission unless absolutely needed

• Use test orders (bn_test_order) before real trades

• Start with small amounts when testing real orders

• Monitor open orders regularly with bn_open_orders

Rate Limits

Binance enforces the following rate limits:

Rate limit headers are included in API responses:

• X-MBX-USED-WEIGHT-1M — Current weight used

• X-MBX-ORDER-COUNT-10S — Orders in 10 seconds

• X-MBX-ORDER-COUNT-1D — Orders in 1 day

Symbol Format

Symbols are uppercase with no separator:

• BTCUSDT — Bitcoin / Tether

• ETHUSDT — Ethereum / Tether

• BNBBTC — BNB / Bitcoin

• SOLUSDT — Solana / Tether

Use bn_exchange_info to get the full list of available symbols.

Testnet

Binance provides a testnet for development:

• API: https://testnet.binance.vision/api

• Create testnet keys at: https://testnet.binance.vision/

Note: This MCP server connects to the production API by default.

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package

• Binance API

• MCP Protocol

• Node2Flow