Purpose
crypto-liquidations-mcp is an MCP (Model Context Protocol) server used to stream cryptocurrency liquidation events from Binance in real time, enabling AI agents to respond instantly to highly volatile market conditions.
Main Capabilities
- Real-time liquidation streaming: Connect to the Binance WebSocket to capture liquidation events.
- Liquidation data storage: Maintain a list of up to 1000 liquidation events in memory, with no persistent storage.
- Tool get_latest_liquidations: Retrieve the latest liquidation events as a Markdown table. The table columns include Symbol, Side, Price, Quantity, Time (HH:MM:SS format). Parameter limit (default 10).
- Prompt analyze_liquidations: Generate a prompt for analyzing liquidation trends across all trading pairs, with the help of the get_latest_liquidations tool.
Usage
Environment requirements:
- Python 3.10: Required for compatibility.
- uv: Package and dependency manager (installation instructions below).
- Internet access: Used to connect to the Binance WebSocket.
Install via Smithery: Crypto Liquidations can be automatically installed for Claude Desktop via Smithery.
- Clone the repository
- Install dependencies Install the required packages using uv:
- Integrate with an MCP client Configure your MCP client to connect to this server. For Claude Desktop:
To get started, launch the MCP server to begin streaming liquidation events from Binance. The server runs silently, collecting up to 1000 recent events in memory, generating no logs, and saving no data to disk.
Retrieve liquidation events: Use the get_latest_liquidations tool to get the latest liquidation events. You can specify the number of events to retrieve via the limit parameter (up to 1000). For example, you can ask: "Show me the 5 most recent liquidation events from Binance." This will return a formattedneat table showing the trading pair, buy or sell direction, price, quantity, and the time of each liquidation (HH:MM:SS format).
Example output: This table makes it easy to view recent market activity, such as large buy or sell liquidations on Binance.
Analyze liquidation trends: The analyze_liquidations prompt helps you analyze the data more deeply. It generates instructions for analyzing liquidation trends across all trading pairs, focusing on frequency, trading volume, and market impact. The prompt recommends using the get_latest_liquidations tool to obtain data, ensuring you use the latest information. This is especially useful for understanding broader market dynamics, such as whether liquidations are increasing or whether they signal significant price movements.
Use Cases
- Enable AI agents to perceive cryptocurrency market liquidation events in real time.
- Quickly view recent liquidation activity on Binance, including large buy or sell liquidations.
- Analyze liquidation trends across all trading pairs, focusing on frequency, trading volume, and market impact.
Limitations
- Data is kept only in memory, up to 1000 records, with no persistent storage.
- Requires Python 3.10, the uv package manager, and internet access to the Binance WebSocket.
- The project uses the MIT license; see the LICENSE file for details.
