How to Use the Bybit MCP in Claude

Q: How do I connect the Bybit MCP Server to Claude Desktop?

Open your claudedesktopconfig.json file and add the Bybit server under the mcpServers key. This links the MCP Server directly to your client. Restart the Claude Desktop app, check the hammer icon in your chat box, and start asking for live market tickers.

Q: Can Claude Desktop pull Bybit orderbook depth in real time?

Yes. Claude Desktop uses the getorderbook tool to pull current bids and asks directly into your active chat. You get raw price levels and quantities up to 500 levels deep for derivatives.

Get real-time Bybit orderbook and funding data directly inside Claude Desktop to analyze crypto markets without leaving your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bybit MCP to Claude Desktop

Create your Vinkius account to connect Bybit to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Bybit with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Orderbook and Trade Analysis in Claude Desktop

The `get_orderbook` tool pulls real-time bids and asks from Bybit straight into your Claude Desktop chat window. You can ask Claude to analyze market depth or spot immediate liquidity walls on the exchange without switching to a browser tab. This setup uses local stdio transport to pipe the Bybit `get_recent_trades` tool directly into your desktop workspace. Claude parses raw trade size and side data to point out block trades as they happen on the exchange.

Historical Candlestick and Trend Calculations

The `get_kline` tool pulls historical candlestick data for Bybit spot and derivatives markets directly into Claude Desktop. You get precise open, high, low, and close values across customizable intervals from one minute up to a month. By combining this with the `get_index_price_kline` tool, Claude calculates Bybit index premiums and discounts on the fly. Claude processes these raw exchange arrays locally, letting you write custom trading scripts or backtest simple Bybit strategies inside your chat.

Spot Funding Rate Shifts via this MCP Server

The `get_funding_history` tool exposes actual Bybit funding payments made between longs and shorts every eight hours on perpetual contracts. Claude Desktop reads these rates to help you identify sentiment shifts on linear or inverse contracts. With the `get_open_interest` tool, Claude maps out total active Bybit positions alongside these funding rates. This gives you a clear picture of position risk building up on the exchange without needing to open a separate terminal.

Setup guide

Set up Bybit MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Bybit MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Bybit MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under bybit-mcp.

json

{
  "mcpServers": {
    "bybit-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Bybit. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Bybit now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Bybit MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the Bybit server under the `mcpServers` key. This links the MCP Server directly to your client. Restart the Claude Desktop app, check the hammer icon in your chat box, and start asking for live market tickers.

Yes. Claude Desktop uses the `get_orderbook` tool to pull current bids and asks directly into your active chat. You get raw price levels and quantities up to 500 levels deep for derivatives.

Claude Desktop manages requests sequentially through the configured MCP server. If you ask for heavy historical klines via `get_kline`, the server handles the execution limit of up to 1000 candles per call to avoid API bans.

No. All ten tools in this server pull public market data, including `get_tickers` and `get_instruments`. You don't need to configure private API keys or expose account credentials to run these queries.

Yes. This MCP Server only handles public crypto market data like tickers and funding rates. Because Claude Desktop runs the server locally via stdio, no trade requests or query logs are sent to third parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript