Bitget Mcp Server

by BitgetLimited

241 downloads

Not rated

GitHub

About

Gives AI assistants direct access to Bitget tools via the Model Context Protocol.

Details

Author: BitgetLimited
Downloads: 241
Categories: AI

- Real-time spot and futures market data without authentication.
- Place, cancel, and manage spot and futures orders.
- View account balances, internal transfers, deposits, and withdrawals.
- Read-only mode for safe monitoring and analytics.
- Modular loading of specific tools (spot, futures, account, margin, etc.).
- Compatible with Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Bitget Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

From the repository

Install via npx -y bitget-mcp-server --modules all or globally with npm. Configure in MCP-compatible clients (Claude Desktop, Cursor, Claude Code, Codex, OpenClaw, VS Code, Windsurf) by setting the environment variables BITGET_API_KEY, BITGET_SECRET_KEY, and BITGET_PASSPHRASE. Use the --modules flag to load specific modules (e.g., spot,futures,account) and --read-only to disable all write/trade operations.

`spot_get_ticker`

Get real-time ticker data for spot trading pair(s). Public endpoint. Rate limit: 20 req/s per IP.

`spot_get_depth`

Get orderbook depth for a spot trading pair. Public endpoint. Rate limit: 20 req/s per IP.

`spot_get_candles`

Get K-line data for spot trading pair. Public endpoint. Rate limit: 20 req/s per IP.

`spot_get_trades`

Get recent or historical trade records for spot symbol. Public endpoint. Rate limit: 10 req/s per IP.

`spot_get_symbols`

Get spot symbol info or coin chain info. Public endpoint. Rate limit: 20 req/s per IP.

`spot_place_order`

Place one or more spot orders. [CAUTION] Executes real trades. Private endpoint. Rate limit: 10 req/s per UID.

`spot_cancel_orders`

Cancel one or more spot orders by id, batch ids, or symbol-wide cancel. Private endpoint. Rate limit: 10 req/s per UID.

`spot_modify_order`

Cancel and replace a spot order atomically. Private endpoint. Rate limit: 10 req/s per UID.

`spot_get_orders`

Query spot order detail, open orders, or history orders. Private endpoint. Rate limit: 10 req/s per UID.

`spot_get_fills`

Get spot fills for order execution details. Private endpoint. Rate limit: 10 req/s per UID.

`spot_place_plan_order`

Create or modify spot plan order (trigger order). Private endpoint. Rate limit: 10 req/s per UID.

`spot_get_plan_orders`

Get current or historical spot plan orders. Private endpoint. Rate limit: 10 req/s per UID.

`spot_cancel_plan_orders`

Cancel one or multiple spot plan orders. Private endpoint. Rate limit: 10 req/s per UID.

`futures_get_ticker`

Get futures ticker for one symbol or all symbols in product type. Public endpoint. Rate limit: 20 req/s per IP.

`futures_get_depth`

Get futures orderbook depth with precision levels. Public endpoint. Rate limit: 20 req/s per IP.

`futures_get_candles`

Get futures candles from trade/index/mark price sources. Public endpoint. Rate limit: 20 req/s per IP.

`futures_get_trades`

Get recent or historical futures trade records. Public endpoint. Rate limit: 10 req/s per IP.

`futures_get_contracts`

Get futures contract configuration details. Public endpoint. Rate limit: 20 req/s per IP.

`futures_get_funding_rate`

Get current or historical funding rates for a futures symbol. Public endpoint. Rate limit: 20 req/s per IP.

`futures_get_open_interest`

Get open interest for a futures contract. Public endpoint. Rate limit: 20 req/s per IP.

`futures_place_order`

Place one or more futures orders with optional TP/SL. [CAUTION] Executes real trades. Private endpoint. Rate limit: 10 req/s per UID.

`futures_cancel_orders`

Cancel futures orders by order id, batch ids, or cancel-all mode. Private endpoint. Rate limit: 10 req/s per UID.

