Liquidity Pools

An MCP server that tracks and analyzes DEX liquidity pools.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You set up the Liquidity Pools MCP Server to fetch, organize, and present real-time liquidity pool data from DeX ecosystems. The server returns a clean markdown table of key metrics and provides a total liquidity figure to help you analyze market depth and(activity) across pools. This makes it easier to power automated strategies and intelligent agents with up-to-date DeFi insights.

How to use

You use an MCP client to call the get_liquidity_pools tool. Provide the target chain ID and the token address you want to analyze; the server will return a markdown table with Dex ID, Pair Address, Base/Quote symbols, Price USD, 24h Buys/Sells, 24h Volume, Liquidity USD, and Market Cap. You can then review the total liquidity across all pools to gauge overall liquidity depth.

Example prompts you can use in your client to analyze a token on a specific chain remain straightforward. For instance, you can request data for a token on the BSC chain and review the resulting table and total liquidity. The output is designed to be easily consumed by automated agents, dashboards, or notebooks.

When you receive the output, you will see a Markdown table with columns like Dex ID, Pair Address, Base/Quote, Price USD, 24h Buys/Sells, 24h Volume, Liquidity USD, and Market Cap, followed by a line showing the Total Liquidity USD. You can copy this output into reports, analytics pipelines, or UI components.

How to install

Prerequisites you need to prepare before installing: Python 3.10 or higher. It is recommended to use uv to manage dependencies for faster setup.

# 1) Clone the project repository
git clone https://github.com/kukapay/liquidity-pools-mcp.git
cd liquidity-pools-mcp

# 2) Install dependencies
# Option A: use uv for fast dependency management
uv sync

# Option B: fallback to pip
pip install mcp[cli]

Installing to Claude Desktop

To run the server locally and connect via Claude Desktop, install the MCP server using the runtime command shown.

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

Configuration snippet you can reference when configuring the MCP client:

{
  "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.


## Available tools

### get\_liquidity\_pools

Fetches liquidity pool details for a specified chain ID and token address, returning a markdown table with Dex ID, Pair Address, Base/Quote, Price USD, 24h Buys/Sells, 24h Volume, Liquidity USD, and Market Cap, plus total liquidity.