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
-
Clone the Repository:
git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git cd pancakeswap-poolspy-mcp
-
Install Dependencies: Install the required Python packages using uv:
uv add mcp[cli] httpx dotenv
-
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.
Metadata
Release files for iflow-mcp_kukapay-pancakeswap-poolspy-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1.tar.gz | 5.1 kB | Without provenance | Details for iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1-py3-none-any.whl |
Total release size: 11.2 kB
Release files / iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1.tar.gz
| Download URL | iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1.tar.gz |
|---|---|
| Size | 5.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a6373200af25fcd1cc9cb5bed8893b1ccbdd4fe3e964a0ce529b100ae9e422b
|
|
BLAKE2b-256 checksum How to use checksums |
63f612e6dffd42b467d785406b13d2abc429fe8528273f48d28570c57c554bb7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1-py3-none-any.whl
| Download URL | iflow_mcp_kukapay_pancakeswap_poolspy_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f8774ddd4a76739d7efde1a37efe835d43b21e012765e1eacbfde54bdc3e204f
|
|
BLAKE2b-256 checksum How to use checksums |
593c987a0780acdd5d685554cfed26c074436c0d38fe447d6fcbf7e8f77c3b29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_kukapay-pancakeswap-poolspy-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.