Uniswap Poolspy Mcp

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.

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

1. Set Up Environment:

Install uv if you haven't already: ``bash curl -LsSf https://astral.sh/uv/install.sh | sh ``

1. Install Dependencies:

Use uv to sync dependencies from pyproject.toml: ``bash uv sync ``

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

uv run main.py

For development with MCP Inspector:

uv run mcp dev main.py

Integrating with Claude Desktop

Install the server as an MCP plugin:

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:

{
  "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](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kukapay](https://github.com/kukapay)
- **Source:** [kukapay/uniswap-poolspy-mcp](https://github.com/kukapay/uniswap-poolspy-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.