Uniswap Poolspy MCP

🚀 Uniswap Pool Tracking MCP Server

An MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks (Ethereum, Base, Optimism, Arbitrum, Polygon, Binance Smart Chain (BSC), Avalanche, Celo, and Blast) in real-time, providing real-time data for DeFi analysts, traders, and developers.

🚀 Quick Start

The Uniswap Pool Tracking MCP Server is designed to offer real - time data on newly created Uniswap liquidity pools across multiple blockchain networks. It's a valuable tool for anyone involved in the DeFi space.

✨ Features

• Monitor the creation of Uniswap V3 pools across nine blockchain networks.
• Support custom time ranges and result limits for querying new pools.
• Sort results by timestamp, number of transactions, trading volume, or TVL.

📦 Installation

Prerequisites

• Python 3.10 or higher
• uv for package management
• A valid The Graph API key
• Support for the MCP environment (e.g., Claude Desktop) for full functionality

Steps

1. Clone the repository:

   git clone https://github.com/yourusername/uniswap-poolspy-mcp.git
   cd uniswap-poolspy-mcp
   

2. Set up the environment: If uv is not installed, run the following command to install it:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Install dependencies: Use uv to synchronize the dependencies in pyproject.toml:

   uv sync
   

4. Configure the API key: Create a .env file in the project root directory:

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

   Replace your-api-key-here with your actual The Graph API key.

💻 Usage Examples

Basic Usage

• Run the server:

  uv run main:app
  

Advanced Usage

• Integrate with Claude Desktop: Configure the MCP environment according to the Claude Desktop documentation to use this server.

• Query new pools: Use the following command to get detailed information about new pools:

  curl http://localhost:8000/pools/new
  

📚 Documentation

Configuration Example

{
  "pool_monitors": {
    "ethereum": true,
    "base": true,
    "optimism": true,
    "arbitrum": true,
    "polygon": true,
    "bsc": true,
    "avalanche": true,
    "celo": true,
    "blast": true
  },
  "api_key": "your-api-key-here"
}

Supported Chains

• Ethereum (ethereum)
• Base (base)
• Optimism (optimism)
• Arbitrum (arbitrum)
• Polygon (polygon)
• Binance Smart Chain (bsc)
• Avalanche (avalanche)
• Celo (celo)
• Blast (blast)

📄 License

This project is licensed under the MIT license. See the LICENSE file for details.