blofin-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blofin-mcp show my open positions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BloFin MCP Server
A Model Context Protocol (MCP) server for the BloFin cryptocurrency exchange API. Provides tools for market data, account management, and trading operations.
Features
Public Data (no authentication required)
get_instruments- Get available trading instruments and contract specsget_tickers- Get latest prices, bid/ask, 24h volumeget_orderbook- Get order book depthget_trades- Get recent tradesget_mark_price- Get mark/index pricesget_candlesticks- Get OHLCV candlestick dataget_funding_rate- Get current funding ratesget_funding_rate_history- Get historical funding rates
Account (authentication required)
get_balance- Get futures account balanceget_positions- Get open positionsget_leverage_info- Get leverage info for an instrumentset_leverage- Set leverage for an instrumentget_margin_mode- Get current margin mode for an instrumentset_margin_mode- Set margin mode for an instrumentget_position_mode- Get current position modeset_position_mode- Set position modeget_account_config- Get account configuration
Trading (authentication required)
place_order- Place a new order (market, limit, post_only, fok, ioc)cancel_order- Cancel an orderbatch_orders- Place multiple orders at oncecancel_batch_orders- Cancel multiple orders at onceclose_position- Close a positionget_open_orders- Get pending ordersget_order_history- Get order historyget_order_detail- Get specific order detailsget_fills_history- Get trade fill historyplace_tpsl- Place take-profit/stop-loss ordercancel_tpsl- Cancel a take-profit/stop-loss orderget_pending_tpsl- Get pending TP/SL ordersget_tpsl_history- Get TP/SL order historyplace_algo_order- Place an algo order (trigger/conditional)cancel_algo_order- Cancel algo ordersget_pending_algo_orders- Get pending algo ordersget_algo_order_history- Get algo order history
Asset Management (authentication required)
get_asset_balances- Get balances across account typesfund_transfer- Transfer funds between accountsget_fund_transfer_history- Get transfer historyget_deposit_history- Get deposit historyget_withdrawal_history- Get withdrawal historyget_apikey_info- Get API key information
Related MCP server: gate-local-mcp
Important Risk Notice
Trading tools can place and cancel real orders.
Use demo environment first, then switch to production only when ready.
Create API keys with least privilege and restrict by IP whenever possible.
Never share your API key, secret, or passphrase.
Tool Coverage
Current implementation registers 40 tools in total:
Public Market Data: 8 tools
Account: 9 tools
Trading: 17 tools
Asset Management: 6 tools
Getting Your API Key
Go to blofin.com and log in (or create an account)
Navigate to APIs page
Click Create API Key and select BloFin MCP as the API type
Set your permissions (read-only for market data, or enable trading as needed)
Save your API Key, Secret Key, and Passphrase — you'll need them for configuration below
Environment Variables
Variable | Required | Description |
| Yes | Your BloFin API key |
| Yes | Your BloFin API secret |
| Yes | Your BloFin API passphrase |
| No | API base URL (defaults to demo trading) |
Base URLs
Demo Trading:
https://demo-trading-openapi.blofin.com(default)Production:
https://openapi.blofin.com
Install and Build
npm install
npm run typecheck
npm run buildInstallation
Claude Desktop (Extension)
Download the latest blofin-mcp.mcpb from GitHub Releases and double-click to install. Claude Desktop will prompt you to enter your API Key, API Secret, and Passphrase.
Claude Desktop (Manual)
Add to your Claude Desktop config (Settings → Developer → Edit Config):
{
"mcpServers": {
"blofin": {
"command": "npx",
"args": ["-y", "blofin-mcp"],
"env": {
"BLOFIN_API_KEY": "your-api-key",
"BLOFIN_API_SECRET": "your-api-secret",
"BLOFIN_PASSPHRASE": "your-passphrase",
"BLOFIN_BASE_URL": "https://openapi.blofin.com"
}
}
}
}Claude Code
claude mcp add blofin -- npx -y blofin-mcpThen set environment variables in your shell profile or .env file:
export BLOFIN_API_KEY="your-api-key"
export BLOFIN_API_SECRET="your-api-secret"
export BLOFIN_PASSPHRASE="your-passphrase"
export BLOFIN_BASE_URL="https://openapi.blofin.com"Cursor
Add to .cursor/mcp.json in your project root (or global config at ~/.cursor/mcp.json):
{
"mcpServers": {
"blofin": {
"command": "npx",
"args": ["-y", "blofin-mcp"],
"env": {
"BLOFIN_API_KEY": "your-api-key",
"BLOFIN_API_SECRET": "your-api-secret",
"BLOFIN_PASSPHRASE": "your-passphrase",
"BLOFIN_BASE_URL": "https://openapi.blofin.com"
}
}
}
}Windsurf
Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"blofin": {
"command": "npx",
"args": ["-y", "blofin-mcp"],
"env": {
"BLOFIN_API_KEY": "your-api-key",
"BLOFIN_API_SECRET": "your-api-secret",
"BLOFIN_PASSPHRASE": "your-passphrase",
"BLOFIN_BASE_URL": "https://openapi.blofin.com"
}
}
}
}Cline (VS Code)
Open Cline MCP settings (Cline → MCP Servers → Configure) and add:
{
"mcpServers": {
"blofin": {
"command": "npx",
"args": ["-y", "blofin-mcp"],
"env": {
"BLOFIN_API_KEY": "your-api-key",
"BLOFIN_API_SECRET": "your-api-secret",
"BLOFIN_PASSPHRASE": "your-passphrase",
"BLOFIN_BASE_URL": "https://openapi.blofin.com"
}
}
}
}OpenClaw
Add "mcpServers" to your ~/.openclaw/openclaw.json (top-level field, alongside identity, agent, etc.):
{
"identity": { "name": "Clawd", "emoji": "🦞" },
"agent": { "workspace": "~/.openclaw/workspace" },
// Add this section ↓
"mcpServers": {
"blofin": {
"command": "npx",
"args": ["-y", "blofin-mcp"],
"env": {
"BLOFIN_API_KEY": "your-api-key",
"BLOFIN_API_SECRET": "your-api-secret",
"BLOFIN_PASSPHRASE": "your-passphrase",
"BLOFIN_BASE_URL": "https://openapi.blofin.com"
}
}
}
}If your openclaw.json already has a "mcpServers" section with other servers, just add "blofin": { ... } inside it.
Restart OpenClaw after saving. The agent will automatically discover the 40 BloFin tools.
Open Source Project Files
License:
LICENSEContributing guide:
CONTRIBUTING.mdSecurity policy:
SECURITY.mdCommunity behavior policy:
CODE_OF_CONDUCT.mdChange history:
CHANGELOG.md
Reporting and Support
Bug reports and feature requests: GitHub Issues
Security issues: follow
SECURITY.mdAPI reference: BloFin API Docs
Available Tools
40 toolsbatch_ordersA
Place multiple orders at once (up to 20). All must share same instId and marginMode.
Inputs: orders (required).
cancel_algo_orderB
Cancel an algo order.
Inputs: instId, algoId, clientOrderId.
cancel_batch_ordersB
Cancel multiple orders at once.
Inputs: orders (required).
cancel_orderC
Cancel an existing order.
Inputs: orderId (required), instId, clientOrderId.
cancel_tpslB
Cancel take-profit/stop-loss orders. Accepts a JSON array of cancel objects.
Inputs: orders (required).
close_positionC
Close a position for an instrument via a market order.
Inputs: instId (required), marginMode (required), positionSide (required), clientOrderId, +1 more.
fund_transferB
Transfer funds between accounts (funding, futures, copy_trading, earn, spot, inverse_contract).
Inputs: currency (required), amount (required), fromAccount (required), toAccount (required), +3 more.
get_account_configA
Get account configuration including position mode, account level, etc.
Inputs: no named parameters.
get_algo_order_historyC
Get algo order history.
Inputs: orderType (required), instId, algoId, clientOrderId, +4 more.
get_apikey_infoA
Get API key information including permissions, IP whitelist, and expiration.
Inputs: no named parameters.
get_asset_balancesC
Get asset balances across different account types (funding, futures, etc.).
Inputs: accountType (required), currency.
get_balanceA
Get futures account balance details including equity, available balance, frozen amounts.
Inputs: productType.
get_candlesticksC
Get candlestick/kline data for an instrument.
Inputs: instId (required), bar, after, before, +1 more.
get_deposit_historyC
Get deposit history.
Inputs: currency, depositId, txId, state, +3 more.
get_fills_historyC
Get trade fill history for futures.
Inputs: instId, orderId, after, before, +3 more.
get_funding_rateB
Get current funding rate for instruments.
Inputs: instId.
get_funding_rate_historyB
Get historical funding rate data.
Inputs: instId (required), after, before, limit.
get_fund_transfer_historyB
Get fund transfer history between accounts.
Inputs: currency, fromAccount, toAccount, before, +2 more.
get_instrumentsA
Get available trading instruments. Returns contract specifications including min size, tick size, leverage limits.
Inputs: instId.
get_leverage_infoB
Get leverage info for an instrument.
Inputs: instId (required), marginMode (required).
get_margin_modeA
Get current account-level margin mode (cross or isolated).
Inputs: no named parameters.
get_mark_priceB
Get mark price and index price for instruments.
Inputs: instId.
get_open_ordersC
Get list of currently open/pending orders.
Inputs: instId, orderType, state, after, +2 more.
get_orderbookA
Get order book depth for an instrument.
Inputs: instId (required), size.
get_order_detailA
Get details of a specific order. Either orderId or clientOrderId or algoClientOrderId is required.
Inputs: instId (required), orderId, clientOrderId, algoClientOrderId.
get_order_historyC
Get order history.
Inputs: instId, orderType, state, after, +4 more.
get_pending_algo_ordersC
Get pending algo orders.
Inputs: instId, algoId, clientOrderId, orderType, +3 more.
get_pending_tpslB
Get pending take-profit/stop-loss orders.
Inputs: instId, tpslId, clientOrderId, after, +2 more.
get_position_modeA
Get current position mode (long_short_mode or net_mode).
Inputs: no named parameters.
get_positionsC
Get current open positions.
Inputs: instId.
get_tickersA
Get latest price snapshot, best bid/ask, and 24h trading volume for instruments.
Inputs: instId.
get_tpsl_historyB
Get take-profit/stop-loss order history.
Inputs: instId, tpslId, after, before, +1 more.
get_tradesB
Get recent trades for an instrument.
Inputs: instId (required), limit.
get_withdrawal_historyC
Get withdrawal history.
Inputs: currency, withdrawId, type, txId, +4 more.
place_algo_orderC
Place an algo order (trigger order).
Inputs: instId (required), marginMode (required), positionSide (required), side (required), +9 more.
place_orderC
Place a new futures order. Supports limit, market, post_only, fok, ioc order types.
Inputs: instId (required), marginMode (required), positionSide (required), side (required), +10 more.
place_tpslB
Place take-profit/stop-loss order for a position. Either tpTriggerPrice or slTriggerPrice (or both) must be provided.
Inputs: instId (required), marginMode (required), positionSide (required), side (required), +8 more.
set_leverageB
Set leverage for an instrument.
Inputs: instId (required), leverage (required), marginMode (required), positionSide.
set_margin_modeC
Set account-level margin mode.
Inputs: marginMode (required).
set_position_modeC
Set position mode.
Inputs: positionMode (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct resource or action, with clear separation between data retrieval (get_*), order placement (place_*), cancellation (cancel_*), and configuration (set_*). Even within similar categories like cancellations, the tool descriptions specify different order types or modes, avoiding ambiguity.
Most tools follow a consistent verb_noun pattern with underscores (e.g., get_balance, place_order). Minor deviations like 'batch_orders' (noun phrase as command) and 'fund_transfer' (two nouns) are present, but the overall pattern is predictable and readable.
With 40 tools, the set is comprehensive for a crypto exchange API covering orders, positions, account, market data, and transfers. While it is on the higher end, each tool serves a distinct purpose and is justified by the complexity of the domain.
The tool surface covers full lifecycle operations for orders (place, cancel, query), positions (close, leverage, margin mode), account configuration, market data (orderbook, candlesticks, tickers), transfers, and history. No obvious gaps are present for a typical futures trading workflow.
Maintenance
Related MCP Connectors
Crypto perps market data, backtests and BloFin trading agents. Free with a key or x402 per call.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
33 pay-per-call market and news data tools over MCP with free discovery and x402 payments.
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceMCP server for the Crypto.com Exchange API, providing 86 dynamically generated tools for market data, trading, account management, and more with real-time WebSocket streaming and safety enforcement.48 npm27Apache 2.0
gate-local-mcpofficial
AlicenseNot gradedqualityDmaintenanceExposes the full Gate API v4 to MCP clients with 384 tools for spot, futures, margin, wallet, and more. Supports both public endpoints (no auth) and authenticated trading operations.303 npm1MIT- FlicenseNot gradedqualityDmaintenanceEnables AI tools to execute trades and fetch market data across six crypto exchanges via natural language or API, with dual Telegram and MCP interfaces.2-

TradeStaq MCPofficial
AlicenseBqualityBmaintenanceProvides 31 AI-powered crypto trading tools for Claude, Cursor, and any MCP client, enabling strategy creation, backtesting, bot deployment, copy trading, and portfolio management across multiple exchanges.342,570 npmMIT