Skip to main content
Glama

Bybit MCP Server

by kondisettyravi
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bybit MCP Server (Node.js)

A Model Context Protocol (MCP) server for Bybit trading operations, built with Node.js and TypeScript.

Features

  • ✅ Perfect Authentication - Uses exact Cloud Functions signature logic
  • ✅ Smart Position Validation - Automatic validation against Bybit trading rules
  • ✅ Position Mode Detection - Automatically detects one-way vs hedge mode
  • ✅ 16 Trading Tools - Complete market data, account, and trading operations
  • ✅ Demo Mode Support - Safe testing environment

Installation

  1. Build the server:
    cd /Users/rkondis/personalwork/mcp-bybit-node npm install npm run build
  2. Configure environment:
    • Copy .env file with your Bybit API credentials
    • Set DEMO=true for safe testing

Claude MCP Integration

Step 1: Ensure your .env file exists with your API keys:

# Check if .env file exists ls -la /Users/rkondis/personalwork/mcp-bybit-node/.env # If it doesn't exist, create it: cat > /Users/rkondis/personalwork/mcp-bybit-node/.env << EOF ACCESS_KEY=your_access_key_here SECRET_KEY=your_secret_key_here DEMO=true EOF

Step 2: Add to Claude MCP:

claude mcp add-json bybit-node '{ "type": "stdio", "command": "/Users/rkondis/personalwork/mcp-bybit-node/start-server.sh", "args": [] }'

The startup script automatically loads API keys from the .env file.

Method 2: Direct node execution with environment variables

claude mcp add-json bybit-node '{ "type": "stdio", "command": "node", "args": ["/Users/rkondis/personalwork/mcp-bybit-node/dist/index.js"], "env": { "ACCESS_KEY": "your_access_key_here", "SECRET_KEY": "your_secret_key_here", "DEMO": "true" } }'

Method 3: Using working directory (reads .env automatically)

claude mcp add-json bybit-node '{ "type": "stdio", "command": "node", "args": ["dist/index.js"], "cwd": "/Users/rkondis/personalwork/mcp-bybit-node", "env": { "DEMO": "true" } }'

This method uses the existing .env file in the working directory.

Available Tools

  1. Market Data:
    • get_tickers - Get ticker information
    • get_orderbook - Get orderbook data
    • get_kline - Get K-line (candlestick) data
    • get_instruments_info - Get exchange information
  2. Account Management:
    • get_wallet_balance - Get wallet balance
    • get_positions - Get position information
    • get_api_key_information - Get API key information
  3. Trading Operations:
    • validate_order_quantity - Validate order quantity against trading rules
    • calculate_position_size - Calculate optimal position size based on risk management
    • calculate_trailing_stop - Calculate trailing stop loss with breakeven and profit protection
    • detect_position_mode - Detect position mode and get recommended positionIdx
    • place_order - Execute order with automatic position mode detection
    • place_order_with_trailing_stop - Place order with built-in trailing stop loss
    • cancel_order - Cancel order
    • get_order_history - Get order history
    • get_open_orders - Get open orders
  4. Position Management:
    • set_leverage - Set leverage for a specific symbol
    • set_trading_stop - Set trading stop
    • set_margin_mode - Set margin mode
  5. Utility:
    • get_access_key - Get access key from environment
    • get_secret_key - Get secret key from environment

Testing

Test the MCP server:

cd /Users/rkondis/personalwork/mcp-bybit-node node test-mcp.js

Test trade execution:

cd /Users/rkondis/personalwork/mcp-bybit-node node test-order.js

Usage Examples

Validate order before placing:

// Check if $80 worth of ETHUSDT is valid validate_order_quantity("linear", "ETHUSDT", 80) // Returns: { validatedQty: "0.02", estimatedCost: "73.18", adjustments: [] }

Place a validated order:

// Place market buy order for ETHUSDT place_order("linear", "ETHUSDT", "Buy", "Market", "0.02", positionIdx="0")

Calculate position size with risk management:

// Calculate position size for 2% risk with $1000 balance calculate_position_size("linear", "ETHUSDT", 1000, 2, 3500, 3600, 10) // Returns: { // recommendedQty: "0.57", // riskAmount: 20, // positionValue: 2052, // takeProfitSuggestion: 3800, // warnings: [] // }

