What is Awesome Mcps

awesome-mcps is a comprehensive collection of Model Context Protocol (MCP) tools designed for crypto market data analysis, focusing on liquidation heatmaps and whale tracking on the HyperLiquid platform.

Use cases

Use cases for awesome-mcps include analyzing liquidation risks for specific cryptocurrency pairs, tracking whale movements to inform trading decisions, and evaluating the performance of specific addresses on the HyperLiquid platform.

How to use

To use awesome-mcps, clone the repository from GitHub, install the necessary dependencies using ‘yarn install’, and then start the MCP server using either ‘yarn start:stdio’ for standard input/output or ‘yarn start’ for server-sent events.

Key features

Key features of awesome-mcps include real-time liquidation heatmaps, detailed liquidation maps from various exchanges, whale activity tracking on HyperLiquid, and position and PnL analysis for HyperLiquid accounts.

Where to use

awesome-mcps can be used in the cryptocurrency market for data analysis, particularly in trading strategies, risk management, and market trend analysis.

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.