Bybit Mcp Full

Created By

BCusack6 months ago

A comprehensive Model Context Protocol (MCP) server that provides full access to Bybit's v5 API. This server enables AI assistants to fetch real-time market data, execute trading operations, manage positions, and access account information from the Bybit cryptocurrency exchange.

# Bybit

# Crypto

Overview Content Tools Comments

Overview

Bybit MCP Server

⚠️ TRADING WARNING ⚠️
This MCP server can execute REAL TRADING OPERATIONS on Bybit when BYBIT_TRADING_ENABLED=true.
Trading operations use REAL MONEY and can result in FINANCIAL LOSSES.
Always test on testnet first (BYBIT_TESTNET=true) and understand the risks before enabling trading.
Trading is DISABLED by default for safety.

🚀 Production Ready

✅ Fully Tested - All endpoints tested and working
✅ Docker Support - Published image available at falconiun/bybit-mcp
✅ VS Code Integration - Ready-to-use configurations provided
✅ Comprehensive API Coverage - Market data, trading, positions, and account management

Features

Core Market Data

Server Time: Get current Bybit server time
Tickers: Retrieve ticker information for trading symbols
Order Book: Get order book depth for any symbol
Recent Trades: Access recent trade history

Kline/Candlestick Data

Standard Klines: Get OHLCV candlestick data
Mark Price Klines: Get mark price historical data
Index Price Klines: Get index price historical data
Premium Index Klines: Get premium index price data

Trading Information

Instruments Info: Get detailed trading instrument information
Funding Rate History: Access historical funding rates
Open Interest: Get open interest statistics
Risk Limits: Retrieve risk limit information

Market Statistics

Insurance Fund: Get insurance fund data
Long/Short Ratio: Access long/short ratio statistics

Trading Operations (Requires `BYBIT_TRADING_ENABLED=true`)

Order Management: Place, amend, and cancel orders with full control
Batch Operations: Execute multiple orders in a single request for efficiency
Order History: View comprehensive open/closed orders and trade history
Order Types: Support for Market, Limit, and conditional orders
Real-time Execution: Get immediate feedback on order status and fills

Position Management (Requires `BYBIT_TRADING_ENABLED=true`)

Position Info: Query real-time position data with detailed metrics
Leverage Control: Set and modify position leverage dynamically
Margin Management: Switch between cross/isolated margin modes
Trading Stops: Set take profit, stop loss, and trailing stops
Auto Add Margin: Configure automatic margin addition
Position Modes: Switch between one-way and hedge position modes
P&L Tracking: Access closed profit and loss records

Account & Wallet Management

Wallet Balance: Get comprehensive wallet balance information
Single Coin Balance: Query specific coin balances
Account Information: Access detailed account information and settings
Multiple Account Types: Support for UNIFIED, CONTRACT, SPOT, INVESTMENT accounts
🎯 Key Capabilities

✅ Complete API Coverage

Market Data: All Bybit v5 market endpoints (tickers, order book, klines, funding rates, etc.)
Trading: Full order lifecycle management (place, amend, cancel, batch operations)
Positions: Complete position management (leverage, margin, stops, P&L tracking)
Account: Wallet balances, account info, and multi-account support

✅ Production Features

Safety First: Trading disabled by default with explicit enablement required
Testnet Support: Full testnet integration for safe development and testing
Error Handling: Comprehensive error handling with detailed error messages
Data Validation: Pydantic models ensure data integrity and type safety
Docker Ready: Published Docker image with proper environment variable handling

✅ Developer Experience

VS Code Integration: Ready-to-use configurations for both local and Docker deployment
MCP Protocol: Full Model Context Protocol compliance for AI assistant integration
Type Safety: Complete TypeScript-style typing with Pydantic models
Testing: Comprehensive test suite with real API integration
Documentation: Extensive documentation with examples and best practices

Supported Categories

Linear: USDT perpetual, USDC perpetual, USDC futures
Inverse: Inverse perpetual, Inverse futures
Option: Options trading
Spot: Spot trading pairs

Server Config

{
  "mcpServers": {
    "bybit-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER",
        "-e",
        "BYBIT_API_KEY",
        "-e",
        "BYBIT_API_SECRET",
        "-e",
        "BYBIT_TRADING_ENABLED",
        "-e",
        "BYBIT_TESTNET",
        "falconiun/bybit-mcp"
      ],
      "env": {
        "DOCKER_CONTAINER": "true",
        "BYBIT_API_KEY": "<BYBIT_API_KEY>",
        "BYBIT_API_SECRET": "<BYBIT_API_SECRET>",
        "BYBIT_TRADING_ENABLED": "<BYBIT_TRADING_ENABLED>",
        "BYBIT_TESTNET": "<BYBIT_TESTNET>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

WindsurfThe new purpose-built IDE to harness magic

Playwright McpPlaywright MCP server

Serper MCP ServerA Serper MCP Server

CursorThe AI Code Editor

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"