CoinGlass

Provides an MCP server offering CoinGlass API endpoints through 22 tools for AI agents.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "forgequant-coinglass-mcp": {
      "command": "coinglass-mcp",
      "args": [],
      "env": {
        "COINGLASS_PLAN": "standard",
        "COINGLASS_API_KEY": "sk_test_abc123"
      }
    }
  }
}

The CoinGlass MCP Server lets you query CoinGlass’s cryptocurrency derivatives analytics through a unified, AI-friendly interface. It exposes 80+ API endpoints via 22 cohesive tools, with plan-aware access, built-in caching, and robust retry logic to keep your AI agents productive and efficient.

How to use

Launch the MCP server locally to provide AI agents with access to CoinGlass data. Connect your agent or client to the local MCP endpoint and reference the 22 tools to perform market, funding, open interest, and sentiment analyses. The server enforces the plan restrictions, caches responses for fast iteration, and retries transient failures to improve reliability. Use environment variables to supply your API key and select a plan before starting.

How to install

Prerequisites: you need Python and a command-line shell. You may also install via uv if you prefer using uv for Python tooling.

# Install the MCP package
pip install coinglass-mcp

# Optional: install via uv if you prefer uv tooling
uv pip install coinglass-mcp

Configuration

Set your CoinGlass API key and select a plan before starting the server. These values are read by the MCP server at runtime.

export COINGLASS_API_KEY="your-api-key"
export COINGLASS_PLAN="standard"  # hobbyist | startup | standard | professional | enterprise

Run locally

Start the MCP server so your AI client can begin issuing tool calls.

coinglass-mcp

Available tools

coinglass_market_info

Query supported coins, trading pairs, and exchanges.

coinglass_market_data

Fetch real-time market summaries.

coinglass_price_history

Retrieve OHLC price candles for given symbols and intervals.

coinglass_oi_history

Obtain OI OHLC data for chosen symbols/aggregations.

coinglass_oi_distribution

Get open interest breakdown by exchange.

coinglass_funding_history

Access historical funding rate OHLC data.

coinglass_funding_current

Retrieve current funding rates and related metrics.

coinglass_long_short

Get global long/short ratios and top accounts.

coinglass_liq_history

Fetch liquidation OHLC history.

coinglass_liq_orders

Stream real-time liquidation orders.

coinglass_liq_heatmap

Provide liquidation heatmaps.

coinglass_ob_history

Bid/ask depth history from the order book.

coinglass_ob_large_orders

Detect whale-sized orders in the order book.

coinglass_whale_positions

Track hyperliquid whale positions and activity.

coinglass_whale_index

Index of whale activity across markets.

coinglass_taker

Taker buy/sell volume and ratio.

coinglass_spot

Spot market data and pricing.

coinglass_options

Options data including max pain, open interest, and volume.

coinglass_onchain

On-chain balances, flows, and transfers.

coinglass_etf

ETF flows for Bitcoin and Ethereum.

coinglass_grayscale

Grayscale holdings and premium insights.

coinglass_indicators

Market indicators like RSI, Fear & Greed, Rainbow, Pi Cycle.

coinglass_search

Discover tools by keyword.

coinglass_config

View exchanges, intervals, and features available per plan.