Bybit Py MCP Server

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

Local serverstdioPython

What is the Bybit Py MCP Server?

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

The tools it exposes

The server publishes 14 tools. What each one is for:

  • 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
  • Read-only — For market data (always safe)
  • Trade — Required for order operations (enable only when needed)
  • Position — Required for position management
  • Withdraw — Not required for this server
  • category — Product type (linear, inverse, option, spot)
  • symbol — Trading symbol (e.g., BTCUSDT)
  • limit — Data size limit per page
  • Problem — 401 Unauthorized or insufficient permissions
  • Solution — Verify your Bybit API key has the required permissions:

What it needs from you

  • Python 3.13+ - uv package manager

Recorded tools

  • symbol — Trading symbol (e.g., BTCUSDT)
  • limit — Data size limit per page

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
categoryProduct type (linear, inverse, option, spot)
symbolTrading symbol (e.g., BTCUSDT)
limitData size limit per page

How to install the Bybit Py MCP Server

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "BYBIT_API_KEY=your_api_key_here",
        "-e",
        "BYBIT_API_SECRET=your_api_secret_here",
        "-e",
        "BYBIT_TESTNET=false",
        "-e",
        "BYBIT_TRADING_ENABLED=false",
        "falconiun/bybit-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.13+ - uv package manager

Example prompts to try

  • “Use Bybit Py MCP to Trading.”
  • “Use Bybit Py MCP to Positions.”
  • “Use Bybit Py MCP to Account.”

Frequently asked questions

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 Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.