PancakeSwap PoolSpy

What is PancakeSwap PoolSpy about?

PancakeSwap PoolSpy monitors the Binance Smart Chain for newly created PancakeSwap liquidity pools and returns detailed information such as pool address, token pair, creation timestamp, block number, transaction count, volume (USD) and total value locked (USD).

How to use PancakeSwap PoolSpy?

1. Install the server (recommended via Smithery):

   npx -y @smithery/cli install @kukapay/pancakeswap-poolspy-mcp --client claude
   

2. Configure the environment variable THEGRAPH_API_KEY with a valid The Graph API key.
3. Run the server in development mode:

   mcp dev main.py
   

4. Invoke the tool get_new_pools_bsc(time_range_seconds, limit) through the MCP Inspector or any compatible client.

Key Features

• Real‑time tracking of pools created within a configurable time window (default 5 minutes).
• Adjustable query parameters: time range (seconds) and maximum number of pools returned.
• Comprehensive pool metrics: address, token pair, creation time, block number, transaction count, USD volume, and TVL.
• Simple Python‑based implementation with optional installation via Smithery for Claude Desktop.

Use Cases

• DeFi analysts: quickly identify emerging liquidity opportunities.
• Traders: monitor fresh pools to execute early‑position strategies.
• Developers: feed real‑time pool data into dashboards, bots, or research pipelines.
• Portfolio managers: assess new market depth and potential arbitrage.

FAQ

Q: What blockchain does it monitor? A: Binance Smart Chain (BSC) via the PancakeSwap subgraph.

Q: Do I need a The Graph API key? A: Yes, an API key is required to query the PancakeSwap subgraph.

Q: Can I change the default time range and limit? A: Yes, pass custom values to get_new_pools_bsc(time_range_seconds, limit).

Q: Is there a Node.js version? A: The core server is Python‑based, but installation can be performed through the npm‑based Smithery CLI.

PancakeSwap PoolSpy MCP Server

An MCP server that tracks newly created liquidity pools on Pancake Swap, providing real-time data for DeFi analysts, traders, and developers.

Features

• Real-Time Pool Tracking: Fetches pools created within a specified time range (default: 5 minutes).
• Customizable Queries: Adjust the time range (in seconds) and the number of pools returned (default: 100).
• Detailed Metrics: Includes pool address, tokens, creation timestamp, block number, transaction count, volume (USD), and total value locked (USD).

Prerequisites

• Python 3.10+: Ensure Python is installed on your system.
• The Graph API Key: Obtain an API key from The Graph to access the PancakeSwap subgraph.

Installation

Installing via Smithery

To install PancakeSwap PoolSpy for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/pancakeswap-poolspy-mcp --client claude

1. Clone the Repository:

   git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git
   cd pancakeswap-poolspy-mcp
   

2. Install Dependencies: Install the required Python packages using uv:

   uv add mcp[cli] httpx dotenv
   

3. Client Configuration

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

Usage

Running the Server

Run the server in development mode to test it locally:

mcp dev main.py

This launches the MCP Inspector, where you can interact with the get_new_pools_bsc tool.

Available Tool

get_new_pools_bsc(time_range_seconds: int = 300, limit: int = 100)

Fetches a list of newly created PancakeSwap pools on BNB Smart Chain.

• Parameters:

  • time_range_seconds (int): Time range in seconds to look back for new pools. Default is 300 seconds (5 minutes).
  • limit (int): Maximum number of pools to return. Default is 100 pools.

• Returns: A formatted string listing pool details or an error message if the query fails.

• Example Outputs:

  • Default (last 5 minutes, up to 100 pools):

    get_new_pools_bsc()
    

    Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
    Pool Address: 0x1234...5678
    Tokens: WETH/USDC
    Created At: 2025-03-16 12:00:00 UTC
    Block Number: 12345678
    Transaction Count: 10
    Volume (USD): 1234.56
    Total Value Locked (USD): 5678.90
    
    Pool Address: 0x9abc...def0
    Tokens: CAKE/BNB
    Created At: 2025-03-16 12:01:00 UTC
    Block Number: 12345679
    Transaction Count: 5
    Volume (USD): 789.12
    Total Value Locked (USD): 3456.78
    

  • Custom (last 10 minutes, up to 50 pools):

    get_new_pools(600, 50)
    

    Newly Created Trading Pools (Last 10 Minutes, Limit: 50):
    [pool details...]
    

Example Prompts:

• "list newly created PancakeSwap pools from the last 1 hours."
• "Display PancakeSwap pools created within the last 2 minutes."

License

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