- Home
- MCP servers
- Binance
Binance
- python
0
GitHub Stars
python
Language
5 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"mcp-mirror-alexcandrabersiva_bin-mcp": {
"command": "uvx",
"args": [
"binance_futures_mcp",
"--binance-api-key",
"your_key",
"--binance-secret-key",
"your_secret"
],
"env": {
"BINANCE_API_KEY": "your_key",
"BINANCE_SECRET_KEY": "your_secret"
}
}
}
}This MCP server provides programmatic access to Binance Futures endpoints, enabling you to perform trading actions, manage accounts, and fetch market data from your own environment. It handles authentication, caches ticker data for quick responses, and exposes a suite of tools that cover common trading and market information tasks.
How to use
Connect to the Binance MCP server from your MCP client by starting the server locally and pointing your client at the local endpoint. You will authenticate with your Binance API credentials and then request the 17 trading and market data tools to perform actions such as placing orders, obtaining account details, and retrieving market data like candles, order books, and price tickers. Expect secure handling of API keys, automatic rate-limit respect, and real-time market data access through the client.
How to install
Prerequisites: ensure you have Python and pip installed on your machine. You will run the MCP server locally and connect to it from your MCP client.
pip install binance_futures_mcp
Additional configuration and usage notes
Configure your MCP client to connect to the local server. The server runs with your Binance API credentials and provides tools for account information and market data. You can start the server using the command shown in the example below and then configure your client with the same credentials.
To run the server using the standard CLI, use the following command structure with your own keys.
Security and credentials
Your Binance API key and secret remain local to your computer. The MCP server is designed to avoid transmitting credentials externally. Store credentials in environment variables or local configuration files and never commit them to version control.
Troubleshooting tips
If you encounter rate limit errors, the server automatically respects Binance weight-based limits and applies safeguards to prevent excessive request strains. Ensure your API key has the minimal required permissions and that you are using a valid endpoint for futures trading and data access.
Example usage overview
Once connected, you can issue 17 trading and market data tools to perform actions such as placing orders, checking balances, querying market data, and viewing position information. Each tool corresponds to a specific Binance Futures capability and is designed to be called from your MCP client.
Available tools
get_account_info
Retrieve comprehensive account information including balances, margin, and account status.
get_balance
Fetch the current account balances across assets.
get_position_info
Retrieve details about open positions and their risk exposure.
get_position_mode
Query the current position mode (Hedge vs. One-way) for the account.
get_commission_rate
Obtain the commission rate applicable to the account and trading pairs.
get_exchange_info
Get exchange trading rules and supported symbols.
get_book_ticker
Obtain best bid/ask information from the order book for a symbol.
get_price_ticker
Fetch the latest price for a symbol.
get_24hr_ticker
Get 24-hour price change statistics for a symbol.
get_top_gainers_losers
Retrieve top gainers and losers in the market.
get_market_overview
Get overall market statistics and trends.
get_order_book
Retrieve the full depth of the order book for a symbol.
get_klines
Fetch candlestick data for a symbol and interval.
get_mark_price
Get the current mark price and funding rate for a symbol.
get_aggregate_trades
Retrieve aggregated trade data for a symbol.
get_funding_rate_history
Obtain historical funding rates for a symbol.
get_taker_buy_sell_volume
Get the taker buy/sell volume ratio for a symbol.