このプロジェクトでは、CoinGlass API (v4) 用のモデルコンテキストプロトコル (MCP) サーバを実装しています。 MCP 互換クライアント (AI アシスタント、IDE 拡張機能、カスタム アプリ) は、Open Interest、Liquidations、Long/Short Ratio、および Funding レートなどの市場分析にアクセスします。

機能(MCPツール)

サーバは、MCP クライアントが次のツールを呼び出します。

• COINGLASS OPEN INTEREST:シンボルの利息交換リストを開く;オプション履歴

• パラメーター: シンボル(文字列)、交換? (string),includeHistory? (ブーラン)、期間?(1h) | 4h | 12h | 24h

• COINGLASS LIQUIDATIONS PAIR:歴史的なペアの清算 (v4 /api/futures/liquidation/history)

• パラメータ:交換(文字列)、記号(文字列)、間隔(「1m」|「3m」|「5m」|「15m」|「30m」|「1h」|「4h」|「6h」|「8h」|「12h」|「1d」|「1d」|「1w」)、制限?、start time?、end time?、 PrettyFormat? (デフォルト:true)

• COINGLASS LIQUIDATIONS COIN: 集計されたコインの清算 (v4 /api/futures/liquidation/aggregated-history)

• パラメーター: exchange list (string), 記号 (string), 間隔? (上記と同じ), limit?, start time?, end time?, PrettyFormat? (デフォルト:true)

• COINGLASS LONG SHORT RATIO:グローバルアカウントロング/ショート比スナップショット

MCP-Coinglass

This project implements a Model Context Protocol (MCP) server for the CoinGlass API (v4). It lets MCP-compatible clients (AI assistants, IDE extensions, or custom apps) access futures market analytics such as Open Interest, Liquidations, Long/Short Ratio, and Funding Rates.

Features (MCP Tools)

The server exposes the following tools that MCP clients can call:

• COINGLASS_OPEN_INTEREST: Open interest exchange list for a symbol; optional history

  • Parameters: symbol (string), exchange? (string), includeHistory? (boolean), period? (“1h” | “4h” | “12h” | “24h”)

• COINGLASS_LIQUIDATIONS_PAIR: Historical pair liquidations (v4 /api/futures/liquidation/history)

  • Parameters: exchange (string), symbol (string), interval? (“1m”|“3m”|“5m”|“15m”|“30m”|“1h”|“4h”|“6h”|“8h”|“12h”|“1d”|“1w”), limit?, start_time?, end_time?, prettyFormat? (default: true)

• COINGLASS_LIQUIDATIONS_COIN: Aggregated coin liquidations (v4 /api/futures/liquidation/aggregated-history)

  • Parameters: exchange_list (string), symbol (string), interval? (same as above), limit?, start_time?, end_time?, prettyFormat? (default: true)

• COINGLASS_LONG_SHORT_RATIO: Global account long/short ratio snapshot

  • Parameters: symbol (string), exchange? (string), period? (“1h” | “4h” | “12h” | “24h”), prettyFormat? (boolean, default: true)

• COINGLASS_FUNDING_RATE: Current funding rate across exchanges

  • Parameters: symbol (string), exchange? (string), prettyFormat? (boolean, default: true)

• COINGLASS_HYPERLIQUID_WHALE_ALERT: Real-time Hyperliquid whale alerts (>$1M)

• Parameters: prettyFormat? (boolean, default: true)

• COINGLASS_HYPERLIQUID_WHALE_POSITION: Real-time Hyperliquid whale positions (>$1M)

• Parameters: prettyFormat? (boolean, default: true)

Tool call responses always return a success code even in case of api errors. In case of error tool response includes the raw api response.

Prerequisites

• Node.js v20+ (CI uses Node 22)
• pnpm (https://pnpm.io/installation)

Installation

There are a few ways to run mcp-coinglass:

1. Using pnpm dlx (recommended for most MCP client setups)

Run the published package directly without a global install. See the MCP client config example below.

2. Global installation from npm (via pnpm)

pnpm add -g mcp-coinglass

3. Building from source (development)

pnpm install
pnpm run build
pnpm run start

4. For testing and development purposes use mcp inspector

# in the project root run,
pnpm run build
npx @modelcontextprotocol/inspector node dist/index.js

Configuration (Environment Variables)

This server requires a CoinGlass API key. All CoinGlass v4 endpoints require the CG-API-KEY header. Generate your API key from your account dashboard and supply it via environment variables. References:

• Authentication docs: https://docs.coinglass.com/reference/authentication
• Account/API key dashboard: https://www.coinglass.com/account