Which integrations are available for this server?

Provides real-time access to DEX liquidity pool data on the BNB Chain network, enabling querying of new, trending, top pools, and searching pools by token name. Provides real-time access to DEX liquidity pool data on the Ethereum network, enabling querying of new, trending, top pools, and searching pools by token name. Provides real-time access to DEX liquidity pool data on the Polygon network, enabling querying of new, trending, top pools, and searching pools by token name.

How do I use DEX Pools MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@DEX Pools MCP show me trending pools on Ethereum in the last 24h" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

DEX Pools MCP

by kukapay

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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).

Related MCP server: Armor Crypto MCP

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

Clone the Repository:

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

Install dependencies:
```
uv sync
```

Install to Claude Desktop:

Install the server as a Claude Desktop application:

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

Configuration file as a reference:

{
   "mcpServers": {
       "DEX Pools": {
           "command": "uv",
           "args": [ "--directory", "/path/to/dex-pools-mcp", "run", "main.py" ],
           "env": { "COINGECKO_API_KEY": "coingecko_api_key"}
       }
   }
}

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.
search_pools(query: str = "weth", network: str = "eth", page: int = 1, include: str = "base_token,quote_token,dex"): Returns a table of pools matching a search query on a specific network.

Examples

Below are examples for each tool, including a natural language prompt and the expected output (mock data for illustration).

1. `get_supported_networks`

Prompt: "List the supported blockchain networks on GeckoTerminal for page 1."

Output:

+----------+-----------------+
| ID       | Name            |
+==========+=================+
| eth      | Ethereum        |
+----------+-----------------+
| bsc      | BNB Chain       |
+----------+-----------------+
| polygon  | Polygon         |
+----------+-----------------+

2. `get_supported_dexes_by_network`

Prompt: "Show me the DEXes available on the Ethereum network for page 1."

Output:

+--------------+-----------------+
| ID           | Name            |
+==============+=================+
| uniswap_v3   | Uniswap V3      |
+--------------+-----------------+
| sushiswap    | SushiSwap       |
+--------------+-----------------+
| pancakeswap  | PancakeSwap     |
+--------------+-----------------+

3. `get_new_pools`

Prompt: "Get the latest pools across all networks for page 1."

Output:

+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Network  | Name              | Base Price (USD) | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+==========+===================+==================+===============+===================+=============================================+
| uniswap_v3   | eth      | WETH / USDC 0.05% | 3653.12          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| sushiswap    | bsc      | BNB / USDT        | 582.45           | 9876543.21    | 12345678.90       | 0x1234567890abcdef1234567890abcdef12345678 |
+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

4. `get_new_pools_by_network`

Prompt: "List the latest pools on the Ethereum network for page 1."

Output:

+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+===================+==================+===============+===================+=============================================+
| uniswap_v3   | WETH / USDC 0.05% | 3662.46          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| sushiswap    | WETH / DAI        | 3650.00          | 8765432.10    | 9876543.21        | 0xabcdef1234567890abcdef1234567890abcdef12 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

5. `get_trending_pools`

Prompt: "Show trending pools across all networks for the last 24 hours on page 1."

Output:

+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Network  | Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+==========+===================+==================+===============+===================+=============================================+
| uniswap_v3   | eth      | WETH / USDC 0.05% | 3662.46          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| pancakeswap  | bsc      | CAKE / BNB        | 2.34             | 5432109.87    | 8765432.10        | 0x7890abcdef1234567890abcdef1234567890abcd |
+--------------+----------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

6. `get_trending_pools_by_network`

Prompt: "Get trending pools on the Ethereum network for the last 24 hours on page 1."

Output:

+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+===================+==================+===============+===================+=============================================+
| uniswap_v3   | WETH / USDC 0.05% | 3662.46          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| sushiswap    | WETH / DAI        | 3650.00          | 8765432.10    | 9876543.21        | 0xabcdef1234567890abcdef1234567890abcdef12 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

7. `get_top_pools_by_network`

Prompt: "List the top pools on the Ethereum network sorted by transaction count for page 1."

Output:

+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+===================+==================+===============+===================+=============================================+
| uniswap_v3   | WETH / USDC 0.05% | 3662.46          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| sushiswap    | WETH / DAI        | 3650.00          | 8765432.10    | 9876543.21        | 0xabcdef1234567890abcdef1234567890abcdef12 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

