Uniswap PoolSpy MCP Server

Uniswap PoolSpy MCP Server

Tracks newly created Uniswap V3 liquidity pools across nine blockchain networks in real time.

View on GitHub
6
Stars
6
Forks
6
Watchers
4
Issues
Uniswap PoolSpy MCP Server is an MCP-compliant server designed to monitor and provide real-time data on newly created liquidity pools on Uniswap V3 across nine popular blockchain networks, including Ethereum, Base, and Arbitrum. The server allows users to customize their queries by time range, sorting fields, and result limits, making it suitable for DeFi analysis, trading, and development. It integrates directly with MCP environments such as Claude Desktop, supporting seamless plugin installation and natural language queries. The tool leverages The Graph API for fetching on-chain data and offers easy configuration for discovery by client applications.

Key Features

Monitors new Uniswap V3 pool creation across 9 blockchain networks
Customizable time range and result limits for pool queries
Supports multiple sorting options: timestamp, transaction count, volume, TVL
Real-time data tracking for DeFi analytics
Integration with MCP environments and Claude Desktop
Provides natural language querying for pool discovery
Easy environment setup and API key configuration
Output includes key pool metrics: volume, TVL, transaction count
Installation as an MCP plugin
Discoverability via mcpServers configuration

Use Cases

Real-time monitoring of new Uniswap V3 pools by DeFi analysts
Automated trading strategies based on new liquidity pools
Historical research on pool creation trends across chains
Integration into DeFi dashboards for liquidity updates
Alert systems for high-value pool creations
Token listing or due diligence workflows for developers
Supporting on-chain data feeds in data science pipelines
Discovering new trading opportunities quickly
Enriching DeFi intelligence platforms with fresh liquidity metrics
Providing context-aware insights for AI models in DeFi analysis

README

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.

Python License Status

Features

  • Monitors Uniswap V3 pool creation across 9 blockchain networks.
  • Customizable time range and result limits for querying new pools.
  • Supports sorting by timestamp, transaction count, volume, or TVL.

Prerequisites

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

Installation

  1. Clone the Repository:

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

  2. Set Up Environment: Install uv if you haven't already:

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

  3. Install Dependencies: Use uv to sync dependencies from pyproject.toml:

    bash
    uv sync

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

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

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

Usage

Running the Server

Start the MCP server:

bash
uv run main.py

For development with MCP Inspector:

bash
uv run mcp dev main.py

Integrating with Claude Desktop

Install the server as an MCP plugin:

bash
uv run mcp install main.py --name "UniswapPoolSpy"

Configuration

To make the server discoverable by MCP clients (e.g., Claude Desktop), configure it in an mcpServers file:

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

Querying New Pools

Use the get_new_pools tool in Claude Desktop with natural language queries like:

  • "Show me new pools on Ethereum from the last 10 minutes"
  • "List pools on Base sorted by volume, limit to 50"
  • "What pools were created on Polygon in the past hour, ordered by TVL?"

The tool accepts these parameters:

  • chain: Blockchain network (e.g., "ethereum", "base", "optimism")
  • order_by: Sort field ("timestamp", "txcount", "volume", "tvl")
  • time_range_seconds: Lookback period in seconds (default: 300)
  • limit: Maximum number of pools to return (default: 100)

Example Output

Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75

Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00

Supported Chains

  • Ethereum
  • Base
  • Optimism
  • Arbitrum
  • Polygon
  • BNB Smart Chain (BSC)
  • Avalanche
  • Celo
  • Blast

License

This project is licensed under the MIT License - see the LICENSE file for details.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 12 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

real-time-data

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Uniswap V3 Price MCP Server

    Uniswap V3 Price MCP Server

    Real-time Uniswap V3 token price server for AI agents and DeFi automation.

    Uniswap V3 Price MCP Server delivers real-time token prices from Uniswap V3 across major EVM-compatible networks, including Ethereum, Polygon, Arbitrum, and Optimism. Optimized for AI agents and DeFi automation, it queries token prices in USD or other stablecoins, with optional conversion via CryptoCompare. The server is designed for compatibility with MCP clients, enabling seamless and standardized integrations. Environment setup is straightforward, leveraging Infura endpoints and Node.js.

    • ⭐ 2
    • MCP
    • kukapay/uniswap-price-mcp
  • Uniswap Trader MCP

    Uniswap Trader MCP

    Automate token swaps on Uniswap across multiple blockchains for AI agents.

    Uniswap Trader MCP provides an MCP server interface enabling AI agents to automate token swaps on Uniswap V3 across several EVM-compatible blockchains. It offers real-time price quoting, optimized trade route suggestions, and direct execution of swaps with configurable slippage and deadlines. Multi-chain support allows seamless integration with networks such as Ethereum, Polygon, Arbitrum, and others for robust DeFi trading automation.

    • ⭐ 34
    • MCP
    • kukapay/uniswap-trader-mcp
  • Bitcoin MCP Server

    Bitcoin MCP Server

    Real-time Bitcoin blockchain data server for MCP clients.

    Provides tools to deliver real-time Bitcoin blockchain data for use with Model Context Protocol (MCP) clients. Offers specialized endpoints for querying blockchain addresses, transactions, UTXOs, and block information by interfacing with the mempool.space API. Supports easy installation and integration with popular MCP clients, enabling seamless access to blockchain analytics.

    • ⭐ 0
    • MCP
    • JamesANZ/bitcoin-mcp
  • Wallet Inspector MCP

    Wallet Inspector MCP

    Empowering AI agents to inspect wallet balances and onchain activity across multiple blockchains.

    Wallet Inspector MCP is an MCP server that enables AI agents to query wallet balances and view onchain activity on major EVM chains as well as the Solana blockchain. It supports flexible output formats, multi-chain querying, and is designed for integration with MCP-compatible clients such as Claude Desktop CLI. The tool facilitates secure, natural language interactions to check balances, activities, and transaction histories for any supported wallet address.

    • ⭐ 7
    • MCP
    • kukapay/wallet-inspector-mcp
  • Whale Tracker MCP Server

    Whale Tracker MCP Server

    Monitor and analyze large cryptocurrency transactions using MCP and Whale Alert API integration.

    Whale Tracker MCP Server implements the Model Context Protocol to provide real-time monitoring and analysis of large-scale cryptocurrency transactions. Built in Python, it integrates seamlessly with the Whale Alert API and exposes tools, resources, and prompt templates to MCP-compatible clients such as Claude Desktop. This solution enables users to fetch recent whale transactions, retrieve detailed information, and leverage contextual data directly within their LLM-powered workflows.

    • ⭐ 44
    • MCP
    • kukapay/whale-tracker-mcp
  • Web3 Jobs MCP Server

    Web3 Jobs MCP Server

    AI-ready MCP server delivering curated, real-time Web3 job listings.

    Web3 Jobs MCP Server provides real-time access to curated Web3 job listings from web3.career through a Model Context Protocol (MCP) interface, enabling intelligent job discovery for AI agents. The server supports advanced filtering by location, remote status, job tag, and result limits, and returns results in Markdown format. It enables the generation of natural language prompts for job searches, facilitating seamless integration with AI platforms such as Claude Desktop. Designed for Python 3.10+, it offers flexible deployment and configuration options.

    • ⭐ 4
    • MCP
    • kukapay/web3-jobs-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results