Uniswap PoolSpy Data Aggregation Service

This specialized Micro-Controller Protocol (MCP) server diligently observes the genesis of new Uniswap V3 liquidity provisioning events across nine major EVM-compatible chains: Ethereum mainnet, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast. It furnishes up-to-the-second data streams essential for DeFi strategists, active market participants, and protocol architects.

Core Capabilities

• Scans and reports on Uniswap V3 pool creation across 9 distinct blockchain environments.
• Permits granular tuning of the temporal window and result quantity when requesting nascent pools.
• Supports result arrangement via creation timestamp, accrued transaction count, transactional volume, or Total Value Locked (TVL).

System Requirements

• Python interpreter version 3.10 or superior.
• The uv package manager utility for dependency resolution.
• An authenticated access key for The Graph indexing protocol.
• An operational MCP-compliant execution shell (e.g., Claude Desktop) for full operational access.

Deployment Instructions

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

2. Environment Bootstrap: Install uv if not already present: bash curl -LsSf https://astral.sh/uv/install.sh | sh

3. Dependency Installation: Use uv to synchronize required packages listed in pyproject.toml: bash uv sync

4. Credential Setup: Establish a .env configuration file in the project's root directory: bash echo "THEGRAPH_API_KEY=your-secret-the-graph-key" > .env

Substitute your-secret-the-graph-key with your genuine API credential from The Graph.

Operational Execution

Initiating the Monitoring Service

Activate the MCP backend service: bash uv run main.py

For debugging or interactive inspection via the MCP Inspector utility: bash uv run mcp dev main.py

Integration with Claude Desktop

Load the service as an MCP extension: bash uv run mcp install main.py --name "UniswapPoolSpy"

Configuration for Client Discovery

To enable seamless service recognition by consuming MCP agents (like Claude Desktop), update your configuration manifest (mcpServers file):

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

Invoking the Pool Discovery Tool

Utilize the get_new_pools function within the Claude Desktop interface, specifying criteria through natural language requests, such as: - "Display recently launched pools on the Ethereum network within the preceding ten minutes." - "Generate a roster of pools on Base, ranked by transactional throughput, capping the result set at 50 entries." - "Identify pools deployed on Polygon over the past sixty minutes, sequenced descending by Total Value Locked."

The interface accepts the following input parameters: - chain: Designation of the operational blockchain (e.g., "ethereum", "base", "optimism"). - order_by: The field to use for sorting results ("timestamp", "txcount", "volume", or "tvl"). - time_range_seconds: The lookback duration specified in seconds (default value is 300). - limit: The maximum cardinality of the output list (default value is 100).

Sample Retrieval Format

Newly Established Trading Pools (Last 5 Minutes Window, Maximum Count: 100): Pool Identifier: 0x1234...abcd Asset Pair: WETH/USDC Genesis Time: 2025-03-18 12:34:56 Block Sequence: 12345678 Interaction Count: 5 Monetary Flow (USD): 15000.25 Secured Capital Base (USD): 50000.75

Pool Identifier: 0x5678...efgh Asset Pair: DAI/USDT Genesis Time: 2025-03-18 12:33:45 Block Sequence: 12345670 Interaction Count: 3 Monetary Flow (USD): 8000.50 Secured Capital Base (USD): 25000.00

Compatible Networks

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

Software Mandate

This utility is distributed under the terms of the MIT License agreement; consult the LICENSE file for comprehensive disclosures.