Crypto Liquidations MCP Server

@kukapay

Basic information

About Crypto Liquidations MCP Server

An MCP server that streams real-time cryptocurrency liquidation events from Binance.

Crypto Liquidations MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "crypto-liquidations-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@kukapay/crypto-liquidations-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Crypto Liquidations MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Crypto Liquidations MCP?

An MCP server that streams real-time cryptocurrency liquidation events from Binance, enabling AI agents to react instantly to high-volatility market movements.

How to use Crypto Liquidations MCP?

Install via Smithery (npx -y @smithery/cli install @kukapay/crypto-liquidations-mcp --client claude) or clone the repository and run uv sync. Configure your MCP client (e.g., Claude Desktop) with the command uv --directory /path/to/crypto-liquidations-mcp run main.py. Once running, use the get_latest_liquidations tool to fetch recent events (with an optional limit parameter) and the analyze_liquidations prompt to analyze trends.

Key features of Crypto Liquidations MCP

Streams real-time liquidation events from Binance WebSocket.
Stores up to 1000 recent liquidation events in memory.
Provides get_latest_liquidations tool returning a Markdown table.
Offers analyze_liquidations prompt for trend analysis.
No persistent storage or disk writes.
Requires Python 3.10 and the uv package manager.

Use cases of Crypto Liquidations MCP

Fetch the most recent liquidation events to assess market volatility.
Analyze liquidation trends across all trading pairs to detect increasing or decreasing activity.
Integrate into AI agents that need to react to high-volatility movements from Binance.

Frequently asked questions

What data does Crypto Liquidations MCP stream?

It streams real-time cryptocurrency liquidation events from Binance via the `wss://fstream.binance.com/ws/!forceOrder@arr` WebSocket.

How many liquidation events are stored?

The server maintains an in-memory list of up to 1000 events. Older events are overwritten once the limit is reached.

Does Crypto Liquidations MCP save data to disk?

No, all data is stored in memory only. The server does not persist any data to disk.

What are the system requirements?

Python 3.10, the `uv` package manager, and internet access to connect to the Binance WebSocket.

How do I retrieve liquidation events with a custom limit?

Use the `get_latest_liquidations` tool with a `limit` parameter (default 10, maximum 1000). For example, ask "Show me the 5 most recent liquidation events from Binance."