Binance MCP Server
0nebean/binance-mcp-server
Acesso unificado Binance Spot + Futures para agentes IA com análise técnica
Ver no GitHubServidor MCP que unifica mercados Spot, USDT-M e Coin-M da Binance em interfaces amigáveis para IA, com ferramentas estruturadas para análise e trading automatizado. Oferece acesso a dados públicos, análises técnicas e operações de trading com guardrails de segurança (demo/testnet por padrão).
Instalação
npx convez-ai 0nebean/binance-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes IA analisando dados de mercado Binance em tempo real
- Workflows de trading automatizado com testnet/demo seguros
- Análise técnica multi-timeframe e comparação de símbolos
- Integração de dados Spot e Futures em sistemas de decisão
Veredito

Ferramenta robusta e bem estruturada para agentes IA acessarem mercados Binance com segurança. A separação clara entre ambientes (demo/testnet/produção) e o suporte unificado a três tipos de mercado a tornam valiosa para trading automatizado enterprise, embora exija conhecimento técnico sólido de criptografia e APIs.
README
A tradução para o português deste README ainda está na fila.
Binance MCP Server
Binance Spot market data and guarded trading MCP server for AI analysis and demo/testnet order workflows.
Scope
This server exposes public REST market data endpoints, AI-friendly analysis tools, and guarded signed Spot order tools. Trading tools are disabled by default and require explicit environment flags plus confirm: true for write operations. Production trading has a separate safety gate.
Supported environments:
demo->https://demo-api.binance.comtestnet->https://testnet.binance.visionproduction->https://api.binance.com
BINANCE_BASE_URL can override the built-in URL mapping for public market data. BINANCE_SIGNED_BASE_URL can override the URL for signed account/order endpoints. This lets you use https://data-api.binance.vision for public market data while using https://demo-api.binance.com, https://testnet.binance.vision, or https://api.binance.com for signed endpoints.
Tools
Spot market data
Existing unprefixed tools are Spot-compatible and kept for backward compatibility. New spot_* aliases make account type explicit.
spot_get_server_timespot_get_exchange_infospot_get_symbol_pricespot_get_24hr_tickerspot_get_order_bookspot_get_recent_tradesspot_get_aggregate_tradesspot_get_klinesspot_get_avg_pricespot_get_ui_klines
Backward-compatible unprefixed Spot tools:
get_server_timeget_exchange_infoget_symbol_priceget_24hr_tickerget_order_bookget_recent_tradesget_aggregate_tradesget_klinesget_avg_priceget_ui_klines
AI-friendly summaries
summarize_24hr_tickersummarize_order_booksummarize_klinesanalyze_technical_indicatorsanalyze_multi_timeframe_trendcompare_symbols
Spot trading and signed account tools
spot_get_account_infospot_get_open_ordersspot_get_orderspot_test_orderspot_place_orderspot_cancel_orderspot_cancel_open_orders
Backward-compatible unprefixed Spot signed tools:
test_orderplace_orderget_orderget_open_orderscancel_ordercancel_open_ordersget_account_info
USD-M Futures market tools
futures_get_server_timefutures_get_exchange_infofutures_get_symbol_pricefutures_get_24hr_tickerfutures_get_order_bookfutures_get_klinesfutures_get_mark_pricefutures_get_funding_ratefutures_get_mark_price_klinesfutures_get_index_price_klinesfutures_get_premium_index_klines
USD-M Futures account, position, and trading tools
futures_get_account_infofutures_get_balancefutures_get_position_riskfutures_get_open_ordersfutures_get_orderfutures_get_leverage_bracketfutures_get_income_historyfutures_get_position_modefutures_change_position_modefutures_test_orderfutures_place_orderfutures_place_batch_ordersfutures_cancel_orderfutures_cancel_batch_ordersfutures_cancel_open_ordersfutures_change_leveragefutures_change_margin_type
COIN-M Futures market tools
coin_futures_get_server_timecoin_futures_get_exchange_infocoin_futures_get_symbol_pricecoin_futures_get_24hr_tickercoin_futures_get_order_bookcoin_futures_get_klinescoin_futures_get_continuous_klinescoin_futures_get_mark_pricecoin_futures_get_funding_ratecoin_futures_get_open_interest
COIN-M Futures account, position, and trading tools
coin_futures_get_account_infocoin_futures_get_balancecoin_futures_get_position_riskcoin_futures_get_income_historycoin_futures_get_leverage_bracketcoin_futures_get_position_modecoin_futures_change_position_modecoin_futures_get_open_orderscoin_futures_get_ordercoin_futures_test_ordercoin_futures_place_ordercoin_futures_cancel_ordercoin_futures_cancel_open_orderscoin_futures_change_leveragecoin_futures_change_margin_type
Install
npm install
npm run build
Development
npm run dev
Configuration
Copy .env.example to .env if you want local overrides.
BINANCE_ENV=demo
BINANCE_BASE_URL=
BINANCE_SIGNED_BASE_URL=
BINANCE_FUTURES_BASE_URL=
BINANCE_FUTURES_SIGNED_BASE_URL=
BINANCE_COIN_FUTURES_BASE_URL=
BINANCE_COIN_FUTURES_SIGNED_BASE_URL=
BINANCE_API_KEY=
BINANCE_API_SECRET=
BINANCE_SECRET_KEY=
BINANCE_PROXY_URL=
BINANCE_DEFAULT_RECV_WINDOW=5000
BINANCE_ENABLE_TRADING=false
BINANCE_ALLOW_PRODUCTION_TRADING=false
BINANCE_REQUEST_TIMEOUT_MS=10000
BINANCE_EXCHANGE_INFO_CACHE_TTL_MS=300000
BINANCE_MAX_KLINES_LIMIT=1000
BINANCE_DEBUG=false
Cursor MCP configuration
After building the project, add a server similar to this in your Cursor MCP configuration:
{
"mcpServers": {
"binance": {
"command": "node",
"args": [
"{YOUR_PROJECT_PATH}/dist/index.js"
],
"env": {
"BINANCE_ENV": "production",
"BINANCE_BASE_URL": "https://data-api.binance.vision",
"BINANCE_SIGNED_BASE_URL": "https://api.binance.com",
"BINANCE_ENABLE_TRADING": "true",
"BINANCE_ALLOW_PRODUCTION_TRADING": "true",
"BINANCE_PROXY_URL": "socks5h://127.0.0.1:1080",
"BINANCE_API_KEY": "{YOUR_BINANCE_API_KEY}",
"BINANCE_API_SECRET": "{YOUR_BINANCE_API_SECRET}",
"BINANCE_REQUEST_TIMEOUT_MS": "10000",
"BINANCE_MAX_KLINES_LIMIT": "1000"
}
}
}
}
Trading safety
Signed account and order tools require BINANCE_API_KEY and BINANCE_API_SECRET. Trading write operations are disabled by default.
For Demo/Testnet trading:
BINANCE_ENV=demo
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret
BINANCE_SIGNED_BASE_URL=https://demo-api.binance.com
BINANCE_ENABLE_TRADING=true
BINANCE_ALLOW_PRODUCTION_TRADING=false
For production trading, BINANCE_ALLOW_PRODUCTION_TRADING=true is also required. Only enable it if you intentionally accept real trading risk.
Test an order without placing it:
{
"symbol": "BTCUSDT",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"quantity": "0.001",
"price": "50000",
"confirm": true
}
Place an order:
{
"symbol": "BTCUSDT",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"quantity": "0.001",
"price": "50000",
"confirm": true
}
Analysis examples
Technical indicators:
{
"symbol": "BTCUSDT",
"interval": "1h",
"limit": 200,
"indicators": ["MA", "EMA", "RSI", "MACD", "BOLL"]
}
Multi-timeframe trend:
{
"symbol": "BTCUSDT",
"intervals": ["15m", "1h", "4h", "1d"],
"limit": 200
}
Compare symbols:
{
"symbols": ["BTCUSDT", "ETHUSDT", "BNBUSDT"],
"interval": "1d",
"limit": 7
}
Notes
get_symbol_pricecan return all market prices whensymbolis omitted.- Other large market tools require
symbolorsymbolsto avoid excessive MCP context usage. - Most tools accept
raw: trueto return the original Binance API payload. - When
BINANCE_API_KEYis configured, requests include theX-MBX-APIKEYheader. BINANCE_PROXY_URLcan route all Binance REST requests through a proxy, for examplesocks5://127.0.0.1:1080,socks5h://127.0.0.1:1080,http://127.0.0.1:7890, orhttps://127.0.0.1:7890.BINANCE_API_SECRETis reserved for future signed private endpoints and is not used by the current read-only tools.- Responses include a
rateLimitobject extracted from Binance response headers when available. exchangeInfois cached according toBINANCE_EXCHANGE_INFO_CACHE_TTL_MS.