binance-mcp
The binance-mcp server is a Model Context Protocol (MCP) server that provides programmatic access to Binance Spot exchange data and trading functionality through standardized tools.
Market Data (Public)
Retrieve real-time ticker prices for any trading symbol
Fetch historical klines/candlestick data with customizable intervals and limits (1-1000 candles) for technical analysis
Access comprehensive exchange metadata including trading rules, symbol filters, and specifications
Account Management (Requires API Key)
View account balances across all assets
List open orders for specific trading symbols
Trading Operations (Requires API Key + BINANCE_TRADE_ENABLED)
Place MARKET or LIMIT spot orders (BUY/SELL) with configurable parameters like quantity, price, quote amount, and time-in-force settings
Cancel existing orders by symbol and order ID
Safety & Security Features
Protected by
BINANCE_TRADE_ENABLEDenvironment variable toggle for read-only modeConfigurable recvWindow parameter to prevent replay attacks
Support for both mainnet and testnet Binance environments for risk-free testing
Deployment & Integration
Supports stdio (default) and HTTP transports for local agent integration or web inspection
Compatible with Docker containerization and tools like Glama
JSON-formatted responses optimized for LLM and AI agent consumption
Provides tools for accessing Binance Spot REST API, including market data (ticker prices, klines, exchange info), account management (balances, open orders), and trading operations (place and cancel orders) with configurable safety controls.
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 get the current price of BTCUSDT"
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
Binance Spot REST MCP server providing market data, account state, and guarded trading tools. Built with FastMCP so it can run over stdio (local agents) or HTTP (Glama inspection / Docker deployments).
Features
Latest ticker price, klines, and
exchangeInfofor any symbol.Account tools (balances, open orders) with recvWindow helper.
Trading helpers (place/cancel) protected by
BINANCE_TRADE_ENABLEDtoggle.Works with Glama thanks to HTTP transport +
glama.yaml/Dockerfilemetadata.
Related MCP server: binance-futures-mcp
Getting started
Install dependencies (Node 20+ recommended):
npm installCopy the example env file and fill in your Binance key/secret (testnet keys work too):
cp .env.example .env # BINANCE_TRADE_ENABLED=false keeps the server in read-only modeBuild + run (stdio transport by default):
npm run build npm startDevelopment / watch mode:
npm run dev
HTTP transport
Set MCP_TRANSPORT=http and optionally PORT to expose the tools over HTTP (required for Glama inspection):
MCP_TRANSPORT=http PORT=8080 npm run devThe provided Dockerfile bakes this configuration automatically.
Tools
name | description |
| Latest ticker price for a symbol. |
| Candles (symbol + interval, configurable limit). |
| Full exchange metadata + filters. |
| Account snapshot (requires API key/secret). |
| Open orders for a symbol. |
| Places MARKET/LIMIT orders with guardrails. |
| Cancels an order by symbol + orderId. |
All tools return JSON payloads stringified for LLM consumption.
Environment variables
key | description |
| Required for account/trade tools (public tools work without). |
| Required for account/trade tools. |
| Defaults to |
| RecvWindow in ms (default |
| Set to |
|
|
| HTTP port when using |
Glama & Docker
glama.yaml/glama.jsondefine build/start commands and required env vars.Dockerfilebuilds a production image, exposes port8080, and defaults to HTTP transport for inspection support.
License
Released under the MIT License (see LICENSE).
Available Tools
7 toolsbinance_account_balancesB
Get account balances (requires API key & secret).
Inputs: no named parameters.
binance_account_openOrdersC
List open orders for a symbol.
Inputs: symbol (required).
binance_market_exchangeInfoB
Get exchange information including filters per symbol.
Inputs: no named parameters.
binance_market_klinesC
Get historical klines/candles for a symbol and interval.
Inputs: symbol (required), interval (required), limit.
binance_market_priceC
Get the latest price for a symbol (e.g. BTCUSDT).
Inputs: symbol (required).
binance_trade_cancelOrderC
Cancel a spot order by symbol and orderId.
Inputs: symbol (required), orderId (required).
binance_trade_placeOrderC
Place a spot order. Example: {symbol:'BTCUSDT', side:'BUY', type:'MARKET', quoteOrderQty:'50'}
Inputs: symbol (required), side (required), type (required), quantity, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose targeting different aspects of the Binance API: account balances, open orders, market data (exchange info, klines, price), and trade operations (place/cancel orders). There is no overlap or ambiguity between tools, making it easy for an agent to select the right one.
All tools follow a consistent 'binance_<category>_<action>' naming pattern (e.g., binance_account_balances, binance_market_klines). This structured approach makes the tool set predictable and easy to understand, with no deviations in style or convention.
With 7 tools, this server is well-scoped for its purpose of interacting with the Binance API. It covers essential areas like account management, market data, and trading without being overwhelming or too sparse, making each tool earn its place in the set.
The tool set provides strong coverage for core Binance operations, including account info, market data, and basic trading (place/cancel orders). A minor gap is the lack of tools for more advanced trading features like order history or portfolio management, but agents can still handle most common workflows effectively.
Maintenance
Related MCP Connectors
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
Unified gateway hosting 5 Hive Civilization MCP servers (evaluator, trade, depin, compute-grid…
Cloudflare Workers MCP server: crypto-signal
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceThis server provides a robust interface for Binance spot trading operations, including secure management of API credentials, execution and management of spot orders, and monitoring of account balances and open orders.13MIT
- 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
- MIT
- FlicenseNot gradedqualityCmaintenanceMCP server providing access to Binance public market data, including klines, order book depth, and 24hr ticker.-