Crypto Liquidations MCP
Streams real-time Binance liquidation events to AI agents via MCP.
Key Features
Use Cases
README
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.
Features
- Real-time Liquidation Streaming: Connects to Binance WebSocket to capture liquidation events.
- Liquidation Data Storage: Maintains an in-memory list of up to 1000 liquidation events, with no persistent storage.
- Tool:
get_latest_liquidations:- Retrieves the latest liquidation events in a Markdown table.
- Columns:
Symbol,Side,Price,Quantity,Time(HH:MM:SS format). - Parameters:
limit(default 10).
- Prompt:
analyze_liquidations:- Generates a prompt to analyze liquidation trends across all symbols, leveraging the
get_latest_liquidationstool.
- Generates a prompt to analyze liquidation trends across all symbols, leveraging the
Prerequisites
- Python 3.10: Required for compatibility.
- uv: Package and dependency manager (install instructions below).
- Internet Access: To connect to Binance WebSocket.
Installation
Installing via Smithery
To install Crypto Liquidations for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kukapay/crypto-liquidations-mcp --client claude
1. Clone the Repository
git clone https://github.com/kukapay/crypto-liquidations-mcp.git
cd crypto-liquidations-mcp
2. Install Dependencies
Install required packages using uv:
uv sync
3. Integrate with an MCP Client
Configure your MCP client to connect to the server. For Claude Desktop:
{
"mcpServers": {
"crypto-liquidations": {
"command": "uv",
"args": ["--directory", "/path/to/crypto-liquidations-mcp", "run", "main.py"]
}
}
}
Usage
To get started, launch the MCP server to begin streaming liquidation events from Binance. The server runs quietly, collecting up to 1000 recent events in memory without generating logs or saving data to disk.
Retrieving Liquidation Events
Use the get_latest_liquidations tool to fetch the most recent liquidation events. You can specify how many events to retrieve (up to 1000) using the limit parameter. For example, you might ask:
"Show me the 5 most recent liquidation events from Binance."
This will return a neatly formatted table showing the trading pair, buy or sell side, price, quantity, and the time of each liquidation in HH:MM:SS format.
Example Output:
| Symbol | Side | Price | Quantity | Time |
|----------|------|--------|----------|----------|
| BTCUSDT | BUY | 50000 | 1.5 | 14:30:45 |
| ETHUSDT | SELL | 3000 | 10.0 | 14:30:40 |
| BNBUSDT | BUY | 500 | 20.0 | 14:30:35 |
| ADAUSDT | SELL | 1.2 | 1000.0 | 14:30:30 |
| XRPUSDT | BUY | 0.8 | 5000.0 | 14:30:25 |
This table makes it easy to see recent market activity, such as large buy or sell liquidations on Binance.
Analyzing Liquidation Trends
The analyze_liquidations prompt helps you dive deeper into the data. It generates instructions for analyzing liquidation trends across all trading pairs, focusing on frequency, volume, and market impact. The prompt suggests using the get_latest_liquidations tool to fetch data, ensuring you have the latest information to work with.
This is particularly useful for understanding broader market dynamics, such as whether liquidations are increasing or signaling significant price movements.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Crypto Portfolio MCP
Real-time crypto portfolio management and analysis via MCP.
Crypto Portfolio MCP is an MCP server that enables users and AI agents to track, manage, and optimize cryptocurrency portfolio allocations with live Binance price integration. It allows querying of portfolio status, addition of holdings, price fetching, value history chart generation, and portfolio analysis suggestions. The server provides persistent storage using SQLite and exposes API-like tools for seamless interaction through an MCP client. Designed for integration with platforms like Claude Desktop, it facilitates dynamic crypto asset management and insight generation.
- ⭐ 9
- MCP
- kukapay/crypto-portfolio-mcp
Crypto Trending MCP Server
Real-time trending cryptocurrency data via Model Context Protocol tools.
Crypto Trending MCP Server tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies. It exposes MCP tools and prompts, such as a Markdown generator for trending token data and a parser prompt for extracting and analyzing the results with AI models. The solution is built for seamless integration with clients like Claude Desktop and allows natural language querying of current crypto trends. Its lightweight and extensible design supports easy deployment and extension.
- ⭐ 6
- MCP
- kukapay/crypto-trending-mcp
ETF Flow MCP
MCP server for delivering crypto ETF flow data to AI agents.
ETF Flow MCP provides an MCP-compliant server that supplies historical and up-to-date ETF flow data for cryptocurrencies like BTC and ETH. It enables AI agents or applications to fetch, query, and present ETF data in structured formats, such as markdown tables with pivoted columns and summarized totals. The server integrates with platforms like Claude Desktop for seamless, user-friendly interactions using natural language prompts.
- ⭐ 6
- MCP
- kukapay/etf-flow-mcp
Coincap MCP
Query live cryptocurrency data through Coincap's public API for desktop AI tools.
Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.
- ⭐ 89
- MCP
- QuantGeekDev/coincap-mcp
Crypto Orderbook MCP
Real-time crypto order book analytics for AI agents and trading systems.
Crypto Orderbook MCP provides an MCP-compatible server that analyzes order book depth and imbalance across major cryptocurrency exchanges. It empowers AI agents and trading systems with unified, real-time market structure insights. Users can calculate and compare key order book metrics such as bid/ask depth and imbalance across multiple platforms using straightforward tools. The server returns data in structured formats for seamless integration with AI-enabled workflows.
- ⭐ 10
- MCP
- kukapay/crypto-orderbook-mcp
Hyperliquid Info MCP Server
Real-time Hyperliquid perp DEX data and analytics via MCP.
Provides an MCP-compliant server interface for accessing real-time user and market data from the Hyperliquid perpetual DEX. Enables bots, dashboards, and analytics platforms to query user positions, trading history, order books, and funding details seamlessly. Designed for integration with platforms like Claude Desktop and supports ISO 8601 time filtering.
- ⭐ 23
- MCP
- kukapay/hyperliquid-info-mcp
Didn't find tool you were looking for?