muvon/mcp-binance-futures

MCP Server

Binance USDT-M Futures MCP Server - market data, orders, positions, margin (requires uvx)

Binance USDT-M Futures MCP server by Muvon. Exposes market data, account state, order management, and position/margin control so an agent can monitor, place, and manage perpetual futures trades.

MCP Server

  • Package: mcp-binance-futures (PyPI, pinned)
  • Transport: stdio
  • Command: uvx mcp-binance-futures==0.1.0

Authentication

Create a Binance API key with Futures trading enabled. Use IP whitelisting; never commit keys.

VariableRequiredDescription
BINANCE_API_KEYyes (signed tools)API key with Futures permission
BINANCE_API_SECRETyes (signed tools)API secret

Public market-data tools work without keys; account, order, and position tools require both variables.

Available Tools

ToolDescription
pingTest API connectivity
get_tickerPrice, 24h stats, mark price, funding rate
get_order_bookTop N bids/asks
get_recent_tradesLatest public trades
get_klinesOHLCV candles (1m → 1w)
get_symbol_infoTick size, lot size, min notional, order types
get_balanceWallet balances (non-zero assets)
get_positionsOpen positions with PnL, leverage, margin type
get_account_summaryTotal balance, unrealized PnL, margin usage
place_orderLIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET
modify_orderChange price or quantity of an open LIMIT order
cancel_orderCancel a single order by ID
cancel_all_ordersCancel all open orders for a symbol
get_open_ordersList open orders for a symbol
get_orderGet a specific order by ID
get_order_historyRecent order history (all statuses)
get_trade_historyPersonal fill history for a symbol
set_leverageSet leverage multiplier (1–125x)
set_margin_typeSwitch ISOLATED / CROSSED
adjust_isolated_marginAdd or remove isolated margin
set_position_modeOne-way or Hedge mode
get_position_modeCurrent position mode
get_leverage_bracketsLeverage tiers and maintenance margin rates

Configuration Example

toml
[[mcp.servers]]
name = "binance-futures"
type = "stdio"
command = "uvx"
args = ["mcp-binance-futures==0.1.0"]
timeout_seconds = 60
tools = []
env = { BINANCE_API_KEY = "{{ENV:BINANCE_API_KEY}}", BINANCE_API_SECRET = "{{ENV:BINANCE_API_SECRET}}" }