`futures_get_orders`

Query futures orders by id, open status, or history. Private endpoint. Rate limit: 10 req/s per UID.

`futures_get_fills`

Get futures fills and fill history records. Private endpoint. Rate limit: 10 req/s per UID.

`futures_get_positions`

Get current or historical futures positions. Private endpoint. Rate limit: 10 req/s per UID.

`futures_set_leverage`

Set futures leverage for symbol and margin coin. [CAUTION] Affects risk exposure. Private endpoint. Rate limit: 5 req/s per UID.

`futures_update_config`

Update futures margin mode, position mode, or auto-margin setting. [CAUTION] Affects trading behavior. Private endpoint. Rate limit: 5 req/s per UID.

`get_account_assets`

Get spot/futures/funding/all account balances. Private endpoint. Rate limit: 10 req/s per UID.

`get_account_bills`

Get account bill records for spot or futures account. Private endpoint. Rate limit: 10 req/s per UID.

`transfer`

Transfer funds between accounts or sub-account. [CAUTION] Moves funds. Private endpoint. Rate limit: 10 req/s per UID.

`withdraw`

Withdraw funds to external address. [DANGER] Irreversible fund movement. Private endpoint. Rate limit: 1 req/s per UID.

`cancel_withdrawal`

Cancel pending withdrawal request by order id. Private endpoint. Rate limit: 10 req/s per UID.

`get_deposit_address`

Get deposit address for coin and optional chain. Private endpoint. Rate limit: 10 req/s per UID.

`get_transaction_records`

Get deposit, withdrawal, or transfer records. Private endpoint. Rate limit: 10 req/s per UID.

`manage_subaccounts`

Create, modify, list subaccounts and manage subaccount API keys. [CAUTION] Account management operation. Private endpoint. Rate limit: 5 req/s per UID.

`system_get_capabilities`

Return machine-readable server capabilities and module availability for agent planning.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bitget mcp server": {
            "bitget-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "bitget-mcp-server"
                ],
                "env": {
                    "BITGET_API_KEY": "<your-api-key>",
                    "BITGET_SECRET_KEY": "<your-secret-key>",
                    "BITGET_PASSPHRASE": "<your-passphrase>"
                }
            }
        }
    }
}

McpServers

{
    "bitget-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "bitget-mcp-server"
        ],
        "env": {
            "BITGET_API_KEY": "<your-api-key>",
            "BITGET_SECRET_KEY": "<your-secret-key>",
            "BITGET_PASSPHRASE": "<your-passphrase>"
        }
    }
}

bitget-mcp-server

The official Bitget MCP (Model Context Protocol) server. Gives AI assistants direct, real-time access to the Bitget exchange through natural language.

Overview

| | | |---|---| | npm | bitget-mcp-server | | Binary | bitget-mcp-server | | Protocol | stdio (MCP) | | Node.js | ≥ 18 | | Source | packages/bitget-mcp/ |

Installation

Using npx (recommended — no install needed)

bash
npx -y bitget-mcp-server --modules all



Global install

bash
npm install -g bitget-mcp-server
bitget-mcp-server --modules all



Client Configuration


Claude Desktop


Edit

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json

 (Windows):

json
{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "bitget-mcp-server", "--modules", "all"],
      "env": {
        "BITGET_API_KEY": "your-api-key",
        "BITGET_SECRET_KEY": "your-secret-key",
        "BITGET_PASSPHRASE": "your-passphrase"
      }
    }
  }
}



Cursor


Create or edit

.cursor/mcp.json

 in your project root:

json
{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "bitget-mcp-server", "--modules", "spot,futures,account"],
      "env": {
        "BITGET_API_KEY": "your-api-key",
        "BITGET_SECRET_KEY": "your-secret-key",
        "BITGET_PASSPHRASE": "your-passphrase"
      }
    }
  }
}



> Cursor has a 40-tool limit. The default

