Skip to main content
Glama
Binance Futures MCP Server

Binance Futures MCP Server

by SamerElhamdo

🚀 Binance Futures MCP Server

Powerful Model Context Protocol server for Binance USDⓈ-M Futures trading

npm version npm downloads GitHub Repo stars License: MIT TypeScript Node.js

Binance Futures Trading Connect AI assistants like Claude to Binance Futures trading seamlessly

Features • Installation • Tools • Configuration • Documentation


Developed by Samer Elhamdo


📋 Table of Contents

Related MCP server: Binance MCP Server

🎯 Overview

The Binance Futures MCP Server is a comprehensive Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Binance USDⓈ-M Futures API. With 14 powerful trading tools, you can manage your futures trading portfolio directly through conversational AI.

Key Highlights

  • ✨ 14 Trading Tools - Complete futures trading functionality

  • 🔒 Secure - HMAC SHA256 signature authentication

  • 🚀 Fast - Optimized API calls with proper error handling

  • 📊 Comprehensive - Order management, position tracking, and account monitoring

  • 🎨 Easy to Use - Simple configuration and intuitive tool names

✨ Features

Features Overview

Core Trading Operations

  • 📝 Order Management: Create, modify, query, and cancel orders

  • 💼 Account Management: View balances, margins, and positions

  • 📈 Position Control: Monitor and manage open positions

  • ⚙️ Risk Management: Adjust leverage, margin types, and position modes

Advanced Capabilities

  • 🔄 Order Modification: Update orders without canceling

  • 📊 Trade History: View complete trading history

  • 🎛️ Settings Management: Change leverage, position mode, and margin type

  • 📋 Comprehensive Queries: Get all orders, open orders, and account details

📦 Prerequisites

Before you begin, ensure you have:

Requirement

Description

Link

Binance API Keys

API Key with Futures trading enabled

Get API Keys

Claude Desktop

For desktop AI assistant

Download Claude

Cursor

Alternative AI-powered IDE

Download Cursor

Node.js

Version 20 or higher

Download Node.js

API Key Setup Checklist

  • Create Binance API key

  • Enable Futures trading permissions

  • Copy API Key and Secret Key

  • (Optional) Set IP whitelist restrictions

  • (Recommended) Use read-only keys for testing

🚀 Installation

Quick Start (NPX)

npx -y binance-futures-mcp@latest

Install via NPM

npm install -g binance-futures-mcp

Install via Smithery

npx -y @smithery/cli install @smithery/binance-futures-mcp --client claude

⚙️ Configuration

Claude Desktop Configuration

# Create config file
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open in editor
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# OR using VS Code
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# Open config file in VS Code
code %APPDATA%\Claude\claude_desktop_config.json

Configuration JSON

Add this configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "binance-futures-mcp": {
      "command": "npx",
      "args": ["-y", "binance-futures-mcp@latest"],
      "env": {
        "BINANCE_API_KEY": "your-api-key-here",
        "BINANCE_SECRET_KEY": "your-secret-key-here"
      }
    }
  }
}

Cline Configuration

# macOS
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Windows
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Then add the same configuration as above.

🛠️ Available Tools

📊 Complete Tools Table

Tool Name

Category

Description

Method

new-order

Orders

Create new orders (LIMIT, MARKET, STOP, etc.)

POST

query-order

Orders

Query status of a specific order

GET

modify-order

Orders

Modify existing order (price/quantity)

PUT

cancel-order

Orders

Cancel a specific order

DELETE

cancel-all-orders

Orders

Cancel all orders for a symbol

DELETE

get-open-orders

Orders

Get all current open orders

GET

get-all-orders

Orders

Get order history (all statuses)

GET

get-account

Account

Get account info, balances, positions

GET

get-position

Positions

Get position details

GET

get-trade-history

Trading

Get executed trade history

GET

change-leverage

Settings

Change leverage for a symbol

POST

change-position-mode

Settings

