이 프로젝트는 CoinGlass API (v4)의 모델 Context Protocol (MCP) 서버를 구현합니다. 그것은 MCP 호환 클라이언트 (AI 조수, IDE 확장, 또는 사용자 정의 응용 프로그램) 액세스 선물 시장 분석과 같은 Open Interest, Liquidations, Long/Short 비율, 및 펀딩 요금.

특징 (MCP 공구)

서버는 MCP 클라이언트가 호출 할 수있는 다음 도구를 노출 :

• COINGLASS OPEN INTEREST: 기호에 대한 관심 교환 목록; 옵션 역사

• 매개 변수 : 기호 (문자), 교환? (string), include역사? (불린), 기간? (“1h” | “4h” | “12h” | “24h”)

• COINGLASS LIQUIDATIONS PAIR : 역사 쌍 액체 (v4 /api / futures /liquidation /history)

• 매개 변수 : 교환 (문자), 기호 (문자), 간격? (“1m”|“3m”|“15m”|“30m”|“1h”|“4h”|“6h”|“8h”|“12h”|“1d”|“1w”), 제한?, start time?, end time?, prettyFormat? (과태: 진실)

• COINGLASS LIQUIDATIONS COIN : 총 동전 액화 (v4 /api / futures /liquidation / Collected-history)

• 매개 변수: exchange list (string), 기호 (string), 간격? (위와 동일), 제한?, start time?, end time?, prettyFormat? (과태: 진실)

• 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