spot,futures,account preset loads 34 tools — use --modules all

 only if you have headroom.

Claude Code (CLI)

bash
claude mcp add -s user \
  --env BITGET_API_KEY=your-api-key \
  --env BITGET_SECRET_KEY=your-secret-key \
  --env BITGET_PASSPHRASE=your-passphrase \
  bitget \
  -- npx -y bitget-mcp-server --modules all

Verify

claude mcp list



Codex


Add to

~/.codex/config.toml (global) or codex.toml

 in your project root:

toml
[[mcp_servers]]
name = "bitget"
command = "npx"
args = ["-y", "bitget-mcp-server", "--modules", "all"]

[mcp_servers.env]
BITGET_API_KEY = "your-api-key"
BITGET_SECRET_KEY = "your-secret-key"
BITGET_PASSPHRASE = "your-passphrase"



OpenClaw


Add to your OpenClaw agent config (JSON format):

json
{
  "mcp_servers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "bitget-mcp-server", "--modules", "all"],
      "env": {
        "BITGET_API_KEY": "your-api-key",
        "BITGET_SECRET_KEY": "your-secret-key",
        "BITGET_PASSPHRASE": "your-passphrase"
      }
    }
  }
}



VS Code (GitHub Copilot)


Create

.vscode/mcp.json

 in your project root (requires VS Code 1.102+):

json
{
  "servers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "bitget-mcp-server", "--modules", "all"],
      "env": {
        "BITGET_API_KEY": "your-api-key",
        "BITGET_SECRET_KEY": "your-secret-key",
        "BITGET_PASSPHRASE": "your-passphrase"
      }
    }
  }
}



Windsurf


Edit

~/.codeium/windsurf/mcp_config.json

json
{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "bitget-mcp-server", "--modules", "all"],
      "env": {
        "BITGET_API_KEY": "your-api-key",
        "BITGET_SECRET_KEY": "your-secret-key",
        "BITGET_PASSPHRASE": "your-passphrase"
      }
    }
  }
}



Other MCP Clients


Any MCP-compatible client can launch the server via stdio:

bash
BITGET_API_KEY=xxx BITGET_SECRET_KEY=yyy BITGET_PASSPHRASE=zzz \
  npx -y bitget-mcp-server --modules all



CLI Options


bitget-mcp-server [options]

Options:
  --modules <list>   Comma-separated modules to load (default: spot,futures,account)
                     Use "all" to load all modules
                     Available: spot, futures, account, margin, copytrading,
                                convert, earn, p2p, broker
  --read-only        Disable all write/trade operations
  --help             Show help
  --version          Show version



Read-Only Mode


Append

--read-only

 to expose only query tools — no order placement, no transfers, no withdrawals:

json
"args": ["-y", "bitget-mcp-server", "--modules", "all", "--read-only"]



Useful for:
- Monitoring and analytics dashboards
- Shared environments where trading should not be possible
- Demos and testing

Tools Overview


Market Data (no auth required)


| Tool | Description |
|:-----|:------------|
|

spot_get_ticker

 | Real-time spot price and 24h stats |
|

spot_get_depth

 | Spot order book |
|

spot_get_candles

 | Spot candlestick data |
|

futures_get_ticker

 | Real-time futures price |
|

futures_get_funding_rate

 | Funding rate (current + history) |
|

futures_get_open_interest

 | Open interest by symbol |

Trading (auth required)


| Tool | Description |
|:-----|:------------|
|

spot_place_order

 | Place spot orders (single or batch) |
|

spot_cancel_order

 | Cancel spot orders |
|

futures_place_order

 | Place futures orders |
|

futures_get_positions

 | View open futures positions |
|

futures_set_leverage

 | Set leverage for a symbol |

Account (auth required)


| Tool | Description |
|:-----|:------------|
|

account_get_balance

 | Asset balances |
|

transfer

 | Internal fund transfers |
|

