Integrations
Facilitates secure configuration management through environment variables stored in .env files to manage Binance API keys and secrets.
Enables interaction with the Binance exchange API to view portfolio composition, execute token conversions, place market orders, implement algorithmic trading strategies, and access real-time trading data and account information.
Platform for accessing the repository, reporting issues, and contributing to the project.
Binance MCP Server
Overview
Binance MCP Server is a backend service designed to interact with the Binance API. It facilitates seamless interaction with the Binance exchange, enabling users to view their portfolio, convert tokens, and execute trades with minimal market impact. The server utilizes the Model Context Protocol (MCP) framework to ensure secure, structured, and efficient transactions.
Key Functionalities:
- Interact with Binance exchange API for account information and trading
- Display portfolio composition and valuation
- Execute smart token conversions with market impact mitigation
- Process market orders and algorithmic trading strategies
- Retrieve real-time trading data and account information
- Implement structured transactions using the Model Context Protocol framework
- Provide secure authentication and API key management for Binance integration
Features
- Binance API Integration: Connect to Binance exchange for account information and trading operations
- Portfolio Management: View detailed portfolio composition, market value, and percentage allocation
- Portfolio Analytics: Optional historical value tracking to monitor performance over time
- Smart Token Conversion: Convert between tokens with intelligent order execution strategies
- Market Impact Mitigation: Automatically use algorithmic trading for larger orders to prevent price slippage
- Account Management: Retrieve detailed account information, balances, and trading history
- Market Data Access: Access real-time order books and market data for informed trading decisions
- Order Execution: Place spot market orders with flexible quantity specifications
- Algorithmic Trading Support: Implement Time-Weighted Average Price (TWAP) orders to minimize market impact
- Automated Trading: Execute trades programmatically based on predefined strategies
- Secure Authentication: Manage API keys and secure connections to Binance services
- Comprehensive Error Handling: Detailed error reporting for transaction failures and API issues
Requirements
Before setting up the Binance MCP Server, ensure you have the following installed:
- Node.js (v16 or later)
- npm or yarn
- Binance API key and secret (for Binance exchange integration)
- A valid Binance Smart Chain (BSC) wallet private key (for blockchain transactions)
Installation
Clone the repository and install dependencies:
Configuration
To configure the server, create a .env
file in the root directory and specify the following variables:
Creating a Binance API Key
Before using the Binance API integration, you need to create an API key. This allows you to connect to Binance's servers via several programming languages, pull data from Binance, and interact with external applications. You can view your wallet and transaction data, make trades, and deposit and withdraw funds in third-party programs.
Prerequisites:
- You need to make a deposit of any amount to your Spot Wallet to activate your account
- Complete identity verification
- Enable two-factor authentication (2FA) on your account
Steps to create a Binance API Key:
- Log in to your Binance account and click the profile icon, then [Account].
- Go to [API Management] then click [Create API].
- Select your preferred API Key type:
- System-generated API keys (HMAC symmetric encryption) - You'll get the API key and the Secret Key.
- Self-generated API keys (Ed25519 or RSA asymmetric encryption) - You'll receive an API key, but you have to create your own public-private key pair.
- Enter a label/name for your API Key.
- Verify with your 2FA devices and passkeys.
- Your API key is now created.
For more details on Binance API, please refer to the Binance API Documentation.
Integration with Claude Desktop (for Multiple MCP Servers)
Before integrating any MCP server with Claude Desktop, ensure you have the following installed:
- Claude Desktop
Use the following command from the root of the monorepo to build all MCP servers.
Configure Claude Desktop
Each MCP server has its own configuration. To integrate an individual MCP server:
- Navigate to the MCP server folder (e.g.,
packages/binance-spot-mcp
). - Open its
config.example.json
file. - Use the contents of this file to create an entry inside your Claude Desktop config:
Claude Desktop Config File Location
Platform | Path |
---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
Example Config Entry
Here’s how one MCP server (binance-spot-mcp
) might look:
Note: Be sure to replace the
args
path with the actual location of yourbuild/index.js
, and copyenv
values from that server’sconfig.example.json
.
Restart Claude Desktop for the new configuration to take effect.
Usage (For Connecting MCP Hosts Other Than Claude)
You have three options to start your MCP servers depending on your needs:
Option 1: Build then Start All MCP Servers
Option 2: Build & Start All MCP Servers in One Step
Option 3: Run a Specific MCP Server
Use the following command to run an individual server:
🔸 Example:
Functions
Binance API Functions
- Get Binance Account Information -
binanceAccountInfo
Retrieves comprehensive information about your Binance account, including balances, trading permissions, and account status. - Get Binance Account Snapshot -
binanceAccountSnapshot
Gets a snapshot of your Binance account status, including current BTC price information. Includes history for the last 30 days. - Check Binance Order Book -
binanceOrderBook
Retrieves the current order book for a specified trading pair, showing available buy and sell orders up to 50 levels deep.Copy - Place Spot Market Order -
binanceSpotPlaceOrder
Places a market order for immediate execution at the best available price. UseCopyquantity
to specify the amount of base asset orquoteOrderQty
to specify the amount in quote currency. Suitable for small orders. - Place TWAP Order -
binanceTimeWeightedAveragePriceFutureAlgo
Places a Time-Weighted Average Price (TWAP) order that executes gradually over a specified duration to minimize market impact. Suitable for large orders that might otherwise cause significant price movements.Copy
Model Context Protocol (MCP)
The Model Context Protocol (MCP) is an open standard designed to enhance the way applications interact with AI models and blockchain-based computational systems. MCP establishes structured context that improves the efficiency of automated transactions and decentralized applications.
Benefits of MCP:
- Standardization: Defines a unified approach for application interactions.
- Efficiency: Reduces computational overhead and improves transaction speed.
- Interoperability: Supports integration across multiple platforms and blockchain ecosystems.
Error Handling
When a transaction fails, the server returns an error message with details. Check the console logs for more debugging information. Common error scenarios include:
- Insufficient funds in the wallet
- Invalid recipient address
- Network congestion or RPC issues
- Binance API authentication errors
- Trading limit restrictions
License
This project is open-source under the MIT License.
For contributions, bug reports, or feature requests, submit an issue on GitHub.
This server cannot be installed
Backend service that enables users to connect with Binance exchange for viewing portfolio data, converting tokens, and executing trades with minimal market impact through the Model Context Protocol framework.
Related MCP Servers
- -securityFlicense-qualityThis server provides a robust interface for Binance spot trading operations, including secure management of API credentials, execution and management of spot orders, and monitoring of account balances and open orders.Last updated -1697TypeScript
- AsecurityFlicenseAqualityA backend service for executing transactions on Binance Smart Chain, enabling secure transfers of BNB and BEP-20 tokens, smart contract interactions, and token creation through structured MCP integration.Last updated -126672TypeScript
- -securityFlicense-qualityA backend service that executes transactions across multiple blockchains, enabling users to manage wallets, transfer tokens, and interact with smart contracts using the Model Context Protocol framework.Last updated -1TypeScript
- -securityAlicense-qualityA Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.Last updated -4PythonMIT License