Calculate trailing stop loss with profit protection:

// Calculate trailing stop for a long position calculate_trailing_stop("linear", "ETHUSDT", 3600, 3750, "Buy", 3500, 50) // Returns: { // newStopLoss: 3700, // trailingActivated: true, // breakevenProtection: true, // profitProtected: 0, // recommendations: { // shouldUpdateStop: true, // protectionLevel: "breakeven", // reasoning: "Breakeven protection activated - stop moved to entry price" // } // }

Place order with trailing stop loss:

// Place market buy order with 50 USDT trailing stop place_order_with_trailing_stop("linear", "ETHUSDT", "Buy", "Market", "0.02", null, "50") // Returns: Order placed with automatic trailing stop that follows price movement

Set leverage:

// Set 10x leverage for ETHUSDT set_leverage("linear", "ETHUSDT", "10", "10")

Check positions:

// Get all linear positions get_positions("linear")

Key Improvements Over Python Version

  • ✅ No signature errors - Perfect authentication with Bybit API
  • ✅ Smart validation - Automatic position size and mode validation
  • ✅ Better error handling - Comprehensive error messages and recovery
  • ✅ TypeScript support - Full type safety and IntelliSense

Troubleshooting

If Claude MCP fails to start:

  1. Check file permissions:
    ls -la /Users/rkondis/personalwork/mcp-bybit-node/dist/index.js # Should show: -rwxr-xr-x (executable)
  2. Test server directly:
    cd /Users/rkondis/personalwork/mcp-bybit-node node dist/index.js # Should show: "Bybit MCP Server (Node.js) running on stdio"
  3. Check environment variables:
    cat /Users/rkondis/personalwork/mcp-bybit-node/.env
  4. Use the startup script:
    /Users/rkondis/personalwork/mcp-bybit-node/start-server.sh

Security Notes

  • Always use DEMO=true for testing
  • Never commit API keys to version control
  • Use environment variables for sensitive data
  • Test thoroughly in demo mode before production use

Support

The server includes comprehensive logging and error handling. Check the console output for detailed information about any issues.

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

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

  1. Features
    1. Installation
      1. Claude MCP Integration
        1. Method 1: Using the startup script (Recommended)
        2. Method 2: Direct node execution with environment variables
        3. Method 3: Using working directory (reads .env automatically)
      2. Available Tools
        1. Testing
          1. Test the MCP server:
          2. Test trade execution:
        2. Usage Examples
          1. Validate order before placing:
          2. Place a validated order:
          3. Calculate position size with risk management:
          4. Calculate trailing stop loss with profit protection:
          5. Place order with trailing stop loss:
          6. Set leverage:
          7. Check positions:
        3. Key Improvements Over Python Version
          1. Troubleshooting
            1. If Claude MCP fails to start:
          2. Security Notes
            1. Support

              Related MCP Servers

              • Bybit MCP Server

                sammcj
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides read-only access to Bybit's cryptocurrency exchange API, allowing users to query real-time cryptocurrency data using natural language.
                Last updated -
                12
                1
                12
                MIT License

              • Upbit MCP Server

                solangii
                A
                security
                A
                license
                A
                quality
                Interact 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 -
                10
                13
                MIT License
                • Apple

              • Bybit Server

                dlwjdtn535
                A
                security
                A
                license
                A
                quality
                Interact seamlessly with the Bybit API to fetch market data, manage your account, and execute trades. Leverage powerful tools to enhance your trading experience and automate your strategies effortlessly. If you wish to use an API key restricted to your personal IP address, you must configure the MCP
                Last updated -
                15
                7
                MIT License

              • Upbit MCP Server

                IQAIcom
                A
                security
                A
                license
                A
                quality
                Enables interaction with the Upbit cryptocurrency exchange through public market data tools and optional private trading tools. Supports getting ticker data, orderbooks, trades, account information, and executing trading operations through natural language.
                Last updated -
                8
                84
                2
                MIT License

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/kondisettyravi/mcp-bybit-node'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server