Pancakeswap Poolspy MCP

🚀 PancakeSwap Pool Tracker MCP Server

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

🚀 Quick Start

The PancakeSwap Pool Tracker MCP Server is designed to track newly created liquidity pools on Pancake Swap, offering real - time data for DeFi - related professionals.

✨ Features

• Real - time Pool Tracking: Fetch newly created liquidity pools within a specified time frame (default is 5 minutes).
• Customizable Queries: Adjust the time frame (in seconds, default is 300 seconds) and the number of pools to return (default is 100).
• Detailed Metrics: Include pool address, tokens, creation timestamp, block number, transaction count, trading volume (USD), and total value locked (USD).

📦 Installation

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 sub - graph.

Steps

1. Clone the Repository:

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

2. Install Dependencies: Use uv to install the required Python packages:

   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 The Graph API Key"
         }
       }
     }
   }
   

💻 Usage Examples

Running the Server

Run the server in development mode for testing:

mcp dev main.py

This will start the MCP checker, where you can interact with the get_new_pools_bsc tool.

Available Tools

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

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

• Parameters:

  • time_range_seconds (in seconds, default is 300): Specify the time frame.
  • limit (default is 100): Maximum number of pools to return.

• Example Output:

  {
    "pool_address": "0x...",
    "tokens": ["Token1", "Token2"],
    "creation_time": "2023-10-01T12:00:00",
    "block_number": 12345,
    "transaction_count": 5,
    "volume_usd": 1000.0,
    "total_value_locked": 500.0
  }
  

Basic Usage

# Get all newly created pools in the past 5 minutes
get_new_pools_bsc()

# Get up to 200 newly created pools in the past 30 minutes
get_new_pools_bsc(time_range_seconds=1800, limit=200)

📄 License

This project is licensed under the MIT License.