Switch One-way/Hedge mode

POST

change-margin-type

Settings

Switch Isolated/Cross margin

POST

modify-position-margin

Positions

Adjust isolated position margin

POST

📝 Detailed Tool Descriptions

1. new-order

Create new orders with various types and options.

Order Types:

  • LIMIT - Limit order with specified price

  • MARKET - Market order at current price

  • STOP - Stop loss limit order

  • STOP_MARKET - Stop loss market order

  • TAKE_PROFIT - Take profit limit order

  • TAKE_PROFIT_MARKET - Take profit market order

  • TRAILING_STOP_MARKET - Trailing stop order

Example:

{
  "symbol": "BTCUSDT",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": 0.01,
  "price": 50000,
  "timeInForce": "GTC"
}

2. query-order

Check the status of a specific order.

Parameters:

  • symbol (required)

  • orderId (optional)

  • origClientOrderId (optional)

3. modify-order

Modify an existing order without canceling it.

Parameters:

  • symbol (required)

  • side (required) - BUY or SELL

  • orderId or origClientOrderId (required)

  • quantity (optional) - New quantity

  • price (optional) - New price

4. cancel-order

Cancel a specific pending order.

Parameters:

  • symbol (required)

  • orderId or origClientOrderId (optional)

5. cancel-all-orders

Cancel all open orders for a specific symbol.

Parameters:

  • symbol (required)

6. get-account

Get comprehensive account information including balances, margins, and positions.

No parameters required.

7. get-position

Get detailed position information.

Parameters:

  • symbol (optional) - If not provided, returns all positions

8. get-open-orders

List all current open orders.

Parameters:

  • symbol (optional) - If not provided, returns all open orders

9. get-all-orders

Get complete order history (filled, canceled, pending).

Parameters:

  • symbol (required)

  • orderId (optional) - Returns orders >= orderId

  • startTime (optional) - Start time in milliseconds

  • endTime (optional) - End time in milliseconds

  • limit (optional) - Number of orders (default: 500, max: 1000)

10. get-trade-history

Get executed trade history with detailed information.

Parameters:

  • symbol (required)

  • startTime (optional)

  • endTime (optional)

  • fromId (optional) - Trade ID to start from

  • limit (optional) - Number of trades (default: 500, max: 1000)

11. change-leverage

Change the leverage for a specific symbol.

Parameters:

  • symbol (required)

  • leverage (required) - Leverage level (1-125, depends on symbol)

Example:

{
  "symbol": "BTCUSDT",
  "leverage": 10
}

12. change-position-mode

Switch between One-way Mode and Hedge Mode.

Parameters:

  • dualSidePosition (required) - "true" for Hedge Mode, "false" for One-way Mode

Note: Hedge Mode allows holding both LONG and SHORT positions simultaneously.

13. change-margin-type

Switch between Cross Margin and Isolated Margin.

Parameters:

  • symbol (required)

  • marginType (required) - "ISOLATED" or "CROSSED"

Note: Isolated margin limits risk to the specific position.

14. modify-position-margin

Add or reduce margin for isolated positions.

Parameters:

  • symbol (required)

  • amount (required) - Amount to add (positive) or reduce (negative)

  • type (required) - 1 to add margin, 2 to reduce margin

Example:

{
  "symbol": "BTCUSDT",
  "amount": 100,
  "type": 1
}

💡 Usage Examples

Once configured, you can interact with Binance Futures through Claude:

Conversational Commands

"Check my Binance Futures account balance"
"Create a limit buy order for 0.01 BTCUSDT at $50,000"
"Show me all my open positions"
"Cancel all open orders for BTCUSDT"
"What's the status of order ID 12345?"
"Change leverage for BTCUSDT to 10x"
"Get my trade history for the last 24 hours"
"Modify order 12345 to new price $51,000"

