Uniswap PoolSpy

What is Uniswap PoolSpy about?

Uniswap PoolSpy monitors the creation of liquidity pools on Uniswap V3 for Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain, Avalanche, Celo, and Blast. It aggregates pool metadata such as address, token pair, creation timestamp, transaction count, volume, and TVL, exposing this information through an MCP server that can be queried with natural‑language tools like Claude Desktop.

How to use Uniswap PoolSpy?

1. Clone the repo and install dependencies with uv.
2. Set the Graph API key in a .env file (THEGRAPH_API_KEY).
3. Start the server: uv run main.py (or uv run mcp dev main.py for development).
4. Register the server in an mcpServers JSON file so MCP clients can discover it.
5. Query pools via the get_new_pools tool, providing parameters such as chain, order_by, time_range_seconds, and limit.

Key features of Uniswap PoolSpy

• Real‑time detection of new Uniswap V3 pools on nine chains.
• Customizable time range and result limits.
• Sorting options: timestamp, transaction count, volume, TVL.
• Simple MCP integration for Claude Desktop and other MCP‑compatible environments.
• Python 3.10+ implementation with uv‑based dependency management.

Use cases of Uniswap PoolSpy

• DeFi analysts: quickly identify emerging liquidity opportunities.
• Traders: monitor fresh pool creation for arbitrage or early‑entry strategies.
• Developers: feed live pool data into dashboards, bots, or research pipelines.
• Portfolio managers: assess new market segments across multiple chains.

FAQ from the Uniswap PoolSpy

Q: Which blockchain networks are supported? A: Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain, Avalanche, Celo, and Blast.

Q: Do I need a The Graph API key? A: Yes, the server queries The Graph endpoints, so a valid API key must be set in the .env file.

Q: Can I limit the number of returned pools? A: Yes, use the limit parameter (default 100, max configurable).

Q: How do I sort results? A: Specify order_by as timestamp, txcount, volume, or tvl.

Q: Is the server compatible with other MCP clients besides Claude Desktop? A: Any MCP‑compatible client can interact with the server as long as it’s listed in the mcpServers configuration.

Uniswap PoolSpy MCP Server

An MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks — Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast — providing real-time data for DeFi analysts, traders, and developers.

Features

• Monitors Uniswap V3 pool creation across 9 blockchain networks.
• Customizable time range and result limits for querying new pools.
• Supports sorting by timestamp, transaction count, volume, or TVL.

Prerequisites

• Python 3.10 or higher
• uv for package management
• A valid The Graph API key
• MCP-compatible environment (e.g., Claude Desktop) for full functionality

Installation

1. Clone the Repository:

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

2. Set Up Environment: Install uv if you haven't already:

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

3. Install Dependencies: Use uv to sync dependencies from pyproject.toml:

   uv sync
   

4. Configure API Key: Create a .env file in the project root:

   echo "THEGRAPH_API_KEY=your-api-key-here" > .env
   

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

Usage

Running the Server

Start the MCP server:

uv run main.py

For development with MCP Inspector:

uv run mcp dev main.py

Integrating with Claude Desktop

Install the server as an MCP plugin:

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

Configuration

To make the server discoverable by MCP clients (e.g., Claude Desktop), configure it in an mcpServers file:

{
  "mcpServers": {
    "Uniswap-PoolSpy": {
      "command": "uv",
      "args": ["--directory", "path/to/uniswap-poolspy-mcp", "run", "main.py"],
      "env": {
        "THEGRAPH_API_KEY": "your api key from The Graph"
      }
    }
  }
}

Querying New Pools

Use the get_new_pools tool in Claude Desktop with natural language queries like:

• "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 accepts these parameters:

• chain: Blockchain network (e.g., "ethereum", "base", "optimism")
• order_by: Sort field ("timestamp", "txcount", "volume", "tvl")
• time_range_seconds: Lookback period in seconds (default: 300)
• limit: Maximum number of pools to return (default: 100)

Example Output

Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75

Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00

Supported Chains

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

License

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