compare-pools
v0.1.0Compare all Uniswap pools for a token pair across fee tiers and versions. Use when the user asks which pool is best, wants to compare V3 vs V4, or wants to find the optimal fee tier.
Installation
Compare Pools
Overview
Compares all available Uniswap pools for a token pair across fee tiers (1bp, 5bp, 30bp, 100bp) and protocol versions (V2, V3, V4). Delegates to pool-researcher in comparison mode to rank pools by APY, liquidity depth, and utilization.
When to Use
Activate when the user asks:
- "Compare ETH/USDC pools"
- "Which pool is best for ETH/USDC?"
- "V3 vs V4 for this pair"
- "Best fee tier for WETH/USDC"
- "Which fee tier has the best APY?"
- "Compare liquidity across fee tiers"
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| token0 | Yes | — | First token name, symbol, or address |
| token1 | Yes | — | Second token name, symbol, or address |
| chain | No | All chains | Chain name or "all" for cross-chain comparison |
| compareBy | No | all | Focus: "tvl", "volume", "apy", or "all" |
Workflow
-
Extract parameters from the user's request.
-
Delegate to pool-researcher: Invoke
Task(subagent_type:pool-researcher)asking for a comparison of all pools for the token pair. The agent will discover pools across fee tiers and versions, gather data for each, and rank them. -
Present comparison: Format as a comparison table with a clear recommendation.
Output Format
Pool Comparison: WETH/USDC (Ethereum)
| Pool | Fee | TVL | Vol 24h | APY 7d | Depth 1% | Recommended |
| ---------- | ------ | ------- | -------- | ------ | -------- | ----------- |
| V3 0.05% | 5bp | $332M | $610M | 21.3% | $5M | Best APY |
| V3 0.30% | 30bp | $85M | $45M | 8.2% | $2M | |
| V3 1.00% | 100bp | $12M | $3M | 4.1% | $500K | |
| V2 0.30% | 30bp | $25M | $8M | 3.5% | $1M | |
Recommendation: V3 0.05% pool — highest APY with deepest liquidity.
Important Notes
- Delegates to
pool-researcher— no direct MCP tool calls. - Pools with zero liquidity or no activity are excluded from comparison.
- Ranking considers multiple factors: APY, depth, stability, and utilization.
Error Handling
| Error | User-Facing Message | Suggested Action |
|---|---|---|
| No pools found | "No active pools found for X/Y." | Check token names or try another chain |
| Single pool only | "Only one pool exists for X/Y." | Shows single pool analysis instead |