Uniswap PoolSpy MCP Server

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.

Which chains are supported?

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