Bybit Server

A Model Context Protocol (MCP) server for the Bybit V5 API. This server allows LLMs (like Gemini, Claude, etc.) to interact with Bybit for market data, trading, account management, and position tracking.

Features

• Market Data: Get tickers, K-lines (candlesticks), and orderbook data.
• Trading: Place, cancel, and track orders across Spot and Derivatives.
• Account: Check wallet balances and account information.
• Positions: Monitor open positions for linear/inverse perpetuals and options.

Installation

Prerequisites

• Node.js (v18 or higher)
• Bybit API Key and Secret (with V5 permissions)

Setup

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/bybit-mcp.git
   cd bybit-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Configuration

The server requires environment variables for authentication. You can set these in your shell or via an MCP client configuration (like Claude Desktop or Gemini).

Variable	Description	Default
BYBIT_API_KEY	Your Bybit API Key	Required
BYBIT_API_SECRET	Your Bybit API Secret	Required
BYBIT_TESTNET	Set to true for Testnet	false

Using with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "bybit": {
      "command": "node",
      "args": ["/path/to/bybit-mcp/dist/index.js"],
      "env": {
        "BYBIT_API_KEY": "your_api_key",
        "BYBIT_API_SECRET": "your_api_secret",
        "BYBIT_TESTNET": "false"
      }
    }
  }
}

Available Tools

• get_tickers: Get latest ticker information for symbols.
• get_kline: Get candlestick data (K-line).
• get_orderbook: Get orderbook data.
• get_wallet_balance: Get wallet balance for the account.
• get_account_info: Get account configuration and info.
• place_order: Place a new order.
• cancel_order: Cancel an order.
• get_open_orders: Get open orders.
• get_positions: Get position information.

License

MIT License. See LICENSE for details.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.