PancakeSwap PoolSpy

What is PancakeSwap PoolSpy about?

PancakeSwap PoolSpy provides real‑time visibility into newly created liquidity pools on PancakeSwap (BSC). It queries the PancakeSwap subgraph via The Graph API and returns detailed pool metrics, enabling DeFi analysts, traders, and developers to monitor emerging market opportunities instantly.

How to use PancakeSwap PoolSpy?

1. Install dependencies – clone the repository and add required Python packages with uv add mcp[cli] httpx dotenv.
2. Configure API key – set THEGRAPH_API_KEY in the server environment.
3. Run the server – start in development mode with mcp dev main.py or launch via the MCP client configuration.
4. Invoke the tool – call get_new_pools_bsc(time_range_seconds?, limit?) to retrieve pools. Parameters are optional; defaults are the last 5 minutes and up to 100 pools.

Key features of PancakeSwap PoolSpy

• Real‑Time Pool Tracking – fetch pools created within a configurable time window (default 5 minutes).
• Customizable Queries – adjust time range (seconds) and result limit.
• Comprehensive Metrics – pool address, token pair, creation time, block number, transaction count, USD volume, and TVL.
• CLI & MCP Integration – usable via the MCP Inspector or programmatically through the provided tool.

Use cases of PancakeSwap PoolSpy

• DeFi market monitoring – spot new pools to assess liquidity shifts.
• Arbitrage scouting – identify nascent pools for early arbitrage opportunities.
• Portfolio analytics – enrich trading dashboards with fresh pool data.
• Research & reporting – gather statistics on pool creation trends over time.

FAQ from PancakeSwap PoolSpy

• Do I need a Graph API key? Yes, a valid THEGRAPH_API_KEY is required to query the PancakeSwap subgraph.
• Which blockchain is supported? The tool targets BNB Smart Chain (BSC) pools on PancakeSwap.
• Can I change the default time range? Absolutely – pass a custom time_range_seconds value to the tool.
• What is the maximum number of pools returned? The limit parameter caps results; default is 100 but you can set any integer within reasonable API limits.
• How do I run the server in production? Use the MCP client configuration to start the server with the appropriate command and environment variables.

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.