pancakeswap-poolspy-mcp

What is PancakeSwap PoolSpy MCP Server?

PancakeSwap PoolSpy MCP Server is an MCP (Multi-Chain Protocol) server designed to track newly created liquidity pools on PancakeSwap. It provides real-time data, making it a valuable tool for DeFi analysts, traders, and developers who need to monitor new pool creations on the BNB Smart Chain.

How to use PancakeSwap PoolSpy MCP Server?

To use PancakeSwap PoolSpy MCP Server, you first need to install it. Installation can be done via Smithery for automatic setup with Claude Desktop or by manually cloning the repository and installing dependencies using uv. A The Graph API Key is required to access the PancakeSwap subgraph. Once installed, you can run the server in development mode using mcp dev main.py and interact with the get_new_pools_bsc tool through the MCP Inspector. You can specify time_range_seconds and limit parameters to customize your queries.

Key Features of PancakeSwap PoolSpy MCP Server

• 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).

Use Cases of PancakeSwap PoolSpy MCP Server

• DeFi Analysis: Analysts can use the real-time data to identify new trends and opportunities in the PancakeSwap ecosystem.
• Trading Strategies: Traders can leverage the information on newly created pools to inform their trading decisions.
• Developer Tools: Developers can integrate this server into their applications to monitor PancakeSwap liquidity.

FAQ about PancakeSwap PoolSpy MCP Server

Q: What is the default time range for tracking new pools? A: The default time range is 300 seconds (5 minutes).

Q: What is the maximum number of pools returned by default? A: The default limit is 100 pools.

Q: Do I need an API key to use this project? A: Yes, you need an API key from The Graph to access the PancakeSwap subgraph.

Q: Can I customize the time range and limit for queries? A: Yes, you can specify time_range_seconds and limit parameters when calling the get_new_pools_bsc tool.

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.