Awesome Mcps

🚀 Awesome MCP Toolkit

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

🚀 Quick Start

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

• Liquidation heatmaps and detailed information from major exchanges
• Tracking of whale activities on the HyperLiquid platform
• Position and profit - and - loss (PnL) analysis of HyperLiquid accounts
• Analysis of Vietnamese stock market data through 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 Examples

Basic Usage

# Start the MCP server via standard input and output
yarn start:stdio

# Start the MCP server
yarn start

Available MCP Tools

Liquidation Analysis

• get_liquidation_heatmap: Get liquidation heatmap data for a specific 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 liquidation positions with detailed information 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 actions of whales on the HyperLiquid platform.
• get_whale_pnl_statistics: Get the profit - and - loss statistics of whales on HyperLiquid.
• get_whale_positions: Get the list of whale positions on the HyperLiquid platform.
  • Parameters:
    • page (optional): Page number
    • size (optional): Number of results per page

Address - Specific Analysis

• get_address_total_pnl: Get the total profit - and - loss 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 position history of a specific address.

Vietnamese Stock Market Analysis (via Fireant)

• fireant_stock_data: Get data from the Vietnamese stock market, including real - time prices and historical data.
  • Parameters:
    • stock_code: Stock code
    • interval (optional): Time interval

🔧 Technical Details

These tools connect to multiple cryptocurrency data providers, including Coinank's API and the Vietnamese stock market data provided by Fireant. API keys are automatically obtained at runtime through a headless browser.