MCP Bitget Trading

🚀 MCP Bitget Trading Server

This is an MCP (Model Context Protocol) server designed for the Bitget cryptocurrency exchange. It allows AI assistants to interact with the Bitget API for both spot and futures trading. The server provides real - time market data, order management, account balance monitoring, leverage control, and position tracking, and also supports demo trading through the paper trading mode.

🚀 Quick Start

The MCP Bitget Trading Server enables seamless interaction with the Bitget exchange. Here's how to get started:

Prerequisites

• Node.js 18+
• npm or yarn
• Bitget API credentials (for live/demo trading)

Steps

1. Clone the repository

git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading

2. Install dependencies

npm install

3. Configure environment

cp .env.example .env
# Edit .env with your Bitget API credentials

4. Build the project

npm run build

5. Start the server

npm start

✨ Features

📊 Market Data

• Real - time Prices: Obtain current market prices for any trading pair.
• Full Tickers: Get complete ticker information with 24 - hour statistics.
• Order Book: Access market depth data with configurable depth levels.
• Historical Candles: Retrieve OHLCV data for technical analysis.

💰 Account Management

• Balance Information: View real - time account balances for all assets.
• Position Tracking: Monitor current futures positions.
• Margin Information: Check 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: Fully support paper trading mode.

⚡ Technical Features

• TypeScript: Fully typed implementation.
• v2 API Support: Integrate with the latest Bitget API.
• 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

1. Clone the repository

git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading

2. Install dependencies

npm install

3. Configure environment

cp .env.example .env
# Edit .env with your Bitget API credentials

4. Build the project

npm run build

5. Start the server

npm start

🔧 Configuration

Environment Variables

Create a .env file in the root directory:

# Bitget API Configuration
BITGET_API_KEY=your_api_key_here
BITGET_SECRET_KEY=your_secret_key_here
BITGET_PASSPHRASE=your_passphrase_here

# Environment settings
BITGET_SANDBOX=true  # Set to true for demo trading
BITGET_BASE_URL=https://api.bitget.com
BITGET_WS_URL=wss://wspap.bitget.com/v2/ws/public

# Optional settings
LOG_LEVEL=info
RATE_LIMIT_REQUESTS_PER_SECOND=10

Claude Desktop Integration

Add to your Claude Desktop MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "bitget-trading": {
      "command": "node",
      "args": ["/path/to/MCP-bitget-trading/dist/server.js"],
      "env": {
        "BITGET_API_KEY": "your_key",
        "BITGET_SECRET_KEY": "your_secret",
        "BITGET_PASSPHRASE": "your_passphrase",
        "BITGET_SANDBOX": "true"
      }
    }
  }
}

💻 Usage Examples

Basic Price Check

// Get current Bitcoin price
await getPrice({ symbol: "BTCUSDT" })

// Get futures price
await getPrice({ symbol: "BTCUSDT_UMCBL" })

Trading Operations

// Place a limit buy order
await placeOrder({
  symbol: "BTCUSDT",
  side: "buy",
  type: "limit",
  quantity: "0.001",
  price: "50000"
})

// Set leverage for futures
await setLeverage({
  symbol: "BTCUSDT_UMCBL",
  leverage: 10
})

Account Information

// Check balance
await getBalance({ asset: "USDT" })

// Get all positions
await getPositions({})

📚 Documentation

Available Tools

Market Data Tools

Account Tools

Trading Tools

Symbol Formats

Spot Trading

• Format: BTCUSDT, ETHUSDT, ADAUSDT
• No suffix required

Futures Trading

• Format: BTCUSDT_UMCBL, ETHUSDT_UMCBL
• _UMCBL suffix for USDT - margined contracts

🔧 Technical Details

Development

Scripts

npm run dev      # Development with hot reload
npm run build    # Production build
npm run test     # Run tests
npm run lint     # Lint code
npm run format   # Format code

Project Structure

src/
├── api/
│   └── rest-client.ts    # Bitget REST API client
├── types/
│   ├── bitget.ts         # Bitget API types
│   └── mcp.ts           # MCP schema definitions
└── server.ts            # Main MCP server

Security

• API Keys: Store in environment variables, never commit to code.
• Demo Mode: Use BITGET_SANDBOX=true for paper trading.
• Rate Limiting: Built - in protection (10 requests/second default).
• Validation: All inputs validated with Zod schemas.

Troubleshooting

Common Issues

1. Error 40009 - Sign signature error

   • Check API key configuration.
   • Ensure timestamp is synchronized.

2. Error 40099 - Exchange environment incorrect

   • Verify demo/live mode settings.
   • Check paptrading header for demo mode.

3. Error 400172 - Parameter verification failed

   • Check required parameters.
   • Verify symbol format.

🤝 Contributing

1. Fork the repository.
2. Create feature branch (git checkout -b feature/amazing - feature).
3. Commit changes (git commit -m 'Add amazing feature').
4. Push to branch (git push origin feature/amazing - feature).
5. Open Pull Request.

📄 License

This project is under the MIT License. See LICENSE file for details.

⚠️ Important Note

This software is for educational and development purposes. Use it at your own risk. Always test in demo mode before live trading. The authors are not responsible for any financial losses.

🔗 Resources

• Bitget API Documentation
• Model Context Protocol
• Claude Desktop

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Made with ❤️ for the crypto trading community