Example Workflows

  1. Create and Monitor Order:

    • Create a LIMIT order

    • Query order status

    • Modify if needed

    • Monitor execution

  2. Risk Management:

    • Check account balance

    • View open positions

    • Adjust leverage

    • Modify margin if needed

  3. Position Analysis:

    • Get all positions

    • View trade history

    • Analyze PnL

🔒 Security Considerations

⚠️ IMPORTANT SECURITY GUIDELINES ⚠️

Best Practices

Security Measure

Description

Priority

Never Share Keys

Keep API keys private and secure

🔴 Critical

Read-Only Testing

Use read-only keys for testing

🟡 High

Restrict Permissions

Enable only necessary permissions

🟡 High

IP Whitelist

Restrict API access by IP address

🟢 Recommended

No Version Control

Never commit keys to git

🔴 Critical

Environment Variables

Use environment variables only

🟡 High

Regular Rotation

Rotate API keys periodically

🟢 Recommended

Security Checklist

  • API keys stored in environment variables only

  • Secret key never exposed in logs or errors

  • Read-only keys used for testing

  • IP whitelist configured (if available)

  • API key permissions minimized

  • .env file in .gitignore

  • Keys not committed to version control

💻 Development

Installation from Source

# Clone repository
git clone https://github.com/SamerElhamdo/Binance-Futures-MCP-Server.git
cd Binance-Futures-MCP-Server

# Install dependencies
npm install

# Build project
npm run build

# Run tests
npm test

Project Structure

Binance-Futures-MCP-Server/
├── src/
│   └── index.ts          # Main server implementation
├── build/
│   └── index.js          # Compiled JavaScript
├── package.json           # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Available Scripts

Script

Description

npm run build

Compile TypeScript to JavaScript

npm test

List all available tools

npm run watch

Watch mode for development

npm run inspector

Run MCP inspector

Environment Variables

Create a .env file in the project root:

BINANCE_API_KEY=your-api-key-here
BINANCE_SECRET_KEY=your-secret-key-here

📚 API Documentation

Architecture Diagram

This MCP server uses the official Binance USDⓈ-M Futures API.

Key Endpoints

Endpoint

Method

Description

/fapi/v1/order

POST

Create new order

/fapi/v1/order

PUT

Modify order

/fapi/v1/order

GET

Query order

/fapi/v1/order

DELETE

Cancel order

/fapi/v1/allOpenOrders

DELETE

Cancel all orders

/fapi/v1/openOrders

GET

Get open orders

/fapi/v1/allOrders

GET

Get all orders

/fapi/v1/userTrades

GET

Get trade history

/fapi/v2/account

GET

Get account info

/fapi/v2/positionRisk

GET

Get position risk

/fapi/v1/leverage

POST

Change leverage

/fapi/v1/positionSide/dual

POST

Change position mode

/fapi/v1/marginType

POST

Change margin type

/fapi/v1/positionMargin

POST

Modify position margin

Error Handling

The server provides detailed error messages from Binance API:

Error Code

Description

Solution

-1022

Invalid signature

Check API keys and timestamp

-1117

Invalid side

Ensure side is BUY or SELL

-1102

Missing parameter

Check required parameters

-2010

Insufficient balance

Ensure sufficient account balance

-4131

Invalid order

Check order parameters

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contribution Guidelines

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENCE file for details.

🙏 Acknowledgments


⭐ If you find this project useful, please consider giving it a star! ⭐

Made with ❤️ by Samer Elhamdo

Report Bug • Request Feature • npm Package

Available Tools

14 tools
cancel-all-ordersA

Cancel all open orders for a specific symbol on Binance USDⓈ-M Futures. Use with caution as this will cancel all pending orders.

Inputs: symbol (required).

cancel-orderA

Cancel an existing order on Binance USDⓈ-M Futures. Use this to cancel pending orders that haven't been executed yet.

Inputs: symbol (required), orderId, origClientOrderId.

change-leverageB

Change the initial leverage of a symbol for Binance USDⓈ-M Futures. Critical for risk management and position sizing.

