liquidity-pools-mcp

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.

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.