8. `get_top_pools_by_dex`

Prompt: "Show the top pools on SushiSwap for the Ethereum network, sorted by transaction count for page 1."

Output:

+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+===================+==================+===============+===================+=============================================+
| WETH / DAI        | 3650.00          | 8765432.10    | 9876543.21        | 0xabcdef1234567890abcdef1234567890abcdef12 |
+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| SUSHI / WETH      | 1.23             | 4321098.76    | 5432109.87        | 0x1234567890abcdef1234567890abcdef12345678 |
+-------------------+------------------+---------------+-------------------+---------------------------------------------+

9. `search_pools`

Prompt: "Search for pools with 'WETH' on the Ethereum network for page 1."

Output:

+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| DEX          | Name              | Base Price       | Reserve (USD) | Volume 24h (USD)  | Address                                     |
+==============+===================+==================+===============+===================+=============================================+
| uniswap_v3   | WETH / USDC 0.05% | 3662.46          | 163988541.38  | 536545444.90      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+
| sushiswap    | WETH / DAI        | 3650.00          | 8765432.10    | 9876543.21        | 0xabcdef1234567890abcdef1234567890abcdef12 |
+--------------+-------------------+------------------+---------------+-------------------+---------------------------------------------+

License

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

Available Tools

10 tools

get_new_poolsA

Query all the latest pools across all networks on GeckoTerminal and return a formatted table.

Args:
    page: Page number for pagination (default: 1)
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex,network")

Returns:
    Formatted table as a string with columns: dex, network, name, base_price, reserve_usd, volume_usd_24h, address

Inputs: page, include. Returns: result

get_new_pools_by_networkA

Query all the latest pools for a specific network on GeckoTerminal and return a formatted table.

Args:
    network: The network identifier (default: "eth" for Ethereum)
    page: Page number for pagination (default: 1)
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex,network")

Returns:
    Formatted table as a string with columns: dex, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: network, page, include. Returns: result

get_pool_detailsA

Query details for a specific pool on a network.

Args:
    network: The network identifier (e.g., "eth")
    pool_address: The pool contract address
    include: Comma-separated attributes to include

Returns:
    JSON string of the pool data

Inputs: network (required), pool_address (required), include. Returns: result

get_supported_dexes_by_networkA

Query all supported DEXes for a specific network on GeckoTerminal and return a formatted table.

Args:
    network: The network identifier (default: "eth" for Ethereum)
    page: Page number for pagination (default: 1)

Returns:
    Formatted table as a string with columns: id, name

Inputs: network, page. Returns: result

get_supported_networksA

Query all supported networks on GeckoTerminal and return a formatted table.

Args:
    page: Page number for pagination (default: 1)

Returns:
    Formatted table as a string with columns: id, name

Inputs: page. Returns: result

get_top_pools_by_dexA

Query top pools for a specific network and DEX on GeckoTerminal and return a formatted table.

Args:
    network: The network identifier (default: "eth" for Ethereum)
    dex: The DEX identifier (default: "sushiswap")
    page: Page number for pagination (default: 1)
    sort: Sort pools by field (options: "h24_tx_count_desc", "h24_volume_usd_desc"; default: "h24_tx_count_desc")
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex"; default: "base_token,quote_token,dex")

Returns:
    Formatted table as a string with columns: dex, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: network, dex, page, sort, +1 more. Returns: result

get_top_pools_by_networkA

Query top pools for a specific network on GeckoTerminal and return a formatted table.

Args:
    network: The network identifier (default: "eth" for Ethereum)
    page: Page number for pagination (default: 1)
    sort: Sort pools by field (options: "h24_tx_count_desc", "h24_volume_usd_desc"; default: "h24_tx_count_desc")
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex"; default: "base_token,quote_token,dex")

Returns:
    Formatted table as a string with columns: dex, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: network, page, sort, include. Returns: result

get_trending_poolsA

Query all trending pools across all networks on GeckoTerminal and return a formatted table.

Args:
    page: Page number for pagination (default: 1)
    duration: Duration to sort trending list by (options: "5m", "1h", "6h", "24h"; default: "24h")
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex,network")

Returns:
    Formatted table as a string with columns: dex, network, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: page, duration, include. Returns: result

get_trending_pools_by_networkB

Query trending pools for a specific network on GeckoTerminal and return a formatted table.

