# muvon/mcp-binance-futures [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/muvon/mcp-binance-futures  
**GitHub Stars:** 6  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/muvon-mcp-binance-futures

## Description
MCP server for Binance USDT-M Futures trading — exposes tools for market data, account state, order management, and position/margin control.

## Tools
Capabilities this server exposes over MCP:

- **ping** — Test API connectivity
- **get_ticker** — Price, 24 h stats, mark price, funding rate for a symbol
- **get_order_book** — Top N bids/asks for a symbol
- **get_recent_trades** — Latest public trades
- **get_klines** — OHLCV candlestick data (1m → 1w)
- **get_symbol_info** — Trading rules: tick size, lot size, min notional, order types
- **get_balance** — Wallet balances (non-zero assets only)
- **get_positions** — Open positions with PnL, leverage, margin type — optionally scoped to one symbol
- **get_account_summary** — Total balance, unrealized PnL, margin usage, open position count
- **place_order** — Place LIMIT, MARKET, STOP, STOP\_MARKET, TAKE\_PROFIT, TAKE\_PROFIT\_MARKET, TRAILING\_STOP\_MARKET
- **modify_order** — Change price or quantity of an open LIMIT order
- **cancel_order** — Cancel a single order by ID
- **cancel_all_orders** — Cancel all open orders for a symbol
- **get_open_orders** — List all open orders for a symbol
- **get_order** — Get a specific order by ID
- **get_order_history** — Recent order history (all statuses)
- **get_trade_history** — Personal fill history for a symbol
- **set_leverage** — Set leverage multiplier (1–125×) for a symbol
- **set_margin_type** — Switch between `ISOLATED` and `CROSSED` margin
- **adjust_isolated_margin** — Add or remove margin from an isolated position
- **set_position_mode** — Switch between One-way and Hedge Mode
- **get_position_mode** — Get current position mode
- **get_leverage_brackets** — Leverage tiers with maintenance margin rates

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `python` (confidence: high):

```json
"mcpServers": {
  "mcp-binance-futures": {
    "command": "python",
    "args": ["server.py"],
    "env": {
      "BINANCE_API_KEY": "",
      "BINANCE_API_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `BINANCE_API_KEY`, `BINANCE_API_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What muvon/mcp-binance-futures MCP server does

The muvon/mcp-binance-futures MCP server connects an MCP client to Binance USDT-M Futures. It covers both public market information and authenticated futures-account operations. Market tools can return ticker data, mark price, funding rate, order-book levels, recent trades, candlesticks, and symbol trading rules such as tick size, lot size, minimum notional, and supported order types.

Signed tools expose non-zero wallet balances, open positions, account totals, unrealized PnL, margin usage, and the number of open positions. Trading operations support creating several Binance order types, changing or cancelling orders, reviewing open and historical orders, and reading personal fills. Position controls include leverage, margin type, isolated-margin adjustments, and one-way or hedge mode.

## Tools and capabilities

The available tools fall into four practical groups:

- Market inspection: `get_ticker`, `get_order_book`, `get_recent_trades`, `get_klines`, `get_symbol_info`, and `ping`.
- Account state: `get_balance`, `get_positions`, and `get_account_summary`.
- Order handling: `place_order`, `modify_order`, `cancel_order`, `cancel_all_orders`, `get_open_orders`, `get_order`, `get_order_history`, and `get_trade_history`.
- Position and risk settings: `set_leverage`, `set_margin_type`, `adjust_isolated_margin`, `set_position_mode`, `get_position_mode`, and `get_leverage_brackets`.

Order creation supports LIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, and TRAILING_STOP_MARKET orders. Leverage can be set from 1× through 125×, and margin can be switched between `ISOLATED` and `CROSSED`.

## Setup and configuration

The muvon/mcp-binance-futures MCP server requires Python 3.11 or newer. The repository recommends `uv`, although installation with pip is also documented. Start the stdio server with `python server.py`, or use the installed `mcp-binance-futures` script after setting up the project.

Authenticated operations require two environment variables: `BINANCE_API_KEY` and `BINANCE_API_SECRET`. The Binance API key must have Futures trading enabled. Public market-data tools do not require authentication. A Claude Desktop configuration can launch the server with Python and pass these variables through its `env` section.

The project uses FastMCP for MCP wiring and httpx for HTTP requests. Its client layer handles request signing, transport, and error parsing, while the server layer defines the tools.

## Limitations and notes

This server is specifically for Binance USDT-M Futures rather than general Binance products. Public and signed operations have different credential requirements, so account and trading calls cannot be used without valid Binance credentials. Because the tools can place orders, change leverage, alter margin settings, and close positions, API-key permissions should be restricted and IP whitelisting should be considered.

The documented examples use local stdio execution. The repository’s tests mock HTTP calls with respx, so they do not require real API keys or network access. No claim is provided here about support for MCP clients other than the documented Claude Desktop setup.

_Full upstream README: https://allmcps.com/mcp/muvon-mcp-binance-futures/readme_