kukapay/dex-pools-mcp

An MCP server that provides AI agents with real-time access to DEX liquidity pool data, enabling smarter trading, analytics, and automated strategies.
Features
- **Query Supported Networks**: Retrieve a list of supported blockchain networks on GeckoTerminal.
- **Query Supported DEXes**: Fetch DEXes available on a specific network.
- **Fetch New Pools**: List the latest pools across all networks or a specific network, with details like DEX, network, name, base price, reserve, volume, and address.
- **Fetch Trending Pools**: Retrieve trending pools across all networks or a specific network, sorted by duration (5m, 1h, 6h, 24h).
- **Fetch Top Pools**: Get top pools for a specific network or DEX, sorted by transaction count or volume.
- **Search Pools**: Search for pools on a specific network using a query term (e.g., token name or symbol).
Prerequisites
- Python 3.10 or higher
- **uv**: Package and virtual environment manager for Python (recommended for dependency management).
- A CoinGecko Demo API key (obtainable from coingecko.com)
Installation
1. **Clone the Repository**:
2. Install dependencies:
3. Install to Claude Desktop:
Install the server as a Claude Desktop application:
Configuration file as a reference:
Replace /path/to/dex-pools-mcp with your actual installation path, and replace coingecko_api_key with your API key from CoinGecko.
Usage
Available Tools
The server provides the following tools, accessible via MCP clients (e.g., Claude Desktop) or the MCP Inspector:
- get_supported_networks(page: int = 1): Returns a table of supported network IDs and names.
- get_supported_dexes_by_network(network: str = "eth", page: int = 1): Returns a table of DEX IDs and names for a given network.
- get_new_pools(page: int = 1, include: str = "base_token,quote_token,dex,network"): Returns a table of new pools across all networks with columns: DEX, Network, Name, Base Price (USD), Reserve (USD), Volume 24h (USD), Address.
- get_new_pools_by_network(network: str = "eth", page: int = 1, include: str = "base_token,quote_token,dex,network"): Returns a table of new pools for a specific network with columns: DEX, Name, Base Price in Quote, Reserve (USD), Volume 24h (USD), Address.
- get_trending_pools(page: int = 1, duration: str = "24h", include: str = "base_token,quote_token,dex,network"): Returns a table of trending pools across all networks with columns: DEX, Network, Name, Base Price in Quote, Reserve (USD), Volume 24h (USD), Address.
- get_trending_pools_by_network(network: str = "eth", page: int = 1, duration: str = "24h", include: str = "base_token,quote_token,dex"): Returns a table of trending pools for a specific network.
- get_top_pools_by_network(network: str = "eth", page: int = 1, sort: str = "h24_tx_count_desc", include: str = "base_token,quote_token,dex"): Returns a table of top pools for a specific network.
- get_top_pools_by_dex(network: str = "eth", dex: str = "sushiswap", page: int = 1, sort: str = "h24_tx_count_desc", include: str = "base_token,quote_token,dex"): Returns a table of top pools for a specific DEX on a network.