Args:
    network: The network identifier (default: "eth" for Ethereum)
    page: Page number for pagination (default: 1)
    duration: Duration to sort trending list by (options: "5m", "1h", "6h", "24h"; default: "24h")
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex"; default: "base_token,quote_token,dex")

Returns:
    Formatted table as a string with columns: dex, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: network, page, duration, include. Returns: result

search_poolsA

Search for pools on a specific network on GeckoTerminal and return a formatted table.

Args:
    query: Search query (default: "weth")
    network: The network identifier (default: "eth" for Ethereum)
    page: Page number for pagination (default: 1)
    include: Comma-separated attributes to include (e.g., "base_token,quote_token,dex"; default: "base_token,quote_token,dex")

Returns:
    Formatted table as a string with columns: dex, name, base_price_in_quote, reserve_usd, volume_usd_24h, address

Inputs: query, network, page, include. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-05-26 08:15 across 10 tools

Disambiguation5/5

Every tool has a distinct and clear purpose: new pools, trending pools, top pools, pool details, supported entities, and search. There is no overlap or ambiguity between them.

Naming Consistency5/5

All tool names consistently use the 'get' verb followed by a descriptive noun phrase in snake_case, forming a predictable pattern (e.g., get_new_pools, get_trending_pools_by_network).

Tool Count5/5

With 10 tools, the server is well-scoped for its purpose—providing comprehensive read access to DEX pool data without being overwhelming or incomplete.

Completeness4/5

The tool set covers the core use cases: fetching new, trending, top, and searched pools, plus details and supported networks/DEXes. A minor gap is the lack of a 'get_top_pools' across all networks, but agents can still achieve this by iterating over networks.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcpA
com.everstake
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Blockchain Cryptocurrency
1111
https://mcp.everstake.com
anotherai
dev.anotherai
MCP server for building and testing AI agents with multi-model experimentation and insights.
Agent Orchestration Autonomous Agents Testing & QA Tools
2
https://api.anotherai.dev/mcp
Hive CapitalA
io.github.srotzin
HiveCapital MCP Server — autonomous investment layer for AI agents
Finance Autonomous Agents Blockchain
2
https://hive-mcp-gateway.onrender.com/capital/mcp
Fensory
com.fensory
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Finance Cryptocurrency Blockchain
1
https://mcp.fensory.com/mcp

Related MCP Servers

uniswap-trader-mcp
Blockchain Web3 & Decentralized Tech
kukapay
A
license
Not graded
quality
D
maintenance
An MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.
Updated 2 years ago (2025-05-07 17:23 UTC)
9 npm
40
MIT
Armor Crypto MCPofficial
Blockchain Cryptocurrency Web3 & Decentralized Tech
armorwallet
A
license
C
quality
D
maintenance
An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
Updated a year ago (2025-07-29 15:53 UTC)
37
178
GPL 3.0
liquidity-pools-mcp
Blockchain Web3 & Decentralized Tech
kukapay
A
license
A
quality
D
maintenance
An MCP server that tracks and analyzes DEX liquidity pools to power intelligent DeFi agents and automated strategies.
Updated a year ago (2025-06-09 08:26 UTC)
1
2
MIT
dex-kline-mcp
Blockchain Web3 & Decentralized Tech Vector Databases
kukapay
A
license
A
quality
D
maintenance
An MCP server that streams K-line (candlestick) data from decentralized exchanges (DEXs) to power your AI agents and workflows.
Updated a year ago (2025-07-02 16:57 UTC)
1
4
MIT

DEX Pools MCP

Features

Prerequisites

Installation

Usage

Available Tools

Examples

1. get_supported_networks

2. get_supported_dexes_by_network

3. get_new_pools

4. get_new_pools_by_network

5. get_trending_pools

6. get_trending_pools_by_network

7. get_top_pools_by_network

8. get_top_pools_by_dex

9. search_pools

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

uniswap-trader-mcp

Armor Crypto MCPofficial

liquidity-pools-mcp

dex-kline-mcp

1. `get_supported_networks`

2. `get_supported_dexes_by_network`

3. `get_new_pools`

4. `get_new_pools_by_network`

5. `get_trending_pools`

6. `get_trending_pools_by_network`

7. `get_top_pools_by_network`

8. `get_top_pools_by_dex`

9. `search_pools`