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 Prompts:

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