Skip to main content
Glama

Bybit MCP Server

by ethancod1ng
npmGitHub
TypeScript
20
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bybit MCP Server

Multi-language Documentation

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.

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

Available Tools

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 Security Notes:

  • 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
  1. Install dependencies:
npm install
  1. Set up environment:
cp .env.example .env # Edit .env with your API credentials
  1. Run in development mode:
npm run dev

Configuration Options

VariableDescriptionDefaultRequired
BYBIT_API_KEYYour Bybit API key-✅
BYBIT_API_SECRETYour Bybit API secret-✅
BYBIT_ENVIRONMENTtestnet or mainnettestnet❌
BYBIT_BASE_URLCustom API base URLAuto-detected❌
DEBUGEnable debug loggingfalse❌

API Reference

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

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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

A Model Context Protocol server that enables AI coding tools like Claude Code and Cursor to interact with Bybit's trading platform for market data retrieval, account management, and trading operations.

  1. Quick Start
    1. Installation
    2. Configuration
    3. Environment Setup
    4. Getting API Keys
  2. Available Tools
    1. Market Data
    2. Account Management
    3. Trading (⚠️ Can use real funds on mainnet)
  3. Usage Examples
    1. Security
      1. Development
        1. Local Development
      2. Configuration Options
        1. API Reference
          1. Contributing
            1. License
              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 -
                  9
                  3
                  12
                  TypeScript
                  MIT License

                • MCP Python Toolbox

                  gianlucamazza
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
                  Last updated -
                  5
                  Python
                  • Linux
                  • Apple

                • claude-mcp-server

                  paybyrd
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that enables Claude AI to interact with Paybyrd's payment processing API, allowing for creating payment links, processing refunds, and retrieving order information.
                  Last updated -
                  1
                  TypeScript

                • AI Prediction MCP Server

                  phsphd
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides Claude with access to AI-powered trading predictions and analysis from the aiprediction.us API, handling authentication, date formatting, and data retrieval.
                  Last updated -
                  Python
                  • Apple

                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/ethancod1ng/bybit-mcp-server'

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