uniswap-poolspy-mcp
Servidor MCP de Uniswap PoolSpy
Un servidor MCP que rastrea los grupos de liquidez recién creados en Uniswap en nueve redes blockchain (Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo y Blast) y proporciona datos en tiempo real para analistas, comerciantes y desarrolladores de DeFi.
Características
Supervisa la creación de pools de Uniswap V3 en 9 redes blockchain.
Rango de tiempo personalizable y límites de resultados para consultar nuevos grupos.
Admite clasificación por marca de tiempo, recuento de transacciones, volumen o TVL.
Related MCP server: uniswap-trader-mcp
Prerrequisitos
Python 3.10 o superior
UV para la gestión de paquetes
Una clave API de The Graph válida
Entorno compatible con MCP (por ejemplo, Claude Desktop) para una funcionalidad completa
Instalación
Clonar el repositorio :
git clone https://github.com/yourusername/uniswap-poolspy-mcp.git cd uniswap-poolspy-mcpConfigurar el entorno : Instale
uvsi aún no lo ha hecho:curl -LsSf https://astral.sh/uv/install.sh | shInstalar dependencias : use
uvpara sincronizar las dependencias desdepyproject.toml:uv syncConfigurar la clave API : Cree un archivo
.enven la raíz del proyecto:echo "THEGRAPH_API_KEY=your-api-key-here" > .envReemplace
your-api-key-herecon su clave API de The Graph real.
Uso
Ejecución del servidor
Inicie el servidor MCP:
uv run main.pyPara el desarrollo con MCP Inspector:
uv run mcp dev main.pyIntegración con Claude Desktop
Instalar el servidor como un complemento MCP:
uv run mcp install main.py --name "UniswapPoolSpy"Configuración
Para que los clientes MCP puedan descubrir el servidor (por ejemplo, Claude Desktop), configúrelo en un archivo mcpServers :
{
"mcpServers": {
"Uniswap-PoolSpy": {
"command": "uv",
"args": ["--directory", "path/to/uniswap-poolspy-mcp", "run", "main.py"],
"env": {
"THEGRAPH_API_KEY": "your api key from The Graph"
}
}
}
}Consulta de nuevos pools
Utilice la herramienta get_new_pools en Claude Desktop con consultas en lenguaje natural como:
"Muéstrame los nuevos pools de Ethereum de los últimos 10 minutos"
Lista de grupos en la Base ordenados por volumen, límite de 50.
"¿Qué grupos se crearon en Polygon durante la última hora, ordenados por TVL?"
La herramienta acepta estos parámetros:
chain: red blockchain (p. ej., "ethereum", "base", "optimism")order_by: Campo de ordenamiento ("marca de tiempo", "recuento de transacciones", "volumen", "tvl")time_range_seconds: Período de retrospección en segundos (predeterminado: 300)limit: Número máximo de grupos a devolver (predeterminado: 100)
Ejemplo de salida
Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75
Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00Cadenas soportadas
Ethereum
Base
Optimismo
Arbitrum
Polígono
Cadena inteligente BNB (BSC)
Avalancha
Celo
Explosión
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Available Tools
1 toolget_new_poolsB
Returns a list of trading pools created in the specified time range on Uniswap V3.
Parameters: chain (str): The blockchain on which Uniswap is deployed. Default is 'ethereum'. Supported options include: 'ethereum', 'base', 'optimism', 'arbitrum', 'polygon', 'bsc', 'avalanche', 'celo' and 'blast'. order_by (str): The field to sort data in descending order before returning to the user. Default is 'timestamp'. Supported options include: - timestamp: Sort by Timestamp - txcount: Sort by Transaction Count - tvl: Sort by Total Value Locked - volume: Sort by Volume time_range_seconds (int): The time range in seconds to look back for new pools. Default is 300 seconds (5 minutes). limit (int): The maximum number of pools to return. Default is 100 pools.
Inputs: chain, limit, order_by, time_range_seconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'get_new_pools' has a single, clearly defined purpose: retrieving newly created Uniswap V3 pools within a specified time range.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'get_new_pools' follows a clear verb_noun pattern (get + new_pools), which would be consistent if more tools were added.
A single tool is too few for a server named 'uniswap-poolspy-mcp', which suggests broader monitoring or analysis of Uniswap pools. This minimal toolset limits functionality to only retrieving new pools, lacking operations like querying existing pools, analyzing pool metrics, or tracking pool changes over time.
The tool surface is severely incomplete for the implied domain of Uniswap pool monitoring. While 'get_new_pools' covers discovery of new pools, there are significant gaps: no tools for getting pool details, tracking liquidity or volume trends, analyzing historical data, or performing CRUD-like operations on pool information, which agents would need for comprehensive analysis.
Related MCP Connectors
Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that tracks newly created liquidity pools on Pancake Swap.110MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.40MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that delivers real-time token prices from Uniswap V3 across multiple chains.3MIT
- AlicenseAqualityDmaintenanceAn MCP server that tracks and analyzes DEX liquidity pools to power intelligent DeFi agents and automated strategies.12MIT