Liquidity Pools MCP Server

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

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.

Related MCP server: uniswap-trader-mcp

Prerequisites

• Python 3.10 or higher.

• uv: Recommended for managing dependencies (documentation).

Installation

1. Clone the Repository:

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

2. Install Dependencies:

   Using uv (recommended for faster dependency management):

   uv sync

   Or using pip:

   pip install mcp[cli]

3. 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:

Example Output:

License

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