Skip to main content
Glama
rcz87

CoinGlass MCP Server

by rcz87
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

CoinGlass MCP Server

MCP Server yang menghubungkan Claude AI dengan CoinGlass API untuk analisis crypto derivatives real-time — dioptimasi untuk Ricoz Scalping Framework.

Arsitektur

Claude AI (claude.ai) ←── Streamable HTTP ──→ CoinGlass MCP Server (VPS)
                                                      │
                                                      ↓
                                              CoinGlass API V4

Related MCP server: CoinGlass MCP Server

18 Tools

Critical (Ricoz Scalping Core)

Tool

Endpoint

Fungsi

coinglass_spot_cvd

Spot Aggregated CVD

VETO SIGNAL — SpotCVD negatif = jangan long

coinglass_futures_cvd

Futures Aggregated CVD

Entry filter — konfirmasi arah

coinglass_funding_rate

FR semua exchange

Sentiment — extreme = contrarian

coinglass_open_interest

OI aggregated history

Positioning — OI + price direction

coinglass_liquidation_map

Liquidation clusters

Target — magnetic zones

coinglass_orderbook

Orderbook delta history

Pressure — bid/ask imbalance

Important (Supporting Analytics)

Tool

Fungsi

coinglass_price_ohlc

Price OHLC history

coinglass_liquidation_history

Liquidation volume over time

coinglass_long_short_ratio

L/S ratio (contrarian indicator)

coinglass_taker_buysell

Taker aggressor side

coinglass_fr_arbitrage

Extreme FR across all coins

coinglass_coins_markets

Market overview semua coin

Nice-to-Have

Tool

Fungsi

coinglass_whale_alert

Hyperliquid whale positions

coinglass_fear_greed

Fear & Greed index

coinglass_footprint

Footprint chart data (90d)

coinglass_spot_netflow

Exchange net flow

coinglass_orderbook_heatmap

Orderbook depth visual

Composite

Tool

Fungsi

coinglass_full_scan

ALL-IN-ONE — 9 metrics dalam 1 call

Quick Start

1. Clone & Install

git clone https://github.com/rcz87/McPCG.git
cd McPCG
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

2. Setup API Key

cp .env.example .env
nano .env  # masukkan COINGLASS_API_KEY

3. Run Server

# HTTP mode (untuk claude.ai remote)
python -m coinglass_mcp.server

# Stdio mode (untuk Claude Desktop lokal)
MCP_TRANSPORT=stdio python -m coinglass_mcp.server

Server berjalan di http://0.0.0.0:8787/mcp

4. Connect ke Claude

claude.ai (remote): Settings → Integrations → Add MCP Server → URL: http://YOUR_VPS_IP:8787/mcp

Claude Desktop (lokal):

{
  "mcpServers": {
    "coinglass": {
      "command": "python",
      "args": ["-m", "coinglass_mcp.server"],
      "cwd": "/path/to/McPCG",
      "env": {
        "COINGLASS_API_KEY": "your-key",
        "COINGLASS_PLAN": "standard",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Deploy ke VPS

One-Command Setup

# Di VPS:
git clone https://github.com/rcz87/McPCG.git ~/coinglass-mcp
cd ~/coinglass-mcp
bash deploy/setup-vps.sh

Management Commands

bash deploy/manage.sh start     # Start server
bash deploy/manage.sh stop      # Stop server
bash deploy/manage.sh restart   # Restart
bash deploy/manage.sh status    # PM2 status
bash deploy/manage.sh logs      # View logs
bash deploy/manage.sh update    # Pull + restart
bash deploy/manage.sh health    # Health check
bash deploy/manage.sh tools     # List tools

HTTPS (Optional tapi Recommended)

bash deploy/setup-nginx.sh yourdomain.com

Tech Stack

Component

Version

Python

>= 3.10

FastMCP

3.1.1

httpx

>= 0.25.0

tenacity

>= 8.2.0

CoinGlass API

V4

Project Structure

McPCG/
├── src/coinglass_mcp/
│   ├── __init__.py     # Package
│   ├── config.py       # Plan tiers, intervals, rate limits
│   ├── client.py       # Async HTTP client + caching + retry
│   └── server.py       # FastMCP server + 18 tools
├── tests/
│   ├── test_config.py  # Config tests
│   └── test_client.py  # Client tests
├── deploy/
│   ├── setup-vps.sh    # VPS setup script
│   ├── setup-nginx.sh  # Nginx + SSL setup
│   └── manage.sh       # Management commands
├── docs/
│   └── RICOZ-TRADING-CHEATSHEET.md
├── BLUEPRINT-MCP-SERVER.md
├── pyproject.toml
├── .env.example
└── .gitignore

Lisensi

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Hyperliquid MCP Server

    caiovicentino
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude Desktop to interact with Hyperliquid DEX for trading perpetual futures using natural language, supporting 27 tools across trading, account management, market data analysis, and real-time WebSocket subscriptions.
    37
    MIT

  • CoinGlass MCP Server

    forgequant
    F
    license
    A
    quality
    D
    maintenance
    Provides AI agents access to cryptocurrency derivatives analytics through 22 unified tools covering 80+ CoinGlass API endpoints. Enables analysis of open interest, funding rates, liquidations, whale positions, order book data, and market sentiment indicators with plan-aware feature gating.
    24
    1
    -

  • coinglass-mcp

    aviman1109
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to CoinGlass cryptocurrency derivatives data, including funding rates, open interest, and liquidation metrics. It enables LLMs to analyze real-time and historical market structure context through a standardized toolset.
    MIT

  • Market Pulse MCP

    decksaga
    A
    license
    A
    quality
    F
    maintenance
    Enables Claude to access real-time crypto prices, forex rates, and market sentiment data through free public APIs with no keys required.
    5
    3
    MIT