Awesome MCPs

A collection of Model Context Protocol (MCP) tools for crypto market data analysis, focusing on liquidation heatmaps and whale tracking on HyperLiquid.

Overview

This repository contains MCP tools that provide real-time crypto market data analysis capabilities, including:

• Liquidation heatmaps and maps from various exchanges
• HyperLiquid whale activity tracking
• Position and PnL analysis for HyperLiquid accounts
• Vietnam Stock Market data analysis via Fireant

Installation

# Clone the repository
git clone https://github.com/kewin1807/awesome-mcps.git
cd awesome-mcps

# Install dependencies
yarn install

Build

yarn build

Usage

# Start the MCP server by stdio
yarn start:stdio

# Start the MCP server by sse
yarn start

Available MCP Tools

Liquidation Analysis

• get_liquidation_heatmap: Get the liquidation heatmap data of a cryptocurrency pair.

  • Parameters:
    • symbol: Trading pair (e.g., BTCUSDT, ETHUSDT)
    • interval: Time interval (12h, 1d, 3d, 1w, 2w, 1m, 3m, 6m, 1y)
    • exchangeName: Exchange name (Binance, Bybit, Okex)

• get_liquidation_map: Get detailed information about liquidation positions by price level.

  • Parameters:
    • symbol: Trading pair (e.g., BTCUSDT, ETHUSDT)
    • interval: Time interval (1d, 1w)
    • exchange: Exchange name (Binance, Bybit, Okex)

HyperLiquid Whale Tracking

• get_latest_whale_actions: Get the latest whale actions on the HyperLiquid platform.

• get_whale_pnl_statistics: Get PnL statistics of whales on HyperLiquid.

• get_whale_positions: Get the list of whale positions on HyperLiquid.

  • Parameters:
    • page (optional): Page number
    • size (optional): Number of results per page

Address-specific Analysis

• get_address_total_pnl: Get the total PnL of a specific address on HyperLiquid.

  • Parameters:
    • address: HyperLiquid wallet address

• get_address_current_position: Get the current position of a specific address.

  • Parameters:
    • address: HyperLiquid wallet address

• get_address_position_history: Get the transaction/position history of a specific address.

  • Parameters:
    • address: HyperLiquid wallet address

Vietnam Stock Market Tools

• get_official_posts_vnstock: Get the list of official posts from Vietnam stock market.

  • Parameters:
    • offset (optional): The offset value
    • limit (optional): Number of results to return
    • symbol (optional): Filter by stock symbol

• get_user_posts_vnstock: Get the list of user posts from Vietnam stock market.

  • Parameters:
    • offset (optional): The offset value
    • limit (optional): Number of results to return
    • symbol (optional): Filter by stock symbol

• get_fundamental_analysis_vnstock: Get fundamental analysis data of a Vietnam stock ticker.

  • Parameters:
    • symbol: The stock symbol (e.g., VNM, FPT, VIC)

• get_company_profile_vnstock: Get company profile information of a Vietnam stock ticker.

  • Parameters:
    • symbol: The stock symbol (e.g., VNM, FPT, VIC)

• get_major_holders_vnstock: Get major shareholders information of a Vietnam stock ticker.

  • Parameters:
    • symbol: The stock symbol (e.g., VNM, FPT, VIC)

• get_historical_price_vnstock: Get historical price data of a Vietnam stock ticker.

  • Parameters:
    • symbol: The stock symbol (e.g., VNM, FPT, VIC)
    • startDate (optional): The start date in YYYY-MM-DD format
    • endDate (optional): The end date in YYYY-MM-DD format
    • offset (optional): The offset value
    • limit (optional): Number of records to return

• get_financial_statement_vnstock: Get financial statement data of a Vietnam stock ticker.

  • Parameters:
    • symbol: The stock symbol (e.g., VNM, FPT, VIC)
    • type: Financial statement period - 'Q' (quarterly) or 'Y' (yearly)
    • count (optional): Number of records to return

Implementation Details

The tools connect to various crypto data providers, including Coinank's API for market data and Fireant for Vietnam stock market data. The API keys are automatically fetched during runtime using a headless browser.