Binance MCP

What This Server Does

binance-mcp exposes a focused set of MCP tools for working with Binance data from Claude Desktop or any MCP-compatible client.

It covers:

• Live spot prices

• Best bid/ask quotes

• Spot account balances

• Funding wallet balances

• Combined account and portfolio views

• Binance Convert quote and order workflows

• Convert trade history

Related MCP server: mcp-binance-futures

Tools

Why This MCP Is Useful

• Keeps Binance workflows inside your AI assistant instead of switching between apps.

• Separates safe quote retrieval from live trade execution.

• Uses short-lived market-data caching and websocket updates for fast price lookups.

• Returns structured JSON so Claude can reason over balances, prices, and conversions cleanly.

Quick Start

1. Install dependencies

npm install

2. Build the server

npm run build

3. Run locally

npm start

The server communicates over stdio, which is the standard transport used by Claude Desktop.

Full Documentation

If you want the deeper implementation notes, endpoint details, and design rationale, see DOCUMENTATION.md.

Claude Desktop Setup

Use the compiled server entry point in your claude_desktop_config.json file.

Example configuration

{
  "mcpServers": {
    "binance-mcp": {
      "command": "node",
      "args": ["C:/Binance-mcp/build/index.js"],
      "env": {
        "BINANCE_API_KEY": "your_api_key",
        "BINANCE_API_SECRET": "your_api_secret"
      }
    }
  }
}

Notes

• Public market tools work without credentials.

• Account and Convert tools require BINANCE_API_KEY and BINANCE_API_SECRET.

• If you want to customize Binance endpoints, you can override the environment variables listed below.

Environment Variables

Example Usage

Price lookup

Get the latest price for BTCUSDT and ETHUSDT.

Portfolio snapshot

Show my portfolio snapshot in USDT.

Convert flow

Create a Convert quote from BTC to USDT for 0.01 BTC, then show the quote details.

Build and Implementation Details

This project is implemented in TypeScript and uses the official MCP SDK.

• src/index.ts registers MCP tools and formats responses.

• src/binance.ts handles Binance REST calls, HMAC signing, websocket market data, retries, and portfolio math.

• build/index.js is the compiled entry point used by Claude Desktop.

Safety

• accept_convert_quote performs a live conversion.

• Signed endpoints are unavailable until API credentials are present.

• Convert quotes should always be reviewed before execution.

• Binance rate limits still apply, so avoid unnecessary polling.

License

Released under the MIT License. See LICENSE.