Bybit MCP Server

🚀 Bybit MCP Server

A Model Context Protocol (MCP) server for Bybit exchange, enabling AI coding tools like Claude Code and Cursor to interact with Bybit's trading platform.

Multi-language Documentation

• English
• 中文
• 日本語

🚀 Quick Start

📦 Installation

npm install -g bybit-mcp-server

⚙️ Configuration

This MCP server can be used with various AI tools that support MCP:

Claude Code Configuration

For Testnet (Recommended - Safe for testing): Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bybit": {
      "command": "npx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your_testnet_api_key",
        "BYBIT_API_SECRET": "your_testnet_api_secret",
        "BYBIT_ENVIRONMENT": "testnet"
      }
    }
  }
}

For Mainnet (⚠️ WARNING: Uses real funds): Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bybit": {
      "command": "npx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your_mainnet_api_key",
        "BYBIT_API_SECRET": "your_mainnet_api_secret",
        "BYBIT_ENVIRONMENT": "mainnet"
      }
    }
  }
}

Cursor Configuration

Use the same configuration as Claude Code above, but add to .cursor/mcp_config.json with mcp.servers instead of mcpServers.

🌐 Environment Setup

Option 1: Testnet (Recommended)

BYBIT_API_KEY=your_testnet_api_key_here
BYBIT_API_SECRET=your_testnet_api_secret_here
BYBIT_ENVIRONMENT=testnet
DEBUG=false

Option 2: Mainnet (⚠️ Real funds)

BYBIT_API_KEY=your_mainnet_api_key_here
BYBIT_API_SECRET=your_mainnet_api_secret_here
BYBIT_ENVIRONMENT=mainnet
DEBUG=false

🔑 Getting API Keys

For Testnet:

1. Visit Bybit Testnet
2. Register an account
3. Go to API Management and create API keys
4. Enable required permissions (read, trade)

For Mainnet:

1. Visit Bybit
2. Complete account verification
3. Go to API Management and create API keys
4. Enable required permissions (read, trade)
5. Set IP restrictions for additional security

✨ Features

📈 Market Data

• get_price - Get current price for a trading symbol
• get_orderbook - Get order book depth for a trading symbol
• get_klines - Get historical candlestick data
• get_24hr_ticker - Get 24-hour trading statistics

👛 Account Management

• get_account_info - Get account information and balances
• get_wallet_balance - Get wallet balance for specific account type
• get_open_orders - Get list of open/active orders
• get_order_history - Get historical orders

🛒 Trading (⚠️ Can use real funds on mainnet)

• place_order - Place a new order
• cancel_order - Cancel an existing order
• cancel_all_orders - Cancel all orders for a symbol or category

💻 Usage Examples

Ask your AI assistant to:

• "Get the current price of BTCUSDT on Bybit"
• "Show me the order book for ETHUSDT with 50 levels"
• "Get my account balance"
• "Place a limit buy order for 0.1 BTC at $45000"
• "Cancel all my open orders for BTCUSDT"
• "Get my trading history for the last 20 orders"

🔒 Security

⚠️ Important Note

• TESTNET is the default and recommended environment for safety
• MAINNET operations use real funds - use with extreme caution
• API keys are automatically redacted from error messages
• Always test thoroughly on testnet before using mainnet
• Trading operations will display warnings when using mainnet

🔐 API Key Safety

• Never commit API keys to version control
• Use environment variables for credentials
• Regularly rotate your API keys
• Use IP restrictions in Bybit API settings

🛠️ Development

npm run build     # Compile TypeScript
npm run dev       # Development mode
npm run lint      # Run linting
npm run typecheck # Type checking
npm run watch     # Watch mode

🏠 Local Development

1. Clone the repository:

git clone https://github.com/your-username/bybit-mcp-server.git
cd bybit-mcp-server

2. Install dependencies:

npm install

3. Set up environment:

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

4. Run in development mode:

npm run dev

📋 Configuration Options

📚 Documentation

This server implements Bybit's V5 API endpoints. For detailed API documentation:

• Bybit V5 API Documentation
• Bybit API GitHub

🤝 Contributing

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

📄 License

MIT License - see LICENSE file for details.

🆘 Support

• 📚 Documentation
• 🐛 Issues
• 💬 Discussions