Binance

You deploy the Binance MCP Server to enable AI assistants and MCP-compatible clients to interact with the Binance exchange. It exposes 478+ tools across the Binance API, supports secure local credentials, and works with both desktop MCP clients and web-based interfaces.

How to use

You connect an MCP client to the Binance MCP Server using either STDIO (for desktop applications like Claude Desktop or Cursor) or SSE (for web apps and ChatGPT). Once connected, you can perform trading, manage accounts, fetch market data, and automate strategies using natural language prompts.

How to install

Prerequisites: Node.js 18 or later and a Binance account with API credentials. You also need an MCP-compatible client.

Clone the project, install dependencies, and build the server:

# 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

Optionally run the interactive setup to configure your environment and choose the transport method:

npm run init

Start the server using STDIO transport for desktop clients or SSE transport for web apps:

# STDIO transport (Claude Desktop, Cursor)
npm run start

# SSE transport (ChatGPT, Web Apps)
npm run start:sse

For development with hot reloading, use the development commands:

npm run dev      # STDIO
npm run dev:sse  # SSE

Configuration and usage notes

Set your Binance API credentials in the environment before starting the server. Create a .env file in the project root with the following values:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here

Run the server with STDIO transport and ensure your client is configured to connect to the local process. You can also use SSE transport by starting the SSE server and connecting to http://localhost:3000/sse.

Client configuration examples

Configure your MCP client with the following settings to run the Binance MCP Server locally. Replace paths and keys with your actual values.

# Claude Desktop / equivalent MCP client config
{
  "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"
      }
    }
  }
}

For Cursor-style integration, add a similar block to your MCP settings with the same environment variables.

Usage examples

Ask your MCP client to perform trading actions, fetch market data, or manage your portfolio using natural language prompts. Examples of prompts include checking balances, placing orders, and retrieving market data.

Security and best practices

Protect your API credentials and never commit the .env file. Use IP restrictions and withdrawal limits where possible to reduce risk.

Available tools

Spot Trading

Execute market and limit orders, fetch market data, and manage spot accounts.

Futures USD-M

Trade perpetual futures with USD-margined contracts and manage positions.

Futures COIN-M

Trade coin-margined futures contracts and monitor positions.

Margin Trading

Cross and isolated margin trading features and borrowing.

Options

European-style options trading and related data.

Wallet

Deposits, withdrawals, transfers, and asset management.

Sub-Account

Create and manage multiple sub-accounts under a main account.

Staking

Stake assets like ETH, SOL, and other supported tokens.

Auto-Invest

Recurring buys and DCA-based investment plans.

NFT

Interact with NFT marketplace data and actions.

Copy Trading

Lead trader features and copying strategies.

Pay

Binance Pay transactions and related activities.

Gift Card

Create and redeem gift cards.