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 specs
get_tickers - Get latest prices, bid/ask, 24h volume
get_orderbook - Get order book depth
get_trades - Get recent trades
get_mark_price - Get mark/index prices
get_candlesticks - Get OHLCV candlestick data
get_funding_rate - Get current funding rates
get_funding_rate_history - Get historical funding rates

Account (authentication required)

get_balance - Get futures account balance
get_positions - Get open positions
get_leverage_info - Get leverage info for an instrument
set_leverage - Set leverage for an instrument
get_margin_mode - Get current margin mode for an instrument
set_margin_mode - Set margin mode for an instrument
get_position_mode - Get current position mode
set_position_mode - Set position mode
get_account_config - Get account configuration

Trading (authentication required)

place_order - Place a new order (market, limit, post_only, fok, ioc)
cancel_order - Cancel an order
batch_orders - Place multiple orders at once
cancel_batch_orders - Cancel multiple orders at once
close_position - Close a position
get_open_orders - Get pending orders
get_order_history - Get order history
get_order_detail - Get specific order details
get_fills_history - Get trade fill history
place_tpsl - Place take-profit/stop-loss order
cancel_tpsl - Cancel a take-profit/stop-loss order
get_pending_tpsl - Get pending TP/SL orders
get_tpsl_history - Get TP/SL order history
place_algo_order - Place an algo order (trigger/conditional)
cancel_algo_order - Cancel algo orders
get_pending_algo_orders - Get pending algo orders
get_algo_order_history - Get algo order history

Asset Management (authentication required)

get_asset_balances - Get balances across account types
fund_transfer - Transfer funds between accounts
get_fund_transfer_history - Get transfer history
get_deposit_history - Get deposit history
get_withdrawal_history - Get withdrawal history
get_apikey_info - Get API key information

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 | |---|---|---| | BLOFIN_API_KEY | Yes | Your BloFin API key | | BLOFIN_API_SECRET | Yes | Your BloFin API secret | | BLOFIN_PASSPHRASE | Yes | Your BloFin API passphrase | | BLOFIN_BASE_URL | 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 build

Installation

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-mcp

Then 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: LICENSE
Contributing guide: CONTRIBUTING.md
Security policy: SECURITY.md
Community behavior policy: CODE_OF_CONDUCT.md
Change history: CHANGELOG.md

Reporting and Support

Bug reports and feature requests: GitHub Issues
Security issues: follow SECURITY.md
API reference: BloFin API Docs

Blofin MCP

Install / Use

README