Uses .ENV files for secure configuration management of API credentials and environment settings
Version control system used for source code management and development workflow
Hosted on GitHub for source code repository, issue tracking, and community collaboration
Built on Node.js runtime environment for server execution and JavaScript functionality
Uses npm package manager for dependency management and project scripts
Uses Shields.io badges to display project status, version information, and technology stack in documentation
Fully typed implementation using TypeScript for comprehensive type safety and development experience
Supports Yarn as an alternative package manager for dependency installation
Implements Zod schemas for comprehensive input validation and type checking of all API parameters
🚀 MCP Bitget Trading Server
MCP (Model Context Protocol) server for Bitget cryptocurrency exchange. Enables AI assistants to interact with Bitget API for spot & futures trading. Features real-time market data, order management, account balances, leverage control, and position tracking. Supports demo trading with paper trading mode.
✨ Features
📊 Market Data
Real-time Prices - Get current market prices for any trading pair
Full Tickers - Complete ticker information with 24h statistics
Order Book - Market depth data with configurable depth levels
Historical Candles - OHLCV data for technical analysis
💰 Account Management
Balance Information - Real-time account balances for all assets
Position Tracking - Monitor current futures positions
Margin Information - Futures margin account details
Order Management - View and manage open orders
🎯 Trading Operations
Place Orders - Execute market and limit orders
Cancel Orders - Cancel existing orders by ID
Leverage Control - Set leverage for futures positions (1-125x)
Demo Trading - Full support for paper trading mode
⚡ Technical Features
TypeScript - Fully typed implementation
v2 API Support - Latest Bitget API integration
Rate Limiting - Built-in protection against API limits
Error Handling - Comprehensive error management
Zod Validation - Input validation for all parameters
🛠️ Installation
Prerequisites
Node.js 18+
npm or yarn
Bitget API credentials (for live/demo trading)
Quick Start
Clone the repository
Install dependencies
Configure environment
Build the project
Start the server
🔧 Configuration
Environment Variables
Create a .env
file in the root directory:
Claude Desktop Integration
Add to your Claude Desktop MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json
):
📚 Available Tools
Market Data Tools
Tool | Description | Parameters |
| Get current price |
|
| Get full ticker info |
|
| Get order book |
|
| Get OHLCV data |
|
Account Tools
Tool | Description | Parameters |
| Get account balance |
|
| Get futures positions |
|
| Get margin info |
|
| Get open orders |
|
Trading Tools
Tool | Description | Parameters |
| Place new order |
|
| Cancel order |
|
| Set leverage |
|
🎮 Usage Examples
Basic Price Check
Trading Operations
Account Information
🏗️ Development
Scripts
Project Structure
📋 Symbol Formats
Spot Trading
Format:
BTCUSDT
,ETHUSDT
,ADAUSDT
No suffix required
Futures Trading
Format:
BTCUSDT_UMCBL
,ETHUSDT_UMCBL
_UMCBL
suffix for USDT-margined contracts
🔒 Security
API Keys: Store in environment variables, never commit to code
Demo Mode: Use
BITGET_SANDBOX=true
for paper tradingRate Limiting: Built-in protection (10 requests/second default)
Validation: All inputs validated with Zod schemas
🐛 Troubleshooting
Common Issues
Error 40009 - Sign signature error
Check API key configuration
Ensure timestamp is synchronized
Error 40099 - Exchange environment incorrect
Verify demo/live mode settings
Check
paptrading
header for demo mode
Error 400172 - Parameter verification failed
Check required parameters
Verify symbol format
🤝 Contributing
Fork the repository
Create feature branch (
git checkout -b feature/amazing-feature
)Commit changes (
git commit -m 'Add amazing feature'
)Push to branch (
git push origin feature/amazing-feature
)Open Pull Request
📄 License
MIT License - see LICENSE file for details
⚠️ Disclaimer
This software is for educational and development purposes. Use at your own risk. Always test in demo mode before live trading. The authors are not responsible for any financial losses.
🔗 Resources
📞 Support
Issues: GitHub Issues
Discussions: GitHub Discussions
Made with ❤️ for the crypto trading community
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.
Tools
Enables AI assistants to interact with Bitget cryptocurrency exchange for spot and futures trading. Supports real-time market data, order management, account balances, leverage control, and position tracking with demo trading capabilities.
Related MCP Servers
- AsecurityAlicenseAqualityInteract with Upbit cryptocurrency exchange services to retrieve market data, manage accounts, and execute trades. Simplify your trading experience with tools for order management, deposits, withdrawals, and technical analysis.Last updated -1013MIT License
- AsecurityFlicenseAqualityTransforms AI assistants into autonomous crypto trading agents with real-time market analysis, portfolio management, and trade execution across 17+ blockchains.Last updated -32617
- AsecurityFlicenseAqualityEnables cryptocurrency trading on Bybit exchange through comprehensive market data access, account management, and automated trading operations. Features smart position validation, trailing stop losses, and risk management tools with demo mode support for safe testing.Last updated -21
- AsecurityFlicenseAqualityEnables AI assistants to interact with IG Trading API for forex, indices, and commodities trading. Provides 21 tools for account management, position trading, order placement, market data analysis, and watchlist management.Last updated -211041