Uniswap PoolSpy MCP Server

Name: Uniswap PoolSpy MCP Server
Author: kukapay

@kukapay

Repository

About Uniswap PoolSpy MCP Server

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

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "uniswap-poolspy-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 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.

How to use Uniswap PoolSpy MCP Server?

Clone the repository, set up uv and run uv sync. Configure a The Graph API key in .env, then start the server with uv run main.py. Integrate with Claude Desktop using uv run mcp install main.py --name "UniswapPoolSpy" and use natural language queries via the get_new_pools tool, specifying parameters like chain, order_by, time_range_seconds, and limit.

Key features of Uniswap PoolSpy MCP Server

Monitors Uniswap V3 pool creation across 9 blockchains
Customizable lookback period and result limits
Sort results by timestamp, transaction count, volume, or TVL
Natural language query support via Claude Desktop
Outputs pool addresses, tokens, creation time, and metrics

Use cases of Uniswap PoolSpy MCP Server

Identify newly created trading pools for early arbitrage or liquidity opportunities
Track pool creation activity across multiple chains in real time
Analyze pool metrics (volume, TVL, transaction count) for market insights
Integrate real-time pool discovery into automated DeFi strategies

FAQ from Uniswap PoolSpy MCP Server

What are the prerequisites?

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

How do I configure the API key?

Create a .env file in the project root with THEGRAPH_API_KEY=your-api-key-here, replacing with your actual key from The Graph. Alternatively, set the key in the MCP client configuration's env field.

What parameters does the `get_new_pools` tool accept?

chain (required, e.g. "ethereum"), order_by (optional, defaults to "timestamp"), time_range_seconds (lookback period, default 300), and limit (max pools, default 100). Sorting options: timestamp, txcount, volume, tvl.

How do I integrate with Claude Desktop?

Run uv run mcp install main.py --name "UniswapPoolSpy" to install as an MCP plugin, or configure the server in the mcpServers file with the command uv and arguments pointing to the project directory.