get_orderbookLABSCO SUMMARY
Real money, so the dangerous half stays off until you switch it on.
The safety design is the reason to trust this one: trading tools error out by default, a separate read-only setting overrides everything, orders are capped by notional value, and validation and dry runs work regardless. On the read side, the snapshot tool is the practical win — one call instead of five when an agent wants the state of an instrument.
What it is
A server over the Bybit API split into three groups: market data, account reads, and mutating trading calls that stay disabled until you enable them.
What you get
- Market data: get_orderbook, get_kline, get_tickers, get_public_trade_history, get_instruments_info, get_funding_rate_history, get_open_interest, get_fee_rate and get_server_time
- market_snapshot bundles order book, ticker, candles, instrument metadata and recent trades — plus funding rate and open interest for futures — into a single call
- Account: get_wallet_balance, get_positions, get_order_history, get_open_orders and get_api_key_information
- Trading once enabled: place_order, amend_order, cancel_order, cancel_all_orders, set_trading_stop for take-profit and stop-loss, set_margin_mode and set_leverage
- validate_order checks an order without placing it and is never blocked by the trading switches; place_order also has a dry-run mode
- Trading is off by default, and a separate read-only setting hard-blocks every mutating tool regardless of the other switches
- An order-size cap limits the estimated notional value of any single order
- A trimmed response mode cuts ticker and position payloads down to their core fields to save context
Requirements
A Bybit API key and secret, with read permission at minimum, wallet permission for balances, and trade permission only if you intend to place orders. The README recommends restricting the key to the IP the server runs from. Python, run from a checkout or the published container image, with a testnet mode for experimenting.
Setup effort
Build from source — git clone https://github.com/dlwjdtn535/mcp-bybit-server.git
USE CASES
01
Getting the state of an instrument in one call
Take the order book, ticker, candles and recent trades together instead of stitching several calls into a picture.
02
Reviewing your own exposure
Read open positions, balances and resting orders without opening the exchange interface.
03
Checking an order before it exists
Run the pre-flight validation against the instrument's limits — it works even with trading switched off.
04
Placing a trade you have already decided on
With trading enabled, submit the order and attach the stop and target in the same session.
05
Backing out of everything quickly
Cancel a single resting order, or clear the book of your open orders in one call.
06
Studying a perpetual before you size a position
Read the funding history and open interest over time rather than the current snapshot alone.
23 tools
Listed in project docs. Your client may show a different list.
get_klineget_tickersget_public_trade_historyget_instruments_infoget_funding_rate_historyget_open_interestget_fee_rateget_server_timemarket_snapshotget_wallet_balanceget_positionsget_order_historyget_open_ordersget_api_key_informationvalidate_orderplace_orderamend_ordercancel_ordercancel_all_ordersset_trading_stopset_margin_modeset_leverageBEFORE YOU INSTALL
What to know first
Tools you get
23 tools named in the project's documentation.
Requires
- ACCESS_KEY in your environment
- SECRET_KEY in your environment
Where it runs
All 4 documented setups run the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/dlwjdtn535/mcp-bybit-server.git
cd mcp-bybit-server
uv syncMCP Clients
Claude Desktop, Cline, Roo Code
JSON
{
"mcpServers": {
"bybit": {
"command": "uv",
"args": [
"run",
"--directory",
"<YOUR_PATH_TO_MCP_BYBIT_SERVER>",
"mcp-bybit-server"
],
"env": {
"ACCESS_KEY": "<YOUR_ACCESS_KEY>",
"SECRET_KEY": "<YOUR_SECRET_KEY>",
"TESTNET": "true",
"TRADING_ENABLED": "false"
}
}
}
}Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"bybit-server-docker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"ACCESS_KEY=<YOUR_ACCESS_KEY>",
"-e",
"SECRET_KEY=<YOUR_SECRET_KEY>",
"-e",
"TESTNET=true",
"-e",
"TRADING_ENABLED=false",
"-e",
"MAX_ORDER_SIZE_USDT=100",
"dlwjdtn535/mcp-bybit-server:latest"
]
}
}
}
