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
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. That is what the bybit py mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
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 supportRead-only — For market data (always safe)Trade — Required for order operations (enable only when needed)Position — Required for position managementWithdraw — Not required for this servercategory — Product type (linear, inverse, option, spot)symbol — Trading symbol (e.g., BTCUSDT)limit — Data size limit per pageProblem — 401 Unauthorized or insufficient permissionsSolution — Verify your Bybit API key has the required permissions:Configuration is passed through the environment: BYBIT_API_KEY, BYBIT_API_SECRET, BYBIT_TESTNET, BYBIT_TRADING_ENABLED, DOCKER_CONTAINER. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Bybit Py MCP's toolset — Trading, Positions, Account and 11 more — is a fair guide to whether it matches your workflow. It is maintained by BCusack; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Bybit Py MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| 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: |
| Prerequisites | The Prerequisites tool exposed by this server. |
| Tools | All tools support the following common parameters where applicable: |
{
"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"
]
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| BYBIT_API_KEY | Credential the server authenticates with. | Yes |
| BYBIT_API_SECRET | Credential the server authenticates with. | Yes |
| BYBIT_TESTNET | Configuration value read at startup. | Optional |
| BYBIT_TRADING_ENABLED | Configuration value read at startup. | Optional |
| DOCKER_CONTAINER | Configuration value read at startup. | Optional |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.