Inputs: symbol (required), leverage (required).

change-margin-typeB

Change margin type between Cross and Isolated for a symbol on Binance USDⓈ-M Futures. Isolated margin limits risk to the specific position.

Inputs: symbol (required), marginType (required).

change-position-modeB

Change position mode between One-way Mode and Hedge Mode for Binance USDⓈ-M Futures. Hedge Mode allows holding both LONG and SHORT positions simultaneously.

Inputs: dualSidePosition (required).

get-accountA

Get current account information including balances, margin, and positions for Binance USDⓈ-M Futures. Essential for risk management and portfolio tracking.

Inputs: no named parameters.

get-all-ordersA

Get all orders (open, filled, cancelled) for a symbol on Binance USDⓈ-M Futures. Useful for order history and auditing.

Inputs: symbol (required), limit, endTime, orderId, +1 more.

get-open-ordersB

Get all current open orders for Binance USDⓈ-M Futures. Useful for monitoring pending orders and managing active trades.

Inputs: symbol.

get-positionB

Get current position information for Binance USDⓈ-M Futures. Returns details about open positions including entry price, size, PnL, and margin used.

Inputs: symbol.

get-trade-historyB

Get account trade list (executed trades) for Binance USDⓈ-M Futures. Returns detailed information about filled orders including price, quantity, and fees.

Inputs: symbol (required), limit, fromId, endTime, +1 more.

modify-orderA

Modify an existing order on Binance USDⓈ-M Futures. Useful for updating price or quantity of pending orders without canceling and recreating them.

Inputs: side (required), symbol (required), price, orderId, +2 more.

modify-position-marginA

Modify isolated position margin for Binance USDⓈ-M Futures. Add or reduce margin to adjust position risk and prevent liquidation.

Inputs: type (required), amount (required), symbol (required).

new-orderB

Create a new order on Binance USDⓈ-M Futures. Supports all order types: LIMIT, MARKET, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET. Essential for executing trades on futures markets.

Inputs: side (required), type (required), symbol (required), price, +12 more.

query-orderB

Query the status of a specific order on Binance USDⓈ-M Futures. Use this to check if an order was filled, pending, or cancelled.

Inputs: symbol (required), orderId, origClientOrderId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 14 tools

    Disambiguation4/5

    Each tool targets a distinct action (create, cancel, modify, query) and resource (order, position, account, leverage, margin). However, the read-side tools for orders (get-open-orders, get-all-orders, query-order, get-trade-history) have some conceptual overlap that could occasionally confuse an agent, though descriptions help clarify.

    Naming Consistency5/5

    All tool names follow a consistent lowercase-hyphenated verb-noun pattern (e.g., new-order, cancel-order, get-position, change-leverage). The verbs vary appropriately by action, but the convention is uniform throughout.

    Tool Count5/5

    With 14 tools, the set is well-scoped for a futures trading server. It covers order lifecycle, position management, account info, and margin/leverage settings without excessive redundancy.

    Completeness4/5

    Core CRUD for orders and key position/margin operations are present, covering most trading workflows. Minor gaps exist, such as an explicit close-position tool or getter for current leverage, but these can be worked around with existing tools.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform cryptocurrency trading operations on Binance exchange through 30 comprehensive tools supporting spot trading, futures contracts, options, account management, market data analysis, and risk control features. Provides enterprise-grade security with local encrypted API key storage and supports multiple account types with sandbox environment testing.
      9
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Provides over 156 tools to interact with the Binance.com global exchange API for spot trading, wallet management, and staking operations. It enables users to execute orders, retrieve market data, and manage crypto assets through natural language interfaces like Claude and ChatGPT.
      195
      134 npm
      40
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive Binance trading capabilities through Claude Desktop, including account management, spot and futures trading, market data, and advanced analysis tools.
      35
      366 npm
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to query Binance Spot market data, account balances, and execute trades via natural language, with withdrawals disabled by default for security.
      11
      MIT