binance-mcp
Provides tools for live spot prices, best bid/ask quotes, spot and funding wallet balances, account overview, portfolio snapshot, and Binance Convert workflow including quoting, executing, and checking trades.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@binance-mcp show my portfolio snapshot in USDT"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Fetch latest last-traded prices for one or more spot symbols | No |
| Fetch current best bid and ask for one or more spot symbols | No |
| Return spot account balances and account flags | Yes |
| Return funding wallet balances | Yes |
| Merge spot and funding balances into one view | Yes |
| Build a live valuation snapshot across balances and prices | Yes |
| Request a Binance Convert quote without executing it | Yes |
| Execute a live Convert quote | Yes |
| Check the status of a Convert order | Yes |
| 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 install2. Build the server
npm run build3. Run locally
npm startThe 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_KEYandBINANCE_API_SECRET.If you want to customize Binance endpoints, you can override the environment variables listed below.
Environment Variables
Variable | Default | Purpose |
| none | Binance API key for signed endpoints |
| none | Binance API secret for request signing |
|
| Base URL for signed REST requests |
|
| Base URL for public market-data requests |
|
| Binance websocket stream endpoint |
|
| Request timeout in milliseconds |
|
| Binance signed request recvWindow |
|
| Retry attempts for safe requests |
|
| Freshness window for market-data cache |
|
| 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.tsregisters MCP tools and formats responses.src/binance.tshandles Binance REST calls, HMAC signing, websocket market data, retries, and portfolio math.build/index.jsis the compiled entry point used by Claude Desktop.
Safety
accept_convert_quoteperforms 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 toolsaccept_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
Scored across 10 tools
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.
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.
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.
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
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Real-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceComprehensive 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 PyPI4PythonMIT
- AlicenseAqualityCmaintenanceMCP server for Binance USDT-M Futures trading — exposes tools for market data, account state, order management, and position/margin control.238Apache 2.0
- FlicenseNot gradedqualityCmaintenanceMCP server providing access to Binance public market data, including klines, order book depth, and 24hr ticker.-
- FlicenseBqualityDmaintenanceCustom MCP server for Binance Futures, providing market data, trading, and quant tools.19-