mcp-binance-futures
The mcp-binance-futures server provides comprehensive access to Binance USDT-M Futures trading, enabling market analysis, account management, order execution, and position control.
Market Data (no authentication required)
ping— Test API connectivityget_ticker— Latest price, 24h stats, mark/index price, and funding rateget_order_book— Top N bids and asks (5–1000 depth levels)get_recent_trades— Most recent public trades for a symbolget_klines— OHLCV candlestick data (intervals: 1m to 1w)get_symbol_info— Trading rules (tick size, lot size, min notional, max leverage, order types)
Account Management (requires API keys)
get_balance— Wallet balances for all non-zero assetsget_positions— Open positions with PnL, leverage, margin type, and liquidation priceget_account_summary— Total balance, unrealized PnL, margin usage, and open position count
Order Management (requires API keys)
place_order— Place LIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, or TRAILING_STOP_MARKET ordersmodify_order— Change price or quantity of an existing open LIMIT ordercancel_order— Cancel a single order by ID (supports regular and algo/conditional orders)cancel_all_orders— Cancel all open orders for a symbolget_open_orders— List all open orders (regular, algo, or all)get_order— Retrieve a specific order by order ID or client order IDget_order_history— Recent order history for a symbolget_trade_history— Personal fill/execution history for a symbol
Position & Margin Control (requires API keys)
set_leverage— Set leverage multiplier (1–125×) for a symbolset_margin_type— Switch between ISOLATED and CROSSED margin modeadjust_isolated_margin— Add or remove margin from an isolated positionset_position_mode— Switch between One-way and Hedge modeget_position_mode— Check the current position modeget_leverage_brackets— View leverage tiers and maintenance margin rates
Provides tools for monitoring and trading Binance USDT-M Futures, including access to market data, account balances, position management, and order execution.
mcp-binance-futures
MCP server for Binance USDT-M Futures trading. Exposes tools for market data, account state, order management, and position/margin control — designed to give an LLM everything it needs to monitor, place, and manage futures trades.
Tools
Market Data (public, no auth)
Tool | Description |
| Test API connectivity |
| Price, 24 h stats, mark price, funding rate for a symbol |
| Top N bids/asks for a symbol |
| Latest public trades |
| OHLCV candlestick data (1m → 1w) |
| Trading rules: tick size, lot size, min notional, order types |
Account (signed)
Tool | Description |
| Wallet balances (non-zero assets only) |
| Open positions with PnL, leverage, margin type — optionally scoped to one symbol |
| Total balance, unrealized PnL, margin usage, open position count |
Orders (signed)
Tool | Description |
| Place LIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET |
| Change price or quantity of an open LIMIT order |
| Cancel a single order by ID |
| Cancel all open orders for a symbol |
| List all open orders for a symbol |
| Get a specific order by ID |
| Recent order history (all statuses) |
| Personal fill history for a symbol |
Position Management (signed)
Tool | Description |
| Set leverage multiplier (1–125×) for a symbol |
| Switch between |
| Add or remove margin from an isolated position |
| Switch between One-way and Hedge Mode |
| Get current position mode |
| Leverage tiers with maintenance margin rates |
Related MCP server: binance-data MCP Server
Setup
Requirements
Python 3.11+
uv (recommended) or pip
Install
# with uv (recommended)
uv sync
# or with pip
pip install -e .API Keys
Create a Binance API key with Futures trading enabled. Set environment variables:
export BINANCE_API_KEY="your_api_key"
export BINANCE_API_SECRET="your_api_secret"Security: Use IP whitelisting on your Binance API key. Never commit keys to version control.
Running
# stdio transport (default — for MCP clients like Claude Desktop)
python server.py
# or via the installed script
mcp-binance-futuresMCP Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"binance-futures": {
"command": "python",
"args": ["/path/to/mcp-binance-futures/server.py"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
}With uv
{
"mcpServers": {
"binance-futures": {
"command": "uv",
"args": ["run", "--project", "/path/to/mcp-binance-futures", "mcp-binance-futures"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
}Testing
# install dev dependencies
uv sync --extra dev
# run all tests
pytest
# run with output
pytest -vTests use respx to mock all HTTP calls — no real API keys or network required.
Common Usage Patterns
Open a long position with stop loss and take profit
1. get_ticker(symbol="BTCUSDT") → check current price
2. get_balance() → check available margin
3. get_positions(symbol="BTCUSDT") → confirm no existing position
4. set_leverage(symbol="BTCUSDT", leverage=10)
5. set_margin_type(symbol="BTCUSDT", margin_type="ISOLATED")
6. place_order(symbol="BTCUSDT", side="BUY", order_type="MARKET", quantity=0.01)
7. place_order(symbol="BTCUSDT", side="SELL", order_type="STOP_MARKET",
stop_price=45000, close_position=True)
8. place_order(symbol="BTCUSDT", side="SELL", order_type="TAKE_PROFIT_MARKET",
stop_price=55000, close_position=True)Modify a limit order
1. get_open_orders(symbol="BTCUSDT") → find the order ID
2. modify_order(symbol="BTCUSDT", order_id=123456, side="BUY",
quantity=0.01, price=48500)Emergency close all
1. cancel_all_orders(symbol="BTCUSDT")
2. place_order(symbol="BTCUSDT", side="SELL", order_type="MARKET",
quantity=<position_size>, reduce_only=True)Architecture
server.py — FastMCP server, all tool definitions
client.py — Async HTTP client: signing, transport, error handling
tests/
test_client.py — Unit tests for BinanceClient (signing, HTTP, errors)
test_server.py — Integration tests for all MCP toolsThe client and server are intentionally kept in separate files: client.py handles all Binance API mechanics (HMAC signing, error parsing, HTTP verbs) while server.py contains only tool logic and MCP wiring. This makes both independently testable.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityCmaintenanceComprehensive 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.Last updated4PythonMIT
- Flicense-qualityCmaintenanceMCP server providing access to Binance public market data, including klines, order book depth, and 24hr ticker.Last updated
- FlicenseBqualityCmaintenanceCustom MCP server for Binance Futures, providing market data, trading, and quant tools.Last updated19
- Alicense-qualityCmaintenanceA Model Context Protocol (MCP) server that enables any compatible AI model to autonomously trade Binance USDT-margined perpetual futures. Includes a separate paper-trading strategy lab that requires no credentials.Last updated1MIT
Related MCP Connectors
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server exposing the Backtest360 engine API as tools for AI agents.
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Muvon/mcp-binance-futures'
If you have feedback or need assistance with the MCP directory API, please join our Discord server