Spark
Sign In
MCP Connector

Monitor New Uniswap Pools Across 9 Blockchains

Tracks newly created Uniswap V3 liquidity pools across nine blockchains in real time, sortable by volume, TVL, or activity.

Connect
Works with uniswapthegraph
kukapay
Maintainer?
91
Spark score
out of 100
Updated Mar 2025
Fresher alternatives ↓
Version 1.0.0
Models
universal
Add to Favorites

Why it matters

Gain real-time insights into newly created Uniswap liquidity pools across multiple blockchain networks. Ideal for DeFi analysts, traders, and developers seeking to identify emerging opportunities.

Outcomes

What it gets done

01

Track Uniswap V3 pool creation across Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain, Avalanche, Celo, and Blast.

02

Query new pools with customizable parameters for time range and result limits.

03

Sort and filter pools by timestamp, transaction count, volume, or TVL.

04

Access real-time data for informed decision-making in DeFi.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-uniswap-poolspy-mcp | bash

Capabilities

Tools your agent gets

get_new_pools

Query newly created Uniswap V3 liquidity pools across blockchain networks with customizable parameters.

Overview

uniswap-poolspy-mcp MCP Server

Tracks newly created Uniswap V3 liquidity pools across nine EVM chains via a single get_new_pools tool, returning pool address, token pair, transaction count, volume, and TVL, sourced from The Graph. Use for real-time monitoring of new Uniswap V3 pool creation across Ethereum, Base, Optimism, Arbitrum, Polygon, BSC, Avalanche, Celo, or Blast; scoped to Uniswap V3 only, not other DEX protocols.

What it does

Uniswap PoolSpy MCP Server tracks newly created Uniswap V3 liquidity pools across nine blockchain networks - Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast - giving DeFi analysts, traders, and developers real-time visibility into new pool creation. It exposes a single tool, get_new_pools, invoked with natural-language queries like "show me new pools on Ethereum from the last 10 minutes" or "list pools on Base sorted by volume, limit to 50." The tool accepts a chain parameter (the target network), order_by (sorting by timestamp, transaction count, volume, or TVL), time_range_seconds (a lookback window, defaulting to 300 seconds), and limit (maximum results returned, defaulting to 100).

For each new pool, the tool returns the pool address, the token pair, the creation timestamp, the block number, transaction count, trading volume in USD, and total value locked in USD - giving a quick read on how active and liquid a freshly created pool already is. Data is sourced from The Graph, requiring a valid API key from The Graph's developer studio.

When to use - and when NOT to

Use this when tracking new liquidity pool creation across major EVM chains for trading opportunities, DeFi market research, or monitoring specific chains for emerging trading pairs - for example checking what pools were created on Polygon in the past hour ordered by TVL. It is scoped specifically to Uniswap V3 pool creation events across the nine listed networks, so it does not cover other DEX protocols or chains outside that list.

Capabilities

The server runs on Python 3.10 or higher, uses uv for package and dependency management, and can be launched under the MCP Inspector for development (uv run mcp dev main.py). Time range and result limits are fully customizable per query, and results can be sorted by whichever metric matters most for a given analysis - freshness (timestamp), activity (transaction count), or liquidity depth (volume or TVL).

How to install

Setup clones the repository, installs uv, and syncs dependencies from pyproject.toml:

uv sync

A .env file supplies the required THEGRAPH_API_KEY. The server runs directly with uv run main.py, or can be installed as a named MCP plugin for Claude Desktop with uv run mcp install main.py --name "UniswapPoolSpy". For manual MCP client configuration, the server is registered with command: uv, pointing --directory at the project path and running main.py, with THEGRAPH_API_KEY passed through the env block.

Who it's for

DeFi traders, analysts, and developers who want conversational, real-time monitoring of newly created Uniswap V3 pools across major EVM chains, sortable by recency, activity, or liquidity.

Source README

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.

Python
License
Status

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

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.