Uniswap PoolSpy MCP Server

Finance & FintechPython

Track newly created Uniswap liquidity pools across multiple blockchain networks

Available Tools

get_new_pools

Retrieves newly created Uniswap liquidity pools based on specified parameters

chainorder_bytime_range_secondslimit

Uniswap PoolSpy is a specialized tool that monitors and tracks newly created liquidity pools on Uniswap across nine major blockchain networks. It provides real-time data on pool creation, transaction counts, volume, and total value locked (TVL), making it an invaluable resource for DeFi analysts, traders, and developers. With support for Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain, Avalanche, Celo, and Blast networks, this tool offers comprehensive coverage of the Uniswap ecosystem. Users can customize queries by time range, result limits, and sorting preferences to get precisely the data they need for their DeFi research and trading strategies.

Overview

Uniswap PoolSpy is a powerful tool for monitoring newly created liquidity pools on Uniswap across nine blockchain networks. It provides real-time data that can help DeFi analysts, traders, and developers stay informed about new trading opportunities and market trends.

Prerequisites

Before installing Uniswap PoolSpy, ensure you have:

Python 3.10 or higher installed
uv package manager
A valid The Graph API key
An MCP-compatible environment (such as Claude Desktop)

Installation

Step 1: Clone the Repository

git clone https://github.com/kukapay/uniswap-poolspy-mcp.git
cd uniswap-poolspy-mcp

Step 2: Install Dependencies

If you don't have uv installed, you can install it with:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then install the project dependencies:

uv sync

Step 3: Configure API Key

Create a .env file in the project root directory and add your The Graph API key:

THEGRAPH_API_KEY=your-api-key-here

Replace your-api-key-here with your actual API key from The Graph.

Running the Server

To start the MCP server directly:

uv run main.py

For development with MCP Inspector:

uv run mcp dev main.py

Integration with Claude Desktop or Other MCP Clients

To install the server as an MCP plugin:

uv run mcp install main.py --name "UniswapPoolSpy"

Alternatively, configure it in your MCP client's configuration file by adding the appropriate entry to the mcpServers section.

Usage

Once installed, you can query new pools using natural language in your MCP client. Examples include:

"Show me new pools on Ethereum from the last 10 minutes"
"List pools on Base sorted by volume, limit to 50"
"What pools were created on Polygon in the past hour, ordered by TVL?"

The tool will return detailed information about each pool, including:

Pool address
Token pair
Creation timestamp
Block number
Transaction count
Volume (USD)
Total Value Locked (USD)

Supported Networks

Uniswap PoolSpy currently supports the following blockchain networks:

Ethereum
Base
Optimism
Arbitrum
Polygon
BNB Smart Chain (BSC)
Avalanche
Celo
Blast

Troubleshooting

If you encounter issues with the API connection, verify that:

Your The Graph API key is valid and correctly set in the .env file
You have a stable internet connection
The Graph's services are operational

For other technical issues, check the repository's issues page or submit a new issue on GitHub.