Skip to main content
Glama

BinanceMCPServer

by AnalyticAce
GitHub
Python
MIT License
18
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Binance MCP Server 🚀

PyPI version Documentation Status PyPI Deployement Status Python 3.10+ License: MIT

A powerful Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the Binance cryptocurrency exchange. This server provides a comprehensive suite of trading tools, market data access, and account management capabilities through the standardized MCP interface.

🎯 Key Features

  • Secure Authentication: API key-based authentication with Binance

  • Real-time Market Data: Live price feeds, order book data, and market statistics

  • Trading Operations: Place, modify, and cancel orders across spot and futures markets

  • Portfolio Management: Account balance tracking, position monitoring, and P&L analysis

  • Smart Notifications: Real-time alerts for price movements, order fills, and market events

  • Risk Management: Built-in safeguards and validation for trading operations

🚀 Quick Start

Prerequisites

  • Python 3.10+ installed on your system

  • Binance account with API access enabled

  • API credentials (API Key & Secret) from your Binance account

1️⃣ Installation

Install the official package from PyPI:

# Recommended: Install using pip pip install binance-mcp-server # Alternative: Using uv for faster package management uv add binance-mcp-server

💡 Why use the PyPI package?

  • ✅ Always up-to-date with latest releases

  • ✅ Automatic dependency management

  • ✅ Simple installation and updates

  • ✅ No need to clone repositories or manage source code

2️⃣ Configuration

Set up your Binance API credentials as environment variables:

# Required: Your Binance API credentials export BINANCE_API_KEY="your_api_key_here" export BINANCE_API_SECRET="your_api_secret_here" # Recommended: Use testnet for development and testing export BINANCE_TESTNET="true"

3️⃣ Launch Server

# Start the MCP server (after installing from PyPI) binance-mcp-server --api-key $BINANCE_API_KEY --api-secret $BINANCE_API_SECRET --binance-testnet

4️⃣ Connect Your AI Agent

Configure your AI agent (Claude, GPT-4, or custom bot) to connect to the MCP server:

{ "mcpServers": { "binance": { "command": "binance-mcp-server", "args": [ "--api-key", "your_api_key", "--api-secret", "your_secret", "--binance-testnet" ] } } }

📚 Available Tools

Our MCP server provides 15 comprehensive trading tools that enable AI agents to perform cryptocurrency trading operations. Each tool follows the Model Context Protocol standard for seamless integration.

🏦 Account & Portfolio Management

Tool

Purpose

get_balance

Retrieve account balances for all assets

get_account_snapshot

Point-in-time account state snapshot

get_fee_info

Trading fee rates (maker/taker commissions) for symbols

get_available_assets

List all tradable cryptocurrencies and exchange info

📊 Market Data & Analysis

Tool

Purpose

get_ticker_price

Current price for a trading symbol

get_ticker

24-hour ticker price change statistics

get_order_book

Current order book (bids/asks) for a symbol

💱 Trading Operations

Tool

Purpose

create_order

Create buy/sell orders (market, limit, etc.)

get_orders

List order history for a specific symbol

📈 Performance & Analytics

Tool

Purpose

get_pnl

Calculate profit and loss for futures trading

get_position_info

Open futures positions details

🏪 Wallet & Transfers

Tool

Purpose

get_deposit_address

Get deposit address for a specific coin

get_deposit_history

Deposit history for a specific coin

get_withdraw_history

Withdrawal history for a specific coin

🛡️ Risk Management

Tool

Purpose

get_liquidation_history

Past liquidation events for futures trading

🔧 Configuration

Environment Variables

Variable

Description

Required

Default

BINANCE_API_KEY

Your Binance API key

✅

-

BINANCE_API_SECRET

Your Binance API secret

✅

-

BINANCE_TESTNET

Use testnet environment

❌

false

🛠️ Development

📝 Note: This section is for contributors and developers who want to modify the source code. Regular users should install from PyPI using the instructions above.

Development Environment Setup

# 1. Clone the repository git clone https://github.com/AnalyticAce/binance-mcp-server.git cd binance-mcp-server # 2. Create and activate virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # 3. Install development dependencies (choose one) # Option A: Using uv (if available) uv install --dev # Option B: Using pip pip install -e . pip install pytest # for testing # 4. Set up pre-commit hooks (optional) pip install pre-commit pre-commit install --hook-type commit-msg # 5. Run tests to verify setup pytest # 6. Start development server python -m binance_mcp_server.cli

Testing Strategy

