Uniswap PoolSpy MCP Server

What does “Uniswap PoolSpy” MCP Server do?

The Uniswap PoolSpy MCP Server is a specialized Model Context Protocol (MCP) server designed to track newly created liquidity pools on Uniswap across nine major blockchain networks: Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast. By providing real-time data on new pool creation, Uniswap PoolSpy empowers DeFi analysts, traders, and developers to monitor ecosystem changes as they happen. The server supports customizable queries based on time range, sorting by various metrics (timestamp, transaction count, volume, TVL), and allows for integration with AI assistants and developer tools via the MCP protocol. This enhances development workflows by making it easier to surface and act on up-to-date decentralized finance (DeFi) data.

List of Prompts

No information about prompt templates is available in the repository.

List of Resources

No explicit MCP “resources” are described in the repository.

List of Tools

• Pool Monitoring Tool
  Exposes functionality to query and monitor newly created Uniswap V3 pools across multiple blockchains. Allows customization by time range, sorting, and result limits.

Use Cases of this MCP Server

• DeFi Market Monitoring
  Enables analysts and traders to track new liquidity pools in real time, helping them spot emerging trends, new tokens, or large capital inflows across supported blockchains.

• Liquidity Pool Discovery
  Developers can automate the discovery of new Uniswap pools to build analytics dashboards or liquidity aggregation tools.

• Risk Assessment
  Risk management teams can use the server to monitor suspicious pool creation activity and quickly respond to potential threats or rug pulls.

• Data Science and Research
  Researchers can gather comprehensive datasets on liquidity pool creation for historical analysis, market research, or modeling ecosystem growth.

How to set it up

Windsurf

1. Ensure prerequisites:
   • Python 3.10+
   • uv package manager
   • The Graph API key
2. Clone and install:

   git clone https://github.com/kukapay/uniswap-poolspy-mcp.git
   cd uniswap-poolspy-mcp
   curl -LsSf https://astral.sh/uv/install.sh | sh
   uv sync
   

3. Configure API key:

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

4. Edit Windsurf configuration: Add the MCP server:

   {
     "mcpServers": {
       "uniswap-poolspy": {
         "command": "uv",
         "args": ["run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "<YOUR_API_KEY>"
         }
       }
     }
   }
   

5. Restart Windsurf and verify.

Claude

1. Install prerequisites: Python 3.10+, uv, API key.
2. Clone and install as above.
3. Add to Claude config:

   {
     "mcpServers": {
       "uniswap-poolspy": {
         "command": "uv",
         "args": ["run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "<YOUR_API_KEY>"
         }
       }
     }
   }
   

4. Restart Claude and confirm connection.

Cursor

1. Set up environment as above.
2. Edit Cursor’s MCP config:

   {
     "mcpServers": {
       "uniswap-poolspy": {
         "command": "uv",
         "args": ["run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "<YOUR_API_KEY>"
         }
       }
     }
   }
   

3. Restart Cursor.

Cline

1. Follow environment setup as above.
2. Configure Cline:

   {
     "mcpServers": {
       "uniswap-poolspy": {
         "command": "uv",
         "args": ["run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "<YOUR_API_KEY>"
         }
       }
     }
   }
   

3. Restart Cline.

Note about securing API keys:
Always use environment variables for API keys in your MCP server configuration, as shown in the env block of your JSON config.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "uniswap-poolspy": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “uniswap-poolspy” to whatever the actual name of your MCP server is, and replace the URL with your own MCP server URL.

Overview

Based on the two tables, the Uniswap PoolSpy MCP server provides clear setup instructions and a valuable real-world tool, but lacks documentation on prompts, resources, and advanced MCP features like sampling or roots. As such, this MCP scores moderately on completeness and developer enablement.

MCP Score