PancakeSwap PoolSpy MCP Server

1# PancakeSwap PoolSpy MCP Server
2 
3An MCP server that tracks newly created liquidity pools on Pancake Swap, providing real-time data for DeFi analysts, traders, and developers.
4 
5[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
6[![Python](https://img.shields.io/badge/Python-3.10+-yellow.svg)](https://www.python.org/)
7[![smithery badge](https://smithery.ai/badge/@kukapay/pancakeswap-poolspy-mcp)](https://smithery.ai/server/@kukapay/pancakeswap-poolspy-mcp)
8 
9## Features
10 
11- **Real-Time Pool Tracking**: Fetches pools created within a specified time range (default: 5 minutes).
12- **Customizable Queries**: Adjust the time range (in seconds) and the number of pools returned (default: 100).
13- **Detailed Metrics**: Includes pool address, tokens, creation timestamp, block number, transaction count, volume (USD), and total value locked (USD).
14 
15## Prerequisites
16 
17- **Python 3.10+**: Ensure Python is installed on your system.
18- **The Graph API Key**: Obtain an API key from [The Graph](https://thegraph.com/) to access the PancakeSwap subgraph.
19 
20## Installation
21 
22### Installing via Smithery
23 
24To install PancakeSwap PoolSpy for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/pancakeswap-poolspy-mcp):
25 
26```bash
27npx -y @smithery/cli install @kukapay/pancakeswap-poolspy-mcp --client claude
28```
29 
301. **Clone the Repository**:
31   ```bash
32   git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git
33   cd pancakeswap-poolspy-mcp
34   ```
35 
362. **Install Dependencies**:
37   Install the required Python packages using uv:
38   ```bash
39   uv add mcp[cli] httpx dotenv
40   ```
41 
423. **Client Configuration**
43    ```json
44    {
45      "mcpServers": {
46        "PancakeSwap-PoolSpy": {
47          "command": "uv",
48          "args": ["--directory", "path/to/pancakeswap-poolspy-mcp", "run", "main.py"],
49          "env": {
50            "THEGRAPH_API_KEY": "your api key from The Graph"
51          }
52        }
53      }
54    }
55    ```
56 
57## Usage
58 
59### Running the Server
60 
61Run the server in development mode to test it locally:
62```bash
63mcp dev main.py
64```
65This launches the MCP Inspector, where you can interact with the `get_new_pools_bsc` tool.
66 
67### Available Tool
68 
69#### `get_new_pools_bsc(time_range_seconds: int = 300, limit: int = 100)`
70 
71Fetches a list of newly created PancakeSwap pools on BNB Smart Chain.
72 
73- **Parameters**:
74  - `time_range_seconds` (int): Time range in seconds to look back for new pools. Default is 300 seconds (5 minutes).
75  - `limit` (int): Maximum number of pools to return. Default is 100 pools.
76 
77- **Returns**: A formatted string listing pool details or an error message if the query fails.
78 
79- **Example Outputs**:
80  - Default (last 5 minutes, up to 100 pools):
81    ```bash
82    get_new_pools_bsc()
83    ```
84    ```
85    Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
86    Pool Address: 0x1234...5678
87    Tokens: WETH/USDC
88    Created At: 2025-03-16 12:00:00 UTC
89    Block Number: 12345678
90    Transaction Count: 10
91    Volume (USD): 1234.56
92    Total Value Locked (USD): 5678.90
93 
94    Pool Address: 0x9abc...def0
95    Tokens: CAKE/BNB
96    Created At: 2025-03-16 12:01:00 UTC
97    Block Number: 12345679
98    Transaction Count: 5
99    Volume (USD): 789.12
100    Total Value Locked (USD): 3456.78
101    ```
102 
103  - Custom (last 10 minutes, up to 50 pools):
104    ```bash
105    get_new_pools(600, 50)
106    ```
107    ```
108    Newly Created Trading Pools (Last 10 Minutes, Limit: 50):
109    [pool details...]
110    ```
111 
112### **Example Prompts**:
113 
114   - "list newly created PancakeSwap pools from the last 1 hours."
115   - "Display PancakeSwap pools created within the last 2 minutes."
116 
117## License
118 
119This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
120