MCP Bybit API Interface

Bybit MCP (Model Context Protocol) Server. Provides a convenient interface to interact with the Bybit API using MCP tools. Allows fetching market data, managing account information, and placing/canceling orders via API calls wrapped as tools.

Usage

Installing via Smithery

To install this Bybit API Interface server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dlwjdtn535/mcp-bybit-server --client claude

Using with Claude, Roo Code, Cline, etc.

Add the following configuration to your MCP settings file (e.g., mcp_settings.json): Using uv With Windows:

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\mcp-server-demo\\src",
        "server.py"
      ],
      "env": {
          "ACCESS_KEY": "{ACCESS_KEY}",
          "SECRET_KEY": "{ACCESS_KEY}"
        }
    }
    // ... other servers might be here ...
  }
}

(Remember to replace YOUR_USERNAME and use double backslashes \)

Using uv With macOS:

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-server-demo/src",
        "server.py"
      ],
      "env": {
        "ACCESS_KEY": "{ACCESS_KEY}",
        "SECRET_KEY": "{ACCESS_KEY}"
      }
    }
    // ... other servers might be here ...
  }
}

(Replace YOUR_USERNAME if using ~/bin)

Using uv With Linux:

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/YOUR_USERNAME/bin/mcp-server-demo/src",
        "server.py"
      ],
      "env": {
        "ACCESS_KEY": "{ACCESS_KEY}",
        "SECRET_KEY": "{ACCESS_KEY}"
      }
    }
    // ... other servers might be here ...
  }
}

Using Docker (Requires Docker)

Make sure you have pulled the image first: docker pull dlwjdtn535/mcp-bybit-server:latest

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i", 
        "--rm",
        "--init",
        "-e", "ACCESS_KEY={ACCESS_KEY}",
        "-e", "SECRET_KEY={SECRET_KEY}",
        "dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

Note: Always use @latest or a specific version tag for both NPX and Docker to ensure you are using the intended version.

Tools 🛠️

This MCP server provides the following tools for interacting with the Bybit API:

1. get_orderbook: Fetches order book information.
   • Inputs: category, symbol, limit (optional)
   • Returns: Order book details.
2. get_kline: Fetches K-line (candlestick) data.
   • Inputs: category, symbol, interval, start (optional), end (optional), limit (optional)
   • Returns: Candlestick data.
3. get_tickers: Fetches cryptocurrency ticker information.
   • Inputs: category, symbol
   • Returns: Ticker information.
4. get_wallet_balance: Fetches account balance.
   • Inputs: accountType, coin (optional)
   • Returns: Balance information.
5. get_positions: Fetches position information.
   • Inputs: category, symbol (optional)
   • Returns: Position information.
6. place_order: Places a limit or market order.
   • Inputs: category, symbol, side, orderType, qty, price (optional for limit), positionIdx (optional for futures), and other optional parameters (e.g., timeInForce, takeProfit, stopLoss).
   • Returns: Order placement confirmation.
7. cancel_order: Cancels an existing order.
   • Inputs: category, symbol, orderId (optional), orderLinkId (optional)
   • Returns: Cancellation confirmation.
8. get_order_history: Fetches historical order details.
   • Inputs: category, symbol (optional), orderId (optional), limit (optional), etc.
   • Returns: Order history.
9. get_open_orders: Fetches current open orders.
   • Inputs: category, symbol (optional), limit (optional), etc.
   • Returns: Open order details.
10. set_trading_stop: Sets take profit, stop loss, or trailing stop for a position.
    • Inputs: category, symbol, takeProfit (optional), stopLoss (optional), trailingStop (optional), positionIdx (optional)
    • Returns: Setting confirmation.
11. set_margin_mode: Sets the margin mode (isolated or cross).
    • Inputs: category, symbol, tradeMode, buyLeverage, sellLeverage
    • Returns: Setting confirmation.
12. get_api_key_information: Fetches information about the current API key.
    • Inputs: None
    • Returns: API key details.
13. get_instruments_info: Fetches details about trading instruments (symbols).
    • Inputs: category, symbol, status (optional), baseCoin (optional)
    • Returns: Instrument details.

(Refer to the function docstrings in the code for detailed parameter descriptions and examples.)

Environment Variables

Before running the server, you must set the following environment variables:

ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false # Optional: set to true for testnet

API Key Setup

To use this Bybit API interface, you need to create an API key from Bybit. Follow these important steps:

1. Go to Bybit and log into your account.
2. Navigate to API Management.
3. Create a new API key.
4. Important Security Settings:
   • Enable IP restriction if possible.
   • Add ONLY the IP address(es) from which the server will run (your local PC IP, server IP, or Docker container's external IP).
   • Never share your API keys or expose them in public repositories.
   • Recommended permissions:
     • Read (Required)
     • Trade (Required for order execution)
     • Wallet (Required for balance checking)

Sponsorship & Donations

If you find this project helpful and would like to support its development, you can contribute in the following ways:

Buy Me a Coffee

Referral Program

You can also support this project by signing up for Bybit using our referral link:

• My Bybit Referral Link
• Referral Code: J1O4JK

Your support helps maintain and improve this project. Thank you! 🙏

Contact & Support

For additional inquiries or support, please contact:

• Email: [email protected]

We welcome your questions and feedback!

License

MIT License