MCP.so
Sign In

Uniswap PoolSpy MCP Server

@kukapay

Repository

About Uniswap PoolSpy MCP Server

An MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "uniswap-poolspy-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

How to use Uniswap PoolSpy MCP Server?

Clone the repository, set up uv and run uv sync. Configure a The Graph API key in .env, then start the server with uv run main.py. Integrate with Claude Desktop using uv run mcp install main.py --name "UniswapPoolSpy" and use natural language queries via the get_new_pools tool, specifying parameters like chain, order_by, time_range_seconds, and limit.

Key features of Uniswap PoolSpy MCP Server

  • Monitors Uniswap V3 pool creation across 9 blockchains
  • Customizable lookback period and result limits
  • Sort results by timestamp, transaction count, volume, or TVL
  • Natural language query support via Claude Desktop
  • Outputs pool addresses, tokens, creation time, and metrics

Use cases of Uniswap PoolSpy MCP Server

  • Identify newly created trading pools for early arbitrage or liquidity opportunities
  • Track pool creation activity across multiple chains in real time
  • Analyze pool metrics (volume, TVL, transaction count) for market insights
  • Integrate real-time pool discovery into automated DeFi strategies

FAQ from Uniswap PoolSpy MCP Server

What are the prerequisites?

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

How do I configure the API key?

Create a .env file in the project root with THEGRAPH_API_KEY=your-api-key-here, replacing with your actual key from The Graph. Alternatively, set the key in the MCP client configuration's env field.

What parameters does the get_new_pools tool accept?

chain (required, e.g. "ethereum"), order_by (optional, defaults to "timestamp"), time_range_seconds (lookback period, default 300), and limit (max pools, default 100). Sorting options: timestamp, txcount, volume, tvl.

How do I integrate with Claude Desktop?

Run uv run mcp install main.py --name "UniswapPoolSpy" to install as an MCP plugin, or configure the server in the mcpServers file with the command uv and arguments pointing to the project directory.

Which chains are supported?

Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast.

Frequently asked questions

What are the prerequisites?

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

How do I configure the API key?

Create a `.env` file in the project root with `THEGRAPH_API_KEY=your-api-key-here`, replacing with your actual key from The Graph. Alternatively, set the key in the MCP client configuration's `env` field.

What parameters does the `get_new_pools` tool accept?

`chain` (required, e.g. "ethereum"), `order_by` (optional, defaults to "timestamp"), `time_range_seconds` (lookback period, default 300), and `limit` (max pools, default 100). Sorting options: timestamp, txcount, volume, tvl.

How do I integrate with Claude Desktop?

Run `uv run mcp install main.py --name "UniswapPoolSpy"` to install as an MCP plugin, or configure the server in the `mcpServers` file with the command `uv` and arguments pointing to the project directory.

Which chains are supported?

Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo, and Blast.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

kukapay

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K