Uniswap PoolSpy

An MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks.

python

7

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run an MCP server that monitors newly created Uniswap V3 pools across nine networks and delivers real-time data for analysis, trading, and development. This guide shows you how to use the server with an MCP client, install it, and configure it for discovery and operation.

How to use

Use an MCP client to query new pools with natural language commands. For example, you can ask for the latest pools on a specific chain, sorted by a field such as timestamp, transaction count, volume, or TVL, and limit the number of results returned.

How to install

Follow these concrete steps to set up the Uniswap PoolSpy MCP Server on your machine.

# Prerequisites
Python 3.10 or higher
uv for package management
A valid The Graph API key
MCP-compatible environment for full functionality

# 1. Install the MCP server (no directory changes required if you clone elsewhere)
uv run mcp install main.py --name "UniswapPoolSpy"

# 2. Run the MCP server locally for development
uv run main.py

# 3. Start for MCP Inspector development (optional)
uv run mcp dev main.py

Additional notes

Configuration and runtime details are provided in explicit code blocks shown below. Use the local MCP runtime with the appropriate environment variable for The Graph API key.

{
  "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"
      }
    }
  }
}

Available tools

get_new_pools

Fetches newly created Uniswap V3 pools across specified chains, with options to filter by time range and sort by timestamp, txcount, volume, or tvl.