Bitunix MCP Server
Bitunix exchange spot and futures data access with optional trade execution.
Data last scanned today · Reviewed today
Overview
The Bitunix MCP server allows AI models to interact with the Bitunix cryptocurrency exchange. It provides tools for retrieving market data and managing positions across both Spot and USDT-M Futures markets. By default, it operates in a restricted read-only mode, ensuring AI assistants can query information without the ability to execute trades or modify account settings. To perform write actions, users must explicitly opt-in by setting the environment variable BITUNIX_ENABLE_TRADING to true. The architecture prioritizes a limited blast radius by hardcoding API endpoints, enforcing strict schema validation with Zod, and preventing all withdrawal-related functionality by omitting those endpoints from the implementation.
Our verdict
With a security score of 30/100, this server is classified as high-risk. This rating is largely due to it being a community-maintained project rather than an official Bitunix release, combined with the lack of independent editorial review. While the author has implemented significant internal safeguards, including Zod validation and a forced read-only default, users should exercise caution. It is recommended only for those who are comfortable using third-party code for financial interactions and who follow the provided best practices, such as binding IP addresses to API keys and utilizing a sub-account with limited funds.
- Hardcoded API endpoints prevent request redirection.
- Small footprint with only two direct dependencies.
- Trading capabilities are disabled by default.
- Withdrawal and transfer endpoints are entirely unimplemented.
- Community-maintained repository lacks official vendor support.
- Security architecture has not yet undergone editorial review.
- Single contributor model creates a bus-factor dependency risk.
- Low project activity with one GitHub star.
Setup
{
"mcpServers": {
"bitunix-mcp": {
"args": [
"-y",
"bitunix-mcp"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| futures_get_tickers | 24h tickers, optionally filtered by symbols | low |
| futures_get_depth | Order book bids/asks | low |
| futures_get_kline | Candlestick data (1m…1M intervals) | low |
| futures_get_funding_rate | Current funding rate | low |
| futures_get_trading_pairs | Contract specifications | low |
| futures_get_account | Balance and margin info | low |
| futures_get_positions | Open positions | low |
| futures_get_history_positions | Closed positions | low |
| futures_get_pending_orders | Open orders | low |
| futures_get_history_orders | Order history | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›Can this server perform withdrawals from my Bitunix account?
No, withdrawal, transfer, and deposit-address endpoints are not implemented and cannot be enabled.
›How do I enable the ability to place or cancel orders?
You must explicitly set the environment variable BITUNIX_ENABLE_TRADING to true to register the trading tools.
›Do I need an API key to access market data?
No, you can omit the API key and secret key to access public market data tools only.
›How are my API credentials handled?
API keys are read exclusively from environment variables and are redacted from all error messages and output.
›Can I use a custom base URL for the Bitunix API?
No, the base URLs are hardcoded as constants to prevent redirection, and no user input can modify them.
›What happens if I do not set the BITUNIX_ENABLE_TRADING flag?
The server defaults to read-only mode, and the trading tools will not be registered or visible to the AI client.
Alternatives
Badge
Maintain this server? Add the live badge to your README.