Bybit
A Model Context Protocol (MCP) server for integrating AI assistants with Bybit cryptocurrency exchange APIs, enabling automated trading, market data access, and account management.
What is Bybit?
Bybit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for integrating ai assistants with bybit cryptocurrency exchange apis, enabling automated trading, market data access, and account management.
A Model Context Protocol (MCP) server for integrating AI assistants with Bybit cryptocurrency exchange APIs, enabling automated trading, market data access, and account management.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server for integrating AI ass
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bybitConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bybit
Bybit MCP Server is a TypeScript MCP server that integrates AI assistants with the Bybit V5 cryptocurrency exchange API, exposing tools for real-time market data, account management, and trade execution. It supports both testnet (safe, no real funds) and mainnet environments and covers market data (prices, order books, candlesticks, 24h tickers), account operations (balances, order history), and trading actions (place, cancel, cancel-all orders). Crypto traders and developers use it to build AI-driven trading workflows, backtest strategies conversationally, or monitor positions through Claude or Cursor without writing custom exchange integration code.
Prerequisites
- Node.js 16 or later installed
- A Bybit account — testnet (testnet.bybit.com) is strongly recommended for safe testing
- Bybit API key and secret with read and trade permissions (create in Bybit → API Management)
- BYBIT_API_KEY and BYBIT_API_SECRET environment variables
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
Install the package globally
Install bybit-mcp-server globally via npm so it's available as a command anywhere on your system.
npm install -g bybit-mcp-serverCreate Bybit API keys
For testnet, visit testnet.bybit.com, create an account, go to API Management, and generate an API key with read and trade permissions. For mainnet, complete account verification on bybit.com first, then create the key with IP restrictions for security.
Configure Claude Desktop for testnet
Add the server to claude_desktop_config.json. Start with testnet to verify everything works before using real funds. BYBIT_ENVIRONMENT defaults to 'testnet' if not set.
{
"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"
}
}
}
}Configure for mainnet (use with caution)
Switch to mainnet only after thorough testnet verification. All trading operations will use real funds. The server displays warnings when mainnet is active.
{
"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"
}
}
}
}Restart your MCP client and verify connection
Restart Claude Desktop or Cursor after saving the config. Ask for the current BTCUSDT price to confirm the market data tools are working.
Bybit Examples
Client configuration (testnet)
Claude Desktop config for Bybit testnet — safe for testing without real funds.
{
"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"
}
}
}
}Prompts to try
Example prompts for market data, account inspection, and trading operations.
- "Get the current price of BTCUSDT on Bybit"
- "Show me the order book for ETHUSDT with 50 levels"
- "Get 1-hour candlestick data for SOLUSDT for the last 24 hours"
- "What is my current wallet balance?"
- "Show all my open orders"
- "Place a limit buy order for 0.001 BTC at $50000 on testnet"
- "Cancel all my open orders for BTCUSDT"Troubleshooting Bybit
Authentication error: invalid API key or signature
Double-check BYBIT_API_KEY and BYBIT_API_SECRET are set correctly and that the keys were generated for the correct environment (testnet vs mainnet). Testnet keys do not work on mainnet and vice versa.
Order placement returns 'insufficient balance' on testnet
Testnet accounts start with zero balance. Log in to testnet.bybit.com, go to Assets → Testnet Faucet, and claim test USDT or BTC to fund your testnet account before placing orders.
Server starts but market data tools return empty results
Verify BYBIT_ENVIRONMENT matches the environment your API keys were generated for. Also confirm the trading symbol format — Bybit V5 uses formats like 'BTCUSDT' (no slash). Check the DEBUG=true env var output for the raw API response.
Frequently Asked Questions about Bybit
What is Bybit?
Bybit is a Model Context Protocol (MCP) server that model context protocol (mcp) server for integrating ai assistants with bybit cryptocurrency exchange apis, enabling automated trading, market data access, and account management. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bybit?
Follow the installation instructions on the Bybit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bybit?
Bybit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bybit free to use?
Yes, Bybit is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Bybit Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Bybit? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bybit in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bybit?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.