Skip to main content
Glama
binance-mcp

binance-mcp

by mujeeb8

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

Tool

Purpose

Auth

get_last_prices

Fetch latest last-traded prices for one or more spot symbols

No

get_book_ticker

Fetch current best bid and ask for one or more spot symbols

No

get_spot_account

Return spot account balances and account flags

Yes

get_funding_wallet

Return funding wallet balances

Yes

get_account_overview

Merge spot and funding balances into one view

Yes

get_portfolio_snapshot

Build a live valuation snapshot across balances and prices

Yes

get_convert_quote

Request a Binance Convert quote without executing it

Yes

accept_convert_quote

Execute a live Convert quote

Yes

get_convert_order_status

Check the status of a Convert order

Yes

get_convert_trade_history

Fetch Convert trade history for a time window

Yes

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

Variable

Default

Purpose

BINANCE_API_KEY

none

Binance API key for signed endpoints

BINANCE_API_SECRET

none

Binance API secret for request signing

BINANCE_BASE_URL

https://api.binance.com

Base URL for signed REST requests

BINANCE_PUBLIC_BASE_URL

https://data-api.binance.vision

Base URL for public market-data requests

BINANCE_STREAM_BASE_URL

wss://stream.binance.com:9443/stream

Binance websocket stream endpoint

BINANCE_TIMEOUT_MS

8000

Request timeout in milliseconds

BINANCE_RECV_WINDOW_MS

5000

Binance signed request recvWindow

BINANCE_MAX_RETRIES

1

Retry attempts for safe requests

BINANCE_PRICE_CACHE_TTL_MS

1500

Freshness window for market-data cache

BINANCE_STREAM_ENABLED

true

Enables websocket price streaming

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.

Available Tools

10 tools
accept_convert_quoteA

Execute a Binance Convert quote. This performs a live conversion.

Inputs: quoteId (required).

get_account_overviewB

Get a combined overview of spot account balances and funding wallet balances.

Inputs: asset, needBtcValuation, omitZeroBalances.

get_book_tickerA

Get the current best bid and ask for one or more Binance spot symbols.

Inputs: symbols (required).

get_convert_order_statusA

Check the status of a Binance Convert order by orderId or quoteId.

Inputs: orderId, quoteId.

get_convert_quoteA

Request a Binance Convert quote. This does not execute the conversion.

Inputs: toAsset (required), fromAsset (required), toAmount, validTime, +2 more.

get_convert_trade_historyA

Get Binance Convert trade history for a 30-day window or less.

Inputs: endTime (required), startTime (required), limit.

get_funding_walletB

Get the Binance funding wallet balances.

Inputs: asset, needBtcValuation.

get_last_pricesA

Get the latest Binance last-traded prices for one or more spot symbols.

Inputs: symbols (required).

get_portfolio_snapshotC

Get balances and a live valuation snapshot in one call.

Inputs: needBtcValuation, omitZeroBalances, valuationQuoteAsset.

get_spot_accountB

Get the current Binance spot account, including balances and account flags.

Inputs: omitZeroBalances.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation3/5

    There is notable overlap among get_funding_wallet, get_spot_account, get_account_overview, and get_portfolio_snapshot, all of which return balance-related information. While descriptions differentiate them, the boundaries are not immediately clear, and get_account_overview vs get_portfolio_snapshot could easily be confused.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: get_ for queries and accept_ for the conversion action. The naming is predictable and uniform across the entire set.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its focus on account/portfolio reads and Convert operations. Each tool serves a distinct purpose without unnecessary bloat.

    Completeness3/5

    The server covers account balances, Convert quotes/execution/status/history, and basic market data, but it lacks core Binance trading features such as placing/canceling spot orders or retrieving order history. This leaves significant gaps if a broader Binance workflow is expected.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Comprehensive Binance Futures trading MCP server with 41 professional trading tools across account management, order execution, market data, and risk management. Features smart ticker caching, secure authentication, and Docker support for seamless integration with MCP clients.
      88 PyPI
      4
      Python
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Binance USDT-M Futures trading — exposes tools for market data, account state, order management, and position/margin control.
      23
      8
      Apache 2.0