get_deposit_address

 | Generate deposit addresses |
|

withdraw

 | On-chain withdrawal |

Agent Utility


| Tool | Description |
|:-----|:------------|
|

system_get_capabilities

 | Machine-readable module availability snapshot |

See Tools Reference for the complete list.

Package Structure


packages/bitget-mcp/
├── src/
│   ├── index.ts      # CLI entry: arg parsing, config loading, stdio transport
│   └── server.ts     # MCP Server: tool registration, request dispatch
├── package.json
├── tsconfig.json
└── tsup.config.ts

src/index.ts



Parses CLI flags (

--modules, --read-only, --help, --version

), loads config from environment variables, and starts the MCP server over stdio transport.

src/server.ts



Creates the MCP

Server instance, registers all tools from bitget-core, and handles list_tools / call_tool requests. Also implements the system_get_capabilities

 meta-tool for agent planning.

Dependencies


| Package | Version | Purpose |
|---|---|---|
|

bitget-core | workspace:*

 | API client, tools, config |
|

@modelcontextprotocol/sdk | ^1.26.0

 | MCP server protocol |

Troubleshooting


"Tool not found" error
The requested module is not loaded. Add it to

--modules

bash
npx -y bitget-mcp-server --modules spot,futures,account,margin



"AUTH_MISSING" error
Private tool called without credentials. Set

BITGET_API_KEY, BITGET_SECRET_KEY, BITGET_PASSPHRASE`. "CONFIG_ERROR: Partial API credentials" You set some but not all three env vars. All three must be provided together. Server not appearing in client Restart your AI client after editing the config file.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

spot_get_ticker

spot_get_depth

spot_get_candles

spot_get_trades

spot_get_symbols

spot_place_order

spot_cancel_orders

spot_modify_order

spot_get_orders

spot_get_fills

spot_place_plan_order

spot_get_plan_orders

spot_cancel_plan_orders

futures_get_ticker

futures_get_depth

futures_get_candles

futures_get_trades

futures_get_contracts

futures_get_funding_rate

futures_get_open_interest

futures_place_order

futures_cancel_orders

futures_get_orders

futures_get_fills

futures_get_positions

futures_set_leverage

futures_update_config

get_account_assets

get_account_bills

transfer

withdraw

cancel_withdrawal

get_deposit_address

get_transaction_records

manage_subaccounts

system_get_capabilities

Claude Desktop / Cursor

McpServers

bitget-mcp-server

Overview

Installation

Using npx (recommended — no install needed)

Global install

Client Configuration

Claude Desktop

Cursor

Claude Code (CLI)

Verify

Codex

OpenClaw

VS Code (GitHub Copilot)

Windsurf

Other MCP Clients

CLI Options

Read-Only Mode

Tools Overview

Market Data (no auth required)

Trading (auth required)

Account (auth required)

Agent Utility

Package Structure

src/index.ts

src/server.ts

Dependencies

Troubleshooting

Install

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

MaxKB

`spot_get_ticker`

`spot_get_depth`

`spot_get_candles`

`spot_get_trades`

`spot_get_symbols`

`spot_place_order`

`spot_cancel_orders`

`spot_modify_order`

`spot_get_orders`

`spot_get_fills`

`spot_place_plan_order`

`spot_get_plan_orders`

`spot_cancel_plan_orders`

`futures_get_ticker`

`futures_get_depth`

`futures_get_candles`

`futures_get_trades`

`futures_get_contracts`

`futures_get_funding_rate`

`futures_get_open_interest`

`futures_place_order`

`futures_cancel_orders`

`futures_get_orders`

`futures_get_fills`

`futures_get_positions`

`futures_set_leverage`

`futures_update_config`

`get_account_assets`

`get_account_bills`

`transfer`

`withdraw`

`cancel_withdrawal`

`get_deposit_address`

`get_transaction_records`

`manage_subaccounts`

`system_get_capabilities`