Liquidity Pools MCP Server

An MCP server that tracks and analyzes DEX liquidity pools to power intelligent DeFi agents and automated strategies.

GitHub License Python Version Status

Features

Liquidity Pool Data Retrieval: Fetches liquidity pool details for a specified chain ID and token address using the DexScreener API.
Markdown Table Output: Presents pool data in a clear markdown table with columns for Dex ID, Pair Address, Base/Quote Token Symbols, Price USD, 24h Buy/Sell Transactions, 24h Volume, Liquidity USD, and Market Cap.
Total Liquidity Calculation: Computes and displays the total liquidity in USD across all pools.
Prompt Guidance: Includes a prompt to guide users on analyzing liquidity pool data, including pool count, table output, total liquidity, and notable metrics.

Prerequisites

Python 3.10 or higher.
uv: Recommended for managing dependencies (documentation).

Installation

Clone the Repository:

git clone https://github.com/kukapay/liquidity-pools-mcp.git
cd liquidity-pools-mcp

Install Dependencies:

Using uv (recommended for faster dependency management):
```
uv sync
```
Or using pip:
```
pip install mcp[cli]
```

Installing to Claude Desktop:

Install the server as a Claude Desktop application:

uv run mcp install main.py --name "Liquidity Pools"

Configuration file as a reference:

{
   "mcpServers": {
       "Liquidity Pools": {
           "command": "uv",
           "args": [ "--directory", "/path/to/liquidity-pools-mcp", "run", "main.py" ] 
       }
   }
}

Replace /path/to/liquidity-pools-mcp with your actual installation path.

Usage

Use the MCP Inspector or integrate with a client (e.g., Claude Desktop) to call the get_liquidity_pools tool.

Example Prompt:

Fetch the liquidity pools for token 0xe6DF05CE8C8301223373CF5B969AFCb1498c5528 on chain bsc.

Example Output:

| Dex ID      | Pair Address                              | Base/Quote | Price USD | 24h Buys/Sells | 24h Volume | Liquidity USD | Market Cap |
|-------------|-------------------------------------------|------------|-----------|----------------|------------|---------------|------------|
| pancakeswap | 0x123...abc                              | CAKE/BUSD  | 2.45      | 150/100        | 500000     | 1000000       | 2000000    |
| apeswap     | 0x456...def                              | CAKE/BNB   | 2.43      | 80/50          | 300000     | 800000        | 1900000    |

**Total Liquidity USD**: 1800000

License

This project is licensed under the MIT License. See the LICENSE file for details.

Liquidity Pools MCP Server