Bybit MCP 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.

Related MCP server: bybit-mcp-server

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).

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.