# Run all tests pytest # Run tests with coverage report pytest --cov=binance_mcp_server --cov-report=html # Run specific test category pytest tests/test_tools/test_account.py -v

🤝 Contributing

We welcome contributions from the crypto and AI development community! Here's how you can help:

🎯 Current Priorities

Check our GitHub Issues for the latest development priorities:

  • Enhanced Trading Tools - Order cancellation, modification, and advanced order types

  • Portfolio Management - Advanced portfolio analytics and asset allocation tools

  • Risk Management Extensions - Margin monitoring, leverage management, and liquidation alerts

  • Market Data Enhancements - Historical data, technical indicators, and market analysis

  • Alert System - Price notifications and position monitoring

  • Documentation & Examples - Comprehensive guides and use case examples

📋 Contribution Guidelines

  1. Fork & Branch: Create a feature branch from main

  2. Code: Follow our coding standards

  3. Pre-commit Hooks: Install and configure pre-commit hooks for commit message validation

  4. Test: Add tests for new features (aim for >80% coverage)

  5. Document: Update documentation for user-facing changes

  6. Review: Submit a pull request for review

🔧 Development Setup for Contributors

💡 For Regular Use: Most users should install via pip install binance-mcp-server instead of cloning this repository.

# Clone your fork git clone https://github.com/your-username/binance-mcp-server.git cd binance-mcp-server # Install dependencies and set up environment (choose one) # Option A: Using uv (if available) uv install --dev # Option B: Using pip pip install -e . pip install pytest pre-commit # Install pre-commit hooks (enforces commit message conventions) pre-commit install --hook-type commit-msg # Make your changes and commit using conventional format git commit -m "feat(tools): add new market data tool"

🏷️ Issue Labels

  • good first issue - Perfect for newcomers

  • enhancement - New features and improvements

  • bug - Something isn't working correctly

  • documentation - Documentation updates needed

  • help wanted - Community assistance requested

📋 Development Standards

  • MCP Protocol Compliance: Full adherence to Model Context Protocol standards

  • Pre-commit Hooks: Required for all contributors to ensure commit message consistency

  • Type Hints: Full type annotations required

  • Testing: pytest with >80% coverage target

  • Commits: Conventional commit format (feat:, fix:, etc.) enforced by pre-commit hooks

  • Documentation: Google-style docstrings

  • Security: Comprehensive input validation and secure error handling

🔒 Security & Best Practices

🛡️ MCP Protocol Compliance

This server implements comprehensive security measures following Model Context Protocol best practices:

  • Enhanced Input Validation: All inputs are validated and sanitized

  • Secure Error Handling: Error messages are sanitized to prevent information leakage

  • Rate Limiting: Built-in protection against API abuse

  • Credential Protection: No sensitive data logged or exposed

  • Audit Logging: Comprehensive security event tracking

🔐 API Security

  • Credential Management: Never commit API keys to version control

  • Testnet First: Always test with Binance testnet before live trading

  • Rate Limiting: Built-in respect for Binance API rate limits

  • Input Validation: Comprehensive validation of all trading parameters

  • Audit Logging: Complete audit trail of all operations

🔐 Environment Security

# Use environment variables for sensitive data export BINANCE_API_KEY="your_key_here" export BINANCE_API_SECRET="your_secret_here" # Enable testnet for development export BINANCE_TESTNET="true" # Optional: Configure security features export MCP_RATE_LIMIT_ENABLED="true" export MCP_MAX_REQUESTS_PER_MINUTE="60"

📖 Read Full Security Documentation - Comprehensive security guidelines and best practices.

💡 Usage Examples

📊 Market Data Queries

# Get real-time Bitcoin price { "name": "get_ticker_price", "arguments": { "symbol": "BTCUSDT" } } # Get 24-hour ticker statistics for Ethereum { "name": "get_ticker", "arguments": { "symbol": "ETHUSDT" } } # Check current order book for Ethereum { "name": "get_order_book", "arguments": { "symbol": "ETHUSDT", "limit": 10 } }

💰 Account Management

# Check account balances { "name": "get_balance", "arguments": {} } # Get account snapshot { "name": "get_account_snapshot", "arguments": { "account_type": "SPOT" } }

🛒 Trading Operations

# Create a limit buy order for Ethereum { "name": "create_order", "arguments": { "symbol": "ETHUSDT", "side": "BUY", "order_type": "LIMIT", "quantity": 0.1, "price": 2000.00 } } # Get order history for a symbol { "name": "get_orders", "arguments": { "symbol": "ETHUSDT" } }

📈 Performance Analysis

# Calculate profit and loss { "name": "get_pnl", "arguments": {} } # Get position information { "name": "get_position_info", "arguments": {} }

🎯 Roadmap

🚀 Phase 1: Core Foundation ✅

  • MCP Server Framework - FastMCP integration and basic structure

  • MCP Protocol Compliance - Enhanced security and best practices implementation

  • Documentation & Planning - Comprehensive tool specifications

  • Authentication System - Secure Binance API integration

  • Basic Tools Implementation - Essential trading and account tools (15 tools)

  • Security Features - Input validation, error sanitization, rate limiting

📊 Phase 2: Trading Operations 🚧

  • Order Management - Basic order creation and history

  • Market Data Integration - Real-time price feeds and order books

  • Portfolio Analytics - Basic P&L tracking and position info

  • Advanced Order Types - Stop-loss, take-profit, OCO orders

  • Order Cancellation - Cancel and modify existing orders

  • Enhanced Risk Management - Advanced margin monitoring

🔥 Phase 3: Advanced Features 📋

  • Advanced Analytics - Technical indicators and market insights

  • Alert System - Price notifications and position monitoring

  • Strategy Tools - DCA, grid trading, and automation helpers

  • Multi-account Support - Cross-margin, isolated margin accounts

📈 Success Metrics

  • Tool Coverage: 15/15 core tools implemented ✅

  • Test Coverage: >90% code coverage target (currently 38 tests passing)

  • Security Compliance: MCP best practices implemented ✅

  • Performance: <100ms average API response time

  • Community: Growing GitHub engagement and contributions

  • Production Usage: Stable package releases on PyPI

📄 License

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

🆘 Support & Community

📚 Documentation & Resources

💬 Get Help

🏷️ Quick Help Tags

When creating issues, please use these labels to help us respond faster:

  • bug - Something isn't working

  • enhancement - Feature requests

  • question - General questions

  • documentation - Docs improvements

  • good first issue - Perfect for newcomers

⚠️ Legal Disclaimer

Important Notice: This software is provided for educational and development purposes only. Cryptocurrency trading involves substantial risk of financial loss.

📋 Risk Acknowledgment

  • Testing Environment: Always use Binance testnet for development and testing

  • Financial Risk: Only trade with funds you can afford to lose

  • Due Diligence: Conduct thorough testing before deploying to live trading

  • No Liability: Developers assume no responsibility for financial losses

📄 License & Attribution

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

Built with ❤️ by the crypto development community

⚡ Powered by

GitHub Stars GitHub Forks GitHub Issues

⭐ Star this project | 🍴 Fork & Contribute | 📖 Read the Docs

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AnalyticAce

  1. 🎯 Key Features
    1. 🚀 Quick Start
      1. Prerequisites
      2. 1️⃣ Installation
      3. 2️⃣ Configuration
      4. 3️⃣ Launch Server
      5. 4️⃣ Connect Your AI Agent
    2. 📚 Available Tools
      1. 🏦 Account & Portfolio Management
      2. 📊 Market Data & Analysis
      3. 💱 Trading Operations
      4. 📈 Performance & Analytics
      5. 🏪 Wallet & Transfers
      6. 🛡️ Risk Management
    3. 🔧 Configuration
      1. Environment Variables
    4. 🛠️ Development
      1. Development Environment Setup
      2. Testing Strategy
    5. 🤝 Contributing
      1. 🎯 Current Priorities
      2. 📋 Contribution Guidelines
      3. 🔧 Development Setup for Contributors
      4. 🏷️ Issue Labels
      5. 📋 Development Standards
    6. 🔒 Security & Best Practices
      1. 🛡️ MCP Protocol Compliance
      2. 🔐 API Security
      3. 🔐 Environment Security
    7. 💡 Usage Examples
      1. 📊 Market Data Queries
      2. 💰 Account Management
      3. 🛒 Trading Operations
      4. 📈 Performance Analysis
    8. 🎯 Roadmap
      1. 🚀 Phase 1: Core Foundation ✅
      2. 📊 Phase 2: Trading Operations 🚧
      3. 🔥 Phase 3: Advanced Features 📋
      4. 📈 Success Metrics
    9. 📄 License
      1. 🆘 Support & Community
        1. 📚 Documentation & Resources
        2. 💬 Get Help
        3. 🏷️ Quick Help Tags
      2. ⚠️ Legal Disclaimer
        1. 📋 Risk Acknowledgment
        2. 📄 License & Attribution

      Related MCP Servers

      View all related MCP servers

      New MCP Servers

      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/AnalyticAce/BinanceMCPServer'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server