mcp-server-cex-bn

What is mcp-server-cex-bn?

mcp-server-cex-bn is an MCP server that provides comprehensive integration with Binance’s spot and futures trading operations. It is designed for developers and traders who want to automate Binance trading via an MCP-compatible client.

How to use mcp-server-cex-bn?

Install via Smithery (npx -y @smithery/cli install mcp-server-cex-bn --client claude) or manually by cloning the repository, installing dependencies with pnpm install, configuring Binance API credentials in a .env file (variables BINANCE_API_KEY and BINANCE_API_SECRET), then building and starting the server. Tools such as configure_api_keys, create_spot_order, create_futures_order, get_balances, and get_futures_positions are invoked through MCP.

Key features of mcp-server-cex-bn

• Execute spot LIMIT and MARKET orders
• Create futures orders (LIMIT, MARKET, STOP, TAKE_PROFIT, TRAILING_STOP, etc.)
• Manage leverage from 1x to 125x for futures
• Monitor spot balances, open orders, and futures positions
• Support both one‑way and hedge position modes
• Retrieve funding rates and cancel existing orders

Use cases of mcp-server-cex-bn

• Automate spot trading strategies with limit and market orders
• Implement futures hedging and risk management with advanced order types
• Monitor and adjust leverage and positions across multiple symbols
• Build trading bots that require real‑time account balances and open orders
• Manage funding rate exposure in perpetual futures contracts

FAQ from mcp-server-cex-bn

What trading operations are supported?

Spot trading supports LIMIT and MARKET orders, balance checks, open order tracking, and order cancellation. Futures trading supports LIMIT, MARKET, STOP, TAKE_PROFIT, TRAILING_STOP_MARKET, and reduce‑only orders, plus leverage adjustment and position management.

How do I configure my Binance API keys?

API keys can be stored securely via the configure_api_keys tool or by setting environment variables BINANCE_API_KEY and BINANCE_API_SECRET in a .env file.

What are the Binance API rate limits for this server?

Default rate limits are 1200 requests per minute for order operations and 100 requests per second for market data. The server respects these limits and implements proper error handling for rate limit errors.

What position modes are available for futures?

Two position modes are supported: one‑way mode (single position per symbol) and hedge mode (separate long and short positions simultaneously). Each mode has its own margin and position management behavior.

What futures-specific errors can occur?

The server defines InsufficientMarginError, InvalidPositionModeError, and OrderValidationError for common futures trading issues, such as insufficient margin, wrong position mode, or invalid order parameters.