Uniswap PoolSpy

by kukapay

1 stars
250 downloads
Not rated
GitHub

About

Tracks newly created Uniswap V3 liquidity pools across nine blockchain networks, providing detailed metrics like transaction count, volume, and TVL for cryptocurrency traders and researchers.

Details

Author
kukapay
Repository
kukapay/uniswap-poolspy-mcp
GitHub stars
1
Downloads
250
License
MIT License
Categories
Developer Tools, Other, Finance, AI, Design, Search, Infrastructure, Knowledge Base
Tags
#visualization, #analytics

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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Uniswap PoolSpy
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 --directory
    • Argument 2 path/to/uniswap-poolspy-mcp
    • Argument 3 run
    • Argument 4 main.py
    Environment
    • THEGRAPH_API_KEY your api key from The Graph

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

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

Start the MCP server:

uv run main.py

For development with MCP Inspector:

uv run mcp dev main.py

get_new_pools

Query for newly created liquidity pools on a specific blockchain. Parameters: chain (string), order_by (string), time_range_seconds (optional integer), limit (optional integer)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "uniswap poolspy": {
            "env": {
                "THEGRAPH_API_KEY": "your api key from The Graph"
            },
            "args": [
                "--directory",
                "path/to/uniswap-poolspy-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "THEGRAPH_API_KEY": "your api key from The Graph"
    },
    "args": [
        "--directory",
        "path/to/uniswap-poolspy-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "THEGRAPH_API_KEY": "your api key from The Graph"
    },
    "args": [
        "--directory",
        "path/to/uniswap-poolspy-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "THEGRAPH_API_KEY": "your api key from The Graph"
    },
    "args": [
        "--directory",
        "path/to/uniswap-poolspy-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

Tracks newly created Uniswap liquidity pools across nine blockchain networks, providing real-time data for DeFi analysts, traders, and developers.

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.

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

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

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

Set Up Environment: Installuvif you haven't already:

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

Install Dependencies: Useuvto sync dependencies frompyproject.toml:

Configure API Key: Create a.envfile in the project root:

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

Replaceyour-api-key-herewith your actual The Graph API key.

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

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

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

Use theget_new_poolstool 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?"

- 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)

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

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

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

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.

A server for interacting with the Futarchy protocol on the Solana blockchain.

About MCP server for TRON blockchain — connect AI agents to TRX, TRC20, smart contracts, staking & governance via GoTRON SDK

Provides onchain tools for AI applications to interact with the Hashkey Network.

Integrates with the Hyperlane protocol for cross-chain messaging and smart contract interactions.

Deploy and manage compliant tokens from Claude, Cursor, or any AI agent — by typing a sentence.

Solana agent trust scoring via x402 micropayments.

An MCP server for interacting with Web3 and EVM-compatible chains.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.

Non-custodial stablecoin yield. Stablecoin Yield Index (SYX) + 12 USDC vault APYs across Ethereum, Base